Forms On Fire / Appenate MCP by usefulapi is an MCP server published by io.usefulapi, hosted at forms-on-fire.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including formsonfire_list_forms, formsonfire_get_form, formsonfire_search_entries, formsonfire_search_tasks, formsonfire_get_task.
Read mobile forms, entries, users and tasks; create confirmed draft or sent tasks for field workers.
4,222 connections through 5 shared values. Tap any node.
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.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the forms (screens) in the organization with id, name, version and status. Use a form id with formsonfire_get_form or formsonfire_search_entries. GET /screen/form/search.
| Parameter | Type | Description |
|---|---|---|
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| page_size | integer | Results per page, 1-250 (default 50). |
{
"name": "formsonfire_list_forms",
"title": "List forms",
"description": "List the forms (screens) in the organization with id, name, version and status. Use a form id with formsonfire_get_form or formsonfire_search_entries. GET /screen/form/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"page_size": {
"type": "integer",
"maximum": 250,
"description": "Results per page, 1-250 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List forms",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One form's definition: name, version, status and its fields (names and types, which are the names to use for prefilled answers). Give the form's id (GUID) or its external id. GET /screen/form.
| Parameter | Type | Description |
|---|---|---|
| id | string | Form id (GUID). |
| status | string | Form status (default: Published). |
| version | integer | Form version (default: the latest published). |
| external_id | string | Form external id. |
{
"name": "formsonfire_get_form",
"title": "Get form definition",
"description": "One form's definition: name, version, status and its fields (names and types, which are the names to use for prefilled answers). Give the form's id (GUID) or its external id. GET /screen/form.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Form id (GUID)."
},
"status": {
"enum": [
"Published",
"Draft",
"Archived"
],
"type": "string",
"description": "Form status (default: Published)."
},
"version": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Form version (default: the latest published)."
},
"external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Form external id."
}
}
},
"annotations": {
"title": "Get form definition",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Search submitted form entries (the completed forms your team sent in): who filled them, when, where (GPS) and every answer. Filter by form id or external id, version and a date range (by received time, or complete time via order_by). Returns the page of Entries with TotalRows. GET /formentry/search.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Comma-separated field names to return (works with answer_format Flat). |
| form_id | string | Only entries of this form (id, GUID). |
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| to_date | string | ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z). |
| order_by | string | Sort and date-filter by ReceivedTime (default) or CompleteTime (when the form was completed on the device). |
| from_date | string | ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z). |
| page_size | integer | Results per page, 1-250 (default 50). |
| date_order | string | Sort direction (default Ascending, oldest first). |
| form_version | integer | Form version; 0 or omitted = the latest published version, -1 = all versions. |
Search tasks (jobs assigned to field workers, each with one or more activities such as filling out a form): status, assignee, due time, activities and history. Filter by assignee, status, name, task template and date range. Returns the page of Tasks with TotalRows. GET /task/search.
| Parameter | Type | Description |
|---|---|---|
| name | string | Task name. |
| status | string | Only tasks in this status. |
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| to_date | string | ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z). |
| from_date | string | ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z). |
| page_size | integer | Results per page, 1-250 (default 50). |
| user_email | string | Only tasks of the user with this email. |
| template_id | string | Only tasks created from this task template id. |
| answer_format | string | How form answers are shaped: Flat (one value per field, easiest to read), Rich (typed values) or Raw (as stored). Default: the vendor's default. |
One task by its id (GUID), with activities and history. GET /task.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Task id (GUID). |
| answer_format | string | How form answers are shaped: Flat (one value per field, easiest to read), Rich (typed values) or Raw (as stored). Default: the vendor's default. |
| retrieve_entries | boolean | Also return the form entries completed by the task's activities. |
{
"name": "formsonfire_get_task",
"title": "Get task",
"description": "One task by its id (GUID), with activities and history. GET /task.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Task id (GUID)."
},
"answer_format": {
"enum": [
"Flat",
"Rich",
"Raw"
],
"type": "string",
"description": "How form answers are shaped: Flat (one value per field, easiest to read), Rich (typed values) or Raw (as stored). Default: the vendor's default."
},
"retrieve_entries": {
"type": "boolean",
"description": "Also return the form entries completed by the task's activities."
}
}
},
"annotations": {
"title": "Get task",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a task for a field worker with one form to fill out, optionally with prefilled answers. By default it remains a draft; send_immediate=true sends it and notifies the worker. Identify the worker by email, user id or external id (list_users). The form is identified by its external id (formsonfire_get_form shows field names for the prefilled answers). Requires confirm=true and a due time. Not idempotent: calling twice creates two tasks. POST /task.
| Parameter | Type | Description |
|---|---|---|
| icon | string | Task icon name (vendor icon list), e.g. Clock. |
| name | string | Task name shown on the device, e.g. 'Site inspection - Acme'. |
| answers | array | Prefilled answers: field data name and value. |
| confirm * | boolean | Set true only after the user approved creating the task and any requested notification. |
| user_id | string | Id (GUID) of the worker the task is assigned to. |
| start_by | string | When the task should be started (ISO 8601 UTC). |
| user_email | string | Email of the worker (user) the task is assigned to. |
| complete_by * | string | Due time (ISO 8601 UTC). |
List the organization's users (field workers and admins): name, email, status, groups, website role and last activity. Passwords and keys are never returned. GET /user/search.
| Parameter | Type | Description |
|---|---|---|
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| page_size | integer | Results per page, 1-250 (default 50). |
{
"name": "formsonfire_list_users",
"title": "List users",
"description": "List the organization's users (field workers and admins): name, email, status, groups, website role and last activity. Passwords and keys are never returned. GET /user/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"page_size": {
"type": "integer",
"maximum": 250,
"description": "Results per page, 1-250 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One user by id (GUID): name, status, groups, folders, role and registered devices. GET /user.
| Parameter | Type | Description |
|---|---|---|
| id * | string | User id (GUID). |
{
"name": "formsonfire_get_user",
"title": "Get user",
"description": "One user by id (GUID): name, status, groups, folders, role and registered devices. GET /user.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "User id (GUID)."
}
}
},
"annotations": {
"title": "Get user",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List user groups with their id, name and member user ids. Filter by name or external id. Returns UserGroups with TotalRows. GET /usergroup/search.
| Parameter | Type | Description |
|---|---|---|
| name | string | Group name. |
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| page_size | integer | Results per page, 1-250 (default 50). |
| external_id | string | Group external id. |
{
"name": "formsonfire_list_groups",
"title": "List user groups",
"description": "List user groups with their id, name and member user ids. Filter by name or external id. Returns UserGroups with TotalRows. GET /usergroup/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Group name."
},
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"page_size": {
"type": "integer",
"maximum": 250,
"description": "Results per page, 1-250 (default 50).",
"exclusiveMinimum": 0
},
"external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Group external id."
}
}
},
"annotations": {
"title": "List user groups",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the data sources (lookup tables that feed dropdowns and prefill in forms, such as customers, sites or products): id, external id, name and row count. Use formsonfire_get_data_source for the rows. GET /datasource/search.
| Parameter | Type | Description |
|---|---|---|
| name | string | Data source name. |
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| page_size | integer | Results per page, 1-250 (default 50). |
{
"name": "formsonfire_list_data_sources",
"title": "List data sources",
"description": "List the data sources (lookup tables that feed dropdowns and prefill in forms, such as customers, sites or products): id, external id, name and row count. Use formsonfire_get_data_source for the rows. GET /datasource/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Data source name."
},
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"page_size": {
"type": "integer",
"maximum": 250,
"description": "Results per page, 1-250 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List data sources",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One data source by id (GUID) or external id: its column headers, TotalRows and (with return_rows) a page of rows. Rows are only returned when return_rows is true; page through them with page_no. GET /datasource.
| Parameter | Type | Description |
|---|---|---|
| id | string | Data source id (GUID). |
| page_no | integer | Page number, starting at 0 (default 0). Pass the previous reply's next_page_no. |
| page_size | integer | Rows per page, 1-1250 (default 50). |
| external_id | string | Data source external id. |
| return_rows | boolean | Also return the rows (default false: headers and total only). |
{
"name": "formsonfire_get_data_source",
"title": "Get data source",
"description": "One data source by id (GUID) or external id: its column headers, TotalRows and (with return_rows) a page of rows. Rows are only returned when return_rows is true; page through them with page_no. GET /datasource.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Data source id (GUID)."
},
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"page_size": {
"type": "integer",
"maximum": 1250,
"description": "Rows per page, 1-1250 (default 50).",
"exclusiveMinimum": 0
},
"external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Data source external id."
},
"return_rows": {
"type": "boolean",
"description": "Also return the rows (default false: headers and total only)."
}
}
},
"annotations": {
"title": "Get data source",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Tools for Forms On Fire, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many inspection forms were submitted this week, and by whom?"; "Show the answers of the latest 'Site Safety Check' entries."; "Which tasks assigned to Maria are still open?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Forms On Fire data. Free plan: 50 tool calls per month. Run formsonfire_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 formsonfire_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 formsonfire_upgrade without a plan: it returns both plans, each with a payment link for the user to open. formsonfire_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.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| media_as_url | boolean | Return photos/signatures as URLs instead of embedded data. |
| answer_format | string | How form answers are shaped: Flat (one value per field, easiest to read), Rich (typed values) or Raw (as stored). Default: the vendor's default. |
| form_external_id | string | Only entries of the form with this external id. |
{
"name": "formsonfire_search_entries",
"title": "Search form entries",
"description": "Search submitted form entries (the completed forms your team sent in): who filled them, when, where (GPS) and every answer. Filter by form id or external id, version and a date range (by received time, or complete time via order_by). Returns the page of Entries with TotalRows. GET /formentry/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Comma-separated field names to return (works with answer_format Flat)."
},
"form_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only entries of this form (id, GUID)."
},
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"to_date": {
"type": "string",
"description": "ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z)."
},
"order_by": {
"enum": [
"ReceivedTime",
"CompleteTime"
],
"type": "string",
"description": "Sort and date-filter by ReceivedTime (default) or CompleteTime (when the form was completed on the device)."
},
"from_date": {
"type": "string",
"description": "ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z)."
},
"page_size": {
"type": "integer",
"maximum": 250,
"description": "Results per page, 1-250 (default 50).",
"exclusiveMinimum": 0
},
"date_order": {
"enum": [
"Ascending",
"Descending"
],
"type": "string",
"description": "Sort direction (default Ascending, oldest first)."
},
"form_version": {
"type": "integer",
"maximum": 100000,
"minimum": -1,
"description": "Form version; 0 or omitted = the latest published version, -1 = all versions."
},
"media_as_url": {
"type": "boolean",
"description": "Return photos/signatures as URLs instead of embedded data."
},
"answer_format": {
"enum": [
"Flat",
"Rich",
"Raw"
],
"type": "string",
"description": "How form answers are shaped: Flat (one value per field, easiest to read), Rich (typed values) or Raw (as stored). Default: the vendor's default."
},
"form_external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only entries of the form with this external id."
}
}
},
"annotations": {
"title": "Search form entries",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| retrieve_entries | boolean | Also return the form entries completed by the task's activities. |
| user_external_id | string | Only tasks of the user with this external id. |
{
"name": "formsonfire_search_tasks",
"title": "Search tasks",
"description": "Search tasks (jobs assigned to field workers, each with one or more activities such as filling out a form): status, assignee, due time, activities and history. Filter by assignee, status, name, task template and date range. Returns the page of Tasks with TotalRows. GET /task/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Task name."
},
"status": {
"enum": [
"Draft",
"InProgress",
"Completed",
"Accepted",
"Rejected"
],
"type": "string",
"description": "Only tasks in this status."
},
"page_no": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Page number, starting at 0 (default 0). Pass the previous reply's next_page_no."
},
"to_date": {
"type": "string",
"description": "ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z)."
},
"from_date": {
"type": "string",
"description": "ISO 8601 UTC date (2026-10-01) or date-time (2026-10-01T08:00:00Z)."
},
"page_size": {
"type": "integer",
"maximum": 250,
"description": "Results per page, 1-250 (default 50).",
"exclusiveMinimum": 0
},
"user_email": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only tasks of the user with this email."
},
"template_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only tasks created from this task template id."
},
"answer_format": {
"enum": [
"Flat",
"Rich",
"Raw"
],
"type": "string",
"description": "How form answers are shaped: Flat (one value per field, easiest to read), Rich (typed values) or Raw (as stored). Default: the vendor's default."
},
"retrieve_entries": {
"type": "boolean",
"description": "Also return the form entries completed by the task's activities."
},
"user_external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only tasks of the user with this external id."
}
}
},
"annotations": {
"title": "Search tasks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| instruction |
| string |
| Instruction shown for this form activity. |
| send_immediate | boolean | Notify the worker right away (vendor default applies when omitted). |
| additional_info | string | Free-text instructions shown with the task. |
| form_external_id * | string | External id of the form the worker has to fill out. |
| user_external_id | string | External id of the worker the task is assigned to. |
{
"name": "formsonfire_create_task",
"title": "Create task",
"description": "WRITE: create a task for a field worker with one form to fill out, optionally with prefilled answers. By default it remains a draft; send_immediate=true sends it and notifies the worker. Identify the worker by email, user id or external id (list_users). The form is identified by its external id (formsonfire_get_form shows field names for the prefilled answers). Requires confirm=true and a due time. Not idempotent: calling twice creates two tasks. POST /task.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"complete_by",
"confirm",
"form_external_id"
],
"properties": {
"icon": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Task icon name (vendor icon list), e.g. Clock."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Task name shown on the device, e.g. 'Site inspection - Acme'."
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The field's data name in the form."
},
"value": {
"type": "string",
"maxLength": 4000,
"description": "The prefilled value."
}
}
},
"maxItems": 200,
"description": "Prefilled answers: field data name and value."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user approved creating the task and any requested notification."
},
"user_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Id (GUID) of the worker the task is assigned to."
},
"start_by": {
"type": "string",
"description": "When the task should be started (ISO 8601 UTC)."
},
"user_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 200,
"description": "Email of the worker (user) the task is assigned to."
},
"complete_by": {
"type": "string",
"description": "Due time (ISO 8601 UTC)."
},
"instruction": {
"type": "string",
"maxLength": 1000,
"description": "Instruction shown for this form activity."
},
"send_immediate": {
"type": "boolean",
"description": "Notify the worker right away (vendor default applies when omitted)."
},
"additional_info": {
"type": "string",
"maxLength": 2000,
"description": "Free-text instructions shown with the task."
},
"form_external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "External id of the form the worker has to fill out."
},
"user_external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "External id of the worker the task is assigned to."
}
}
},
"annotations": {
"title": "Create task",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}