Device Magic MCP by usefulapi is an MCP server published by io.usefulapi, hosted at device-magic.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 17 tools, including devicemagic_list_forms, devicemagic_get_form, devicemagic_list_submissions, devicemagic_list_devices, devicemagic_get_device.
Read Device Magic forms, submissions, devices and groups; send and revoke dispatches.
4,035 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the organization's forms: id, namespace (the form's unique id used for dispatching), version, description and group. GET /organizations/{org}/forms.json.
No parameters.
{
"name": "devicemagic_list_forms",
"title": "List forms",
"description": "List the organization's forms: id, namespace (the form's unique id used for dispatching), version, description and group. GET /organizations/{org}/forms.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List forms",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
One form's definition: title and its questions/pages with identifiers and types (the identifiers are the keys inside submissions and dispatch payloads). Optionally a specific version. GET /organizations/{org}/forms/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | Form id (field `id` of list_forms). |
| version | string | Form version such as 1.03; default = the latest. |
{
"name": "devicemagic_get_form",
"title": "Get form definition",
"description": "One form's definition: title and its questions/pages with identifiers and types (the identifiers are the keys inside submissions and dispatch payloads). Optionally a specific version. GET /organizations/{org}/forms/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Form id (field `id` of list_forms).",
"exclusiveMinimum": 0
},
"version": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Form version such as 1.03; default = the latest."
}
}
},
"annotations": {
"title": "Get form definition",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Submitted data of one form, newest data as stored in the form's Device Magic Database destination (it must be active on that form). Each record has form info, metadata (device, user, submitted_at, received_at, submission_id) and the answers. The reply says current_page, total_pages and total_count. Filter by from_date/to_date (yyyy-mm-dd). GET /api/forms/{id}/device_magic_database.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based (use total_pages from the reply). |
| form_id * | integer | Form id (field `id` of list_forms). |
| to_date | string | Only submissions up to this date (yyyy-mm-dd). |
| per_page | integer | Submissions per page, 1-100 (default 25). |
| from_date | string | Only submissions from this date (yyyy-mm-dd). |
{
"name": "devicemagic_list_submissions",
"title": "List form submissions",
"description": "Submitted data of one form, newest data as stored in the form's Device Magic Database destination (it must be active on that form). Each record has form info, metadata (device, user, submitted_at, received_at, submission_id) and the answers. The reply says current_page, total_pages and total_count. Filter by from_date/to_date (yyyy-mm-dd). GET /api/forms/{id}/device_magic_database.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, 1-based (use total_pages from the reply)."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Form id (field `id` of list_forms).",
"exclusiveMinimum": 0
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only submissions up to this date (yyyy-mm-dd)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Submissions per page, 1-100 (default 25)."
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only submissions from this date (yyyy-mm-dd)."
}
}
},
"annotations": {
"title": "List form submissions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the organization's devices (phones, tablets, web-form users): id, identifier, owner, description, group and whether approval is pending. GET /organizations/{org}/devices.json.
No parameters.
{
"name": "devicemagic_list_devices",
"title": "List devices",
"description": "List the organization's devices (phones, tablets, web-form users): id, identifier, owner, description, group and whether approval is pending. GET /organizations/{org}/devices.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List devices",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One device: id, identifier, owner, description, pending_approval, groups and custom attributes. GET /organizations/{org}/devices/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| device_id * | integer | Numeric device id (field `id` of list_devices). |
{
"name": "devicemagic_get_device",
"title": "Get device",
"description": "One device: id, identifier, owner, description, pending_approval, groups and custom attributes. GET /organizations/{org}/devices/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"device_id"
],
"properties": {
"device_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric device id (field `id` of list_devices).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get device",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the organization's groups (which devices see which forms), optionally narrowed by a name filter or by tags. GET /api/v2/organizations/{org}/groups.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based (default 1). |
| tags | array | Only groups having any of these tags (the vendor matches any tag). |
| filter | string | Group name to look for, e.g. Default (the vendor matches part of the name). |
{
"name": "devicemagic_list_groups",
"title": "List groups",
"description": "List the organization's groups (which devices see which forms), optionally narrowed by a name filter or by tags. GET /api/v2/organizations/{org}/groups.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, 1-based (default 1)."
},
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Only groups having any of these tags (the vendor matches any tag)."
},
"filter": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Group name to look for, e.g. Default (the vendor matches part of the name)."
}
}
},
"annotations": {
"title": "List groups",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the organization's resources (lookup tables and files used by forms): id, original filename, version, description. GET /api/resources.json.
No parameters.
{
"name": "devicemagic_list_resources",
"title": "List resources",
"description": "List the organization's resources (lookup tables and files used by forms): id, original filename, version, description. GET /api/resources.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List resources",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Metadata of one resource: status, version and, for spreadsheets, its tables and columns. The file content itself is not downloaded. GET /api/resources/{id}/describe.json.
| Parameter | Type | Description |
|---|---|---|
| resource_id * | integer | Resource id (field `id` of list_resources). |
{
"name": "devicemagic_describe_resource",
"title": "Describe resource",
"description": "Metadata of one resource: status, version and, for spreadsheets, its tables and columns. The file content itself is not downloaded. GET /api/resources/{id}/describe.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"resource_id"
],
"properties": {
"resource_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Resource id (field `id` of list_resources).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Describe resource",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List where one form's submissions are sent (e-mail, Dropbox, database, ...): id, active flag, format and transport types, timestamps. GET /api/forms/{id}/destinations.json.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | Form id (field `id` of list_forms). |
{
"name": "devicemagic_list_destinations",
"title": "List form destinations",
"description": "List where one form's submissions are sent (e-mail, Dropbox, database, ...): id, active flag, format and transport types, timestamps. GET /api/forms/{id}/destinations.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Form id (field `id` of list_forms).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List form destinations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One destination of a form. Credentials and tokens of the destination are never returned. GET /api/forms/{form_id}/destinations/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | Form id. |
| destination_id * | integer | Destination id (field `id` of list_destinations). |
{
"name": "devicemagic_get_destination",
"title": "Get form destination",
"description": "One destination of a form. Credentials and tokens of the destination are never returned. GET /api/forms/{form_id}/destinations/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id",
"destination_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Form id.",
"exclusiveMinimum": 0
},
"destination_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Destination id (field `id` of list_destinations).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get form destination",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Outstanding dispatches (prefilled forms pushed to devices and not yet completed) of the whole organization: id, form name and namespace, device, scheduled time. Dispatch is an Enterprise-plan feature. GET /api/v2/organizations/{org}/dispatches.json.
No parameters.
{
"name": "devicemagic_list_dispatches",
"title": "List outstanding dispatches",
"description": "Outstanding dispatches (prefilled forms pushed to devices and not yet completed) of the whole organization: id, form name and namespace, device, scheduled time. Dispatch is an Enterprise-plan feature. GET /api/v2/organizations/{org}/dispatches.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List outstanding dispatches",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Outstanding dispatches of one device. GET /api/v2/devices/{identifier}/dispatches.json.
| Parameter | Type | Description |
|---|---|---|
| device_identifier * | string | Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890). |
{
"name": "devicemagic_list_device_dispatches",
"title": "List a device's outstanding dispatches",
"description": "Outstanding dispatches of one device. GET /api/v2/devices/{identifier}/dispatches.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"device_identifier"
],
"properties": {
"device_identifier": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890)."
}
}
},
"annotations": {
"title": "List a device's outstanding dispatches",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One dispatch of a device including the values it was prefilled with. GET /api/v3/devices/{identifier}/dispatches/{id}.json?include_inputs=true.
| Parameter | Type | Description |
|---|---|---|
| dispatch_id * | integer | Dispatch id (field `id` of a dispatch list). |
| device_identifier * | string | Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890). |
{
"name": "devicemagic_get_dispatch",
"title": "Get dispatch with prefilled values",
"description": "One dispatch of a device including the values it was prefilled with. GET /api/v3/devices/{identifier}/dispatches/{id}.json?include_inputs=true.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"device_identifier",
"dispatch_id"
],
"properties": {
"dispatch_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Dispatch id (field `id` of a dispatch list).",
"exclusiveMinimum": 0
},
"device_identifier": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890)."
}
}
},
"annotations": {
"title": "Get dispatch with prefilled values",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Devices and web-forms users a dispatch can be sent to (first 100 by default; use items and page for more). GET /api/v3/dispatch_authors.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based. |
| items | integer | Results per page (default 100). |
{
"name": "devicemagic_list_dispatch_recipients",
"title": "List dispatch recipients",
"description": "Devices and web-forms users a dispatch can be sent to (first 100 by default; use items and page for more). GET /api/v3/dispatch_authors.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, 1-based."
},
"items": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Results per page (default 100)."
}
}
},
"annotations": {
"title": "List dispatch recipients",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: pushes a form, optionally prefilled, to one device where its user will see it (like assigning a job). Not idempotent: calling it twice sends two dispatches. Needs the Enterprise plan. The form is named by its namespace (list_forms); `payload` maps question identifiers (get_form) to prefilled values (subforms = nested objects, repeat groups = arrays). POST /api/v2/devices/{identifier}/dispatches.json.
| Parameter | Type | Description |
|---|---|---|
| confirm * | boolean | Must be true: you confirm the form is sent to this device now (its user sees it). |
| payload | object | Prefilled values keyed by question identifier. |
| form_name | string | Title shown to the device user. |
| scheduled_at | string | When the dispatch becomes due, ISO 8601 such as 2026-11-02T09:00:00Z. |
| form_namespace * | string | Form namespace (field `namespace` of list_forms). |
| form_description | string | Description shown to the device user (Device Magic allows at most 255 characters). |
| device_identifier * | string | Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890). |
{
"name": "devicemagic_send_dispatch",
"title": "Send a form to a device (dispatch)",
"description": "WRITE: pushes a form, optionally prefilled, to one device where its user will see it (like assigning a job). Not idempotent: calling it twice sends two dispatches. Needs the Enterprise plan. The form is named by its namespace (list_forms); `payload` maps question identifiers (get_form) to prefilled values (subforms = nested objects, repeat groups = arrays). POST /api/v2/devices/{identifier}/dispatches.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"device_identifier",
"form_namespace",
"confirm"
],
"properties": {
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: you confirm the form is sent to this device now (its user sees it)."
},
"payload": {
"type": "object",
"description": "Prefilled values keyed by question identifier.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"form_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title shown to the device user."
},
"scheduled_at": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "When the dispatch becomes due, ISO 8601 such as 2026-11-02T09:00:00Z."
},
"form_namespace": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Form namespace (field `namespace` of list_forms)."
},
"form_description": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Description shown to the device user (Device Magic allows at most 255 characters)."
},
"device_identifier": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890)."
}
}
},
"annotations": {
"title": "Send a form to a device (dispatch)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: withdraws one outstanding dispatch from a device (the form disappears from the device). It cannot be undone, but the dispatch can be sent again. DELETE /api/v2/devices/{identifier}/dispatches/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| confirm * | boolean | Must be true: you confirm the dispatch is withdrawn from the device. |
| dispatch_id * | integer | Dispatch id (from list_device_dispatches). |
| device_identifier * | string | Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890). |
{
"name": "devicemagic_revoke_dispatch",
"title": "Revoke a dispatch",
"description": "WRITE: withdraws one outstanding dispatch from a device (the form disappears from the device). It cannot be undone, but the dispatch can be sent again. DELETE /api/v2/devices/{identifier}/dispatches/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"device_identifier",
"dispatch_id",
"confirm"
],
"properties": {
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: you confirm the dispatch is withdrawn from the device."
},
"dispatch_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Dispatch id (from list_device_dispatches).",
"exclusiveMinimum": 0
},
"device_identifier": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Device identifier (field `identifier` of a device, e.g. iPhone_abcdef1234567890)."
}
}
},
"annotations": {
"title": "Revoke a dispatch",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: approves a device that is waiting for approval (pending_approval is true) so it can receive forms. Approving an approved device has no effect. POST /organizations/{org}/devices/{id}/approve.
| Parameter | Type | Description |
|---|---|---|
| device_id * | integer | Numeric device id (field `id` of list_devices). |
{
"name": "devicemagic_approve_device",
"title": "Approve a pending device",
"description": "WRITE: approves a device that is waiting for approval (pending_approval is true) so it can receive forms. Approving an approved device has no effect. POST /organizations/{org}/devices/{id}/approve.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"device_id"
],
"properties": {
"device_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric device id (field `id` of list_devices).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Approve a pending device",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Tools for Device Magic, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List my forms and show the submissions of the Site Inspection form from last week."; "Which devices are waiting for approval?"; "Show the outstanding dispatches for the whole team.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Device Magic data. Free plan: 50 tool calls per month. Run devicemagic_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run devicemagic_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run devicemagic_upgrade without a plan: it returns both plans, each with a payment link for the user to open. devicemagic_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.