Paperform MCP by usefulapi is an MCP server published by io.usefulapi, hosted at paperform.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 23 tools, including paperform_list_forms, paperform_get_form, paperform_list_form_fields, paperform_list_submissions, paperform_get_submission.
Read Paperform forms, submissions, products and coupons, Papersign documents, and manage coupons.
4,253 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 forms in the Paperform account (id, slug, custom_slug, title, url, live, tags, submission_count, space_id, dates), newest first. Search by title, or also by slug/custom_slug with search_fields. Start here to find the slug or id the other tools need. Paperform: GET /forms.
| Parameter | Type | Description |
|---|---|---|
| skip | integer | Results to skip (offset). Pass the previous reply's next_skip. |
| sort | string | Sort by created_at: DESC (default, newest first) or ASC. |
| limit | integer | Results per page, 1-100 (Paperform default 20). |
| search | string | Text to match (partial, case-insensitive) — the form title unless search_fields says otherwise. |
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.
| after_id | string | Cursor: only results after this id (e.g. the previous reply's last_id). |
| before_id | string | Cursor: only results before this id. |
| after_date | string | Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set. |
| before_date | string | Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set. |
| search_fields | array | Which fields `search` matches: any of title, slug, custom_slug (default title only). |
{
"name": "paperform_list_forms",
"title": "List forms",
"description": "List the forms in the Paperform account (id, slug, custom_slug, title, url, live, tags, submission_count, space_id, dates), newest first. Search by title, or also by slug/custom_slug with search_fields. Start here to find the slug or id the other tools need. Paperform: GET /forms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"skip": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Results to skip (offset). Pass the previous reply's next_skip."
},
"sort": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by created_at: DESC (default, newest first) or ASC."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (Paperform default 20)."
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Text to match (partial, case-insensitive) — the form title unless search_fields says otherwise."
},
"after_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results after this id (e.g. the previous reply's last_id)."
},
"before_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results before this id."
},
"after_date": {
"type": "string",
"description": "Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set."
},
"before_date": {
"type": "string",
"description": "Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set."
},
"search_fields": {
"type": "array",
"items": {
"enum": [
"title",
"slug",
"custom_slug"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"description": "Which fields `search` matches: any of title, slug, custom_slug (default title only)."
}
}
},
"annotations": {
"title": "List forms",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch one form by slug, custom slug or id: title, description, url, live flag, tags, submission_count, space and dates. Paperform: GET /forms/{slug_or_id}.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
{
"name": "paperform_get_form",
"title": "Get a form",
"description": "Fetch one form by slug, custom slug or id: title, description, url, live flag, tags, submission_count, space and dates. Paperform: GET /forms/{slug_or_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
}
}
},
"annotations": {
"title": "Get a form",
"readOnlyHint": true,
"openWorldHint": true
}
}List a form's questions (key, title, type, required, custom_key, description, options). The field keys are the keys of a submission's `data` object, so read this to interpret answers. Paperform: GET /forms/{slug_or_id}/fields.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| search | string | Only fields whose name matches this text. |
{
"name": "paperform_list_form_fields",
"title": "List form fields",
"description": "List a form's questions (key, title, type, required, custom_key, description, options). The field keys are the keys of a submission's `data` object, so read this to interpret answers. Paperform: GET /forms/{slug_or_id}/fields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only fields whose name matches this text."
}
}
},
"annotations": {
"title": "List form fields",
"readOnlyHint": true,
"openWorldHint": true
}
}List one page of a form's completed submissions, newest first: answers (`data`, keyed by field key — see paperform_list_form_fields), device and UTM info, payment `charge`, generated PDFs and created_at. Page with skip/next_skip or after_id/last_id; filter by date. Paperform: GET /forms/{slug_or_id}/submissions.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| skip | integer | Results to skip (offset). Pass the previous reply's next_skip. |
| sort | string | Sort by created_at: DESC (default, newest first) or ASC. |
| limit | integer | Results per page, 1-100 (Paperform default 20). |
| after_id | string | Cursor: only results after this id (e.g. the previous reply's last_id). |
| before_id | string | Cursor: only results before this id. |
| after_date | string | Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set. |
| before_date | string | Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set. |
{
"name": "paperform_list_submissions",
"title": "List submissions",
"description": "List one page of a form's completed submissions, newest first: answers (`data`, keyed by field key — see paperform_list_form_fields), device and UTM info, payment `charge`, generated PDFs and created_at. Page with skip/next_skip or after_id/last_id; filter by date. Paperform: GET /forms/{slug_or_id}/submissions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"skip": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Results to skip (offset). Pass the previous reply's next_skip."
},
"sort": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by created_at: DESC (default, newest first) or ASC."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (Paperform default 20)."
},
"after_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results after this id (e.g. the previous reply's last_id)."
},
"before_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results before this id."
},
"after_date": {
"type": "string",
"description": "Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set."
},
"before_date": {
"type": "string",
"description": "Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set."
}
}
},
"annotations": {
"title": "List submissions",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch one submission by id, with every answer, device info, payment charge and PDFs. Paperform: GET /submissions/{id}.
| Parameter | Type | Description |
|---|---|---|
| submission_id * | string | The submission id (from paperform_list_submissions). |
{
"name": "paperform_get_submission",
"title": "Get a submission",
"description": "Fetch one submission by id, with every answer, device info, payment charge and PDFs. Paperform: GET /submissions/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"submission_id"
],
"properties": {
"submission_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The submission id (from paperform_list_submissions)."
}
}
},
"annotations": {
"title": "Get a submission",
"readOnlyHint": true,
"openWorldHint": true
}
}List one page of a form's partial submissions (someone started the form), newest first: answers so far, last_answered field, dates. Partials that were later completed stay in the list with submitted_at set; only those with submitted_at null are abandoned. Useful for drop-off analysis and follow-ups. Paperform: GET /forms/{slug_or_id}/partial-submissions.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| skip | integer | Results to skip (offset). Pass the previous reply's next_skip. |
| sort | string | Sort by created_at: DESC (default, newest first) or ASC. |
| limit | integer | Results per page, 1-100 (Paperform default 20). |
| after_id | string | Cursor: only results after this id (e.g. the previous reply's last_id). |
| before_id | string | Cursor: only results before this id. |
| after_date | string | Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set. |
| before_date | string | Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set. |
{
"name": "paperform_list_partial_submissions",
"title": "List partial submissions",
"description": "List one page of a form's partial submissions (someone started the form), newest first: answers so far, last_answered field, dates. Partials that were later completed stay in the list with submitted_at set; only those with submitted_at null are abandoned. Useful for drop-off analysis and follow-ups. Paperform: GET /forms/{slug_or_id}/partial-submissions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"skip": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Results to skip (offset). Pass the previous reply's next_skip."
},
"sort": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by created_at: DESC (default, newest first) or ASC."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (Paperform default 20)."
},
"after_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results after this id (e.g. the previous reply's last_id)."
},
"before_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results before this id."
},
"after_date": {
"type": "string",
"description": "Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set."
},
"before_date": {
"type": "string",
"description": "Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set."
}
}
},
"annotations": {
"title": "List partial submissions",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch one partial submission by id, with the answers given so far. It may have been completed since (submitted_at set); submitted_at null means abandoned. Paperform: GET /partial-submissions/{id}.
| Parameter | Type | Description |
|---|---|---|
| partial_submission_id * | string | The partial submission id (from paperform_list_partial_submissions). |
{
"name": "paperform_get_partial_submission",
"title": "Get a partial submission",
"description": "Fetch one partial submission by id, with the answers given so far. It may have been completed since (submitted_at set); submitted_at null means abandoned. Paperform: GET /partial-submissions/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"partial_submission_id"
],
"properties": {
"partial_submission_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The partial submission id (from paperform_list_partial_submissions)."
}
}
},
"annotations": {
"title": "Get a partial submission",
"readOnlyHint": true,
"openWorldHint": true
}
}List the products sold on a form (SKU, name, price, quantity in stock, sold, minimum/maximum, discountable, images). Paperform: GET /forms/{slug_or_id}/products.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| search | string | Only products whose name matches this text. |
{
"name": "paperform_list_products",
"title": "List form products",
"description": "List the products sold on a form (SKU, name, price, quantity in stock, sold, minimum/maximum, discountable, images). Paperform: GET /forms/{slug_or_id}/products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only products whose name matches this text."
}
}
},
"annotations": {
"title": "List form products",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch one product on a form by SKU: price, quantity in stock, sold count, limits. Paperform: GET /forms/{slug_or_id}/products/{sku}.
| Parameter | Type | Description |
|---|---|---|
| sku * | string | The product SKU (from paperform_list_products). |
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
{
"name": "paperform_get_product",
"title": "Get a form product",
"description": "Fetch one product on a form by SKU: price, quantity in stock, sold count, limits. Paperform: GET /forms/{slug_or_id}/products/{sku}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form",
"sku"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The product SKU (from paperform_list_products)."
},
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
}
}
},
"annotations": {
"title": "Get a form product",
"readOnlyHint": true,
"openWorldHint": true
}
}List a form's coupon codes (code, enabled, target, discountAmount or discountPercentage, expiresAt). Paperform: GET /forms/{slug_or_id}/coupons.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
{
"name": "paperform_list_coupons",
"title": "List form coupons",
"description": "List a form's coupon codes (code, enabled, target, discountAmount or discountPercentage, expiresAt). Paperform: GET /forms/{slug_or_id}/coupons.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
}
}
},
"annotations": {
"title": "List form coupons",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch one coupon on a form by code. Paperform: GET /forms/{slug_or_id}/coupons/{code}.
| Parameter | Type | Description |
|---|---|---|
| code * | string | The coupon code, e.g. DISCOUNT1. |
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
{
"name": "paperform_get_coupon",
"title": "Get a form coupon",
"description": "Fetch one coupon on a form by code. Paperform: GET /forms/{slug_or_id}/coupons/{code}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form",
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The coupon code, e.g. DISCOUNT1."
},
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
}
}
},
"annotations": {
"title": "Get a form coupon",
"readOnlyHint": true,
"openWorldHint": true
}
}List the webhooks on a form (id, target_url, triggers: submission / partial_submission, dates). Needs the Business API. Paperform: GET /forms/{slug_or_id}/webhooks.
| Parameter | Type | Description |
|---|---|---|
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| skip | integer | Results to skip (offset). Pass the previous reply's next_skip. |
| sort | string | Sort by created_at: DESC (default, newest first) or ASC. |
| limit | integer | Results per page, 1-100 (Paperform default 20). |
| after_id | string | Cursor: only results after this id (e.g. the previous reply's last_id). |
| before_id | string | Cursor: only results before this id. |
| after_date | string | Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set. |
| before_date | string | Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set. |
{
"name": "paperform_list_webhooks",
"title": "List form webhooks",
"description": "List the webhooks on a form (id, target_url, triggers: submission / partial_submission, dates). Needs the Business API. Paperform: GET /forms/{slug_or_id}/webhooks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"skip": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Results to skip (offset). Pass the previous reply's next_skip."
},
"sort": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by created_at: DESC (default, newest first) or ASC."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (Paperform default 20)."
},
"after_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results after this id (e.g. the previous reply's last_id)."
},
"before_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results before this id."
},
"after_date": {
"type": "string",
"description": "Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set."
},
"before_date": {
"type": "string",
"description": "Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set."
}
}
},
"annotations": {
"title": "List form webhooks",
"readOnlyHint": true,
"openWorldHint": true
}
}List the account's spaces (folders that group forms): id, name, dates. Needs the Business API. Paperform: GET /spaces.
| Parameter | Type | Description |
|---|---|---|
| skip | integer | Results to skip (offset). Pass the previous reply's next_skip. |
| sort | string | Sort by created_at: DESC (default, newest first) or ASC. |
| limit | integer | Results per page, 1-100 (Paperform default 20). |
| search | string | Only spaces whose name matches this text. |
| after_id | string | Cursor: only results after this id (e.g. the previous reply's last_id). |
| before_id | string | Cursor: only results before this id. |
| after_date | string | Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set. |
| before_date | string | Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set. |
{
"name": "paperform_list_spaces",
"title": "List spaces",
"description": "List the account's spaces (folders that group forms): id, name, dates. Needs the Business API. Paperform: GET /spaces.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"skip": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Results to skip (offset). Pass the previous reply's next_skip."
},
"sort": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by created_at: DESC (default, newest first) or ASC."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (Paperform default 20)."
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only spaces whose name matches this text."
},
"after_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results after this id (e.g. the previous reply's last_id)."
},
"before_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results before this id."
},
"after_date": {
"type": "string",
"description": "Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set."
},
"before_date": {
"type": "string",
"description": "Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set."
}
}
},
"annotations": {
"title": "List spaces",
"readOnlyHint": true,
"openWorldHint": true
}
}List the forms in one space. Needs the Business API. Paperform: GET /spaces/{id}/forms.
| Parameter | Type | Description |
|---|---|---|
| space_id * | string | The space id (from paperform_list_spaces, or a form's space_id). |
{
"name": "paperform_list_space_forms",
"title": "List the forms in a space",
"description": "List the forms in one space. Needs the Business API. Paperform: GET /spaces/{id}/forms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id"
],
"properties": {
"space_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The space id (from paperform_list_spaces, or a form's space_id)."
}
}
},
"annotations": {
"title": "List the forms in a space",
"readOnlyHint": true,
"openWorldHint": true
}
}List Papersign e-signature documents (id, name, status, folder, space, signers, variables, source form/submission, sent/completed dates), filtered by name, status, folder, space or the Paperform submission that created them. Needs the Papersign API. Paperform: GET /papersign/documents.
| Parameter | Type | Description |
|---|---|---|
| skip | integer | Results to skip (offset). Pass the previous reply's next_skip. |
| sort | string | Sort by created_at: DESC (default, newest first) or ASC. |
| limit | integer | Results per page, 1-100 (Paperform default 20). |
| search | string | Only documents whose name matches this text. |
| status | array | Only documents in these statuses. |
| after_id | string | Cursor: only results after this id (e.g. the previous reply's last_id). |
| space_id | string | Only documents anywhere in this space (from paperform_list_papersign_spaces). |
| before_id | string | Cursor: only results before this id. |
| folder_id | string | Only documents in this folder or its subfolders (from paperform_list_papersign_folders). |
| after_date | string | Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set. |
| before_date | string | Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set. |
| paperform_submission_id | string | Only documents created from this Paperform submission id. |
{
"name": "paperform_list_papersign_documents",
"title": "List Papersign documents",
"description": "List Papersign e-signature documents (id, name, status, folder, space, signers, variables, source form/submission, sent/completed dates), filtered by name, status, folder, space or the Paperform submission that created them. Needs the Papersign API. Paperform: GET /papersign/documents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"skip": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Results to skip (offset). Pass the previous reply's next_skip."
},
"sort": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by created_at: DESC (default, newest first) or ASC."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (Paperform default 20)."
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only documents whose name matches this text."
},
"status": {
"type": "array",
"items": {
"enum": [
"draft",
"inProgress",
"archived",
"canceled",
"expired",
"rejected",
"completed"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1,
"description": "Only documents in these statuses."
},
"after_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results after this id (e.g. the previous reply's last_id)."
},
"space_id": {
"type": "string",
"pattern": "^[1-9]\\d{0,18}$",
"description": "Only documents anywhere in this space (from paperform_list_papersign_spaces)."
},
"before_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cursor: only results before this id."
},
"folder_id": {
"type": "string",
"pattern": "^[1-9]\\d{0,18}$",
"description": "Only documents in this folder or its subfolders (from paperform_list_papersign_folders)."
},
"after_date": {
"type": "string",
"description": "Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set."
},
"before_date": {
"type": "string",
"description": "Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set."
},
"paperform_submission_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only documents created from this Paperform submission id."
}
}
},
"annotations": {
"title": "List Papersign documents",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch one Papersign document by id: status, signers and their progress, variables, folder, space and dates. Needs the Papersign API. Paperform: GET /papersign/documents/{id}.
| Parameter | Type | Description |
|---|---|---|
| document_id * | string | The Papersign document id (from paperform_list_papersign_documents). |
{
"name": "paperform_get_papersign_document",
"title": "Get a Papersign document",
"description": "Fetch one Papersign document by id: status, signers and their progress, variables, folder, space and dates. Needs the Papersign API. Paperform: GET /papersign/documents/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The Papersign document id (from paperform_list_papersign_documents)."
}
}
},
"annotations": {
"title": "Get a Papersign document",
"readOnlyHint": true,
"openWorldHint": true
}
}Get a download link for a completed (fully signed) Papersign document as a PDF. A fresh link is made on each call and is valid for one week (expires_at_utc). Needs the Papersign API. Paperform: GET /papersign/documents/{id}/completed-document-url.
| Parameter | Type | Description |
|---|---|---|
| document_id * | string | The id of a completed Papersign document. |
{
"name": "paperform_get_signed_document_url",
"title": "Get the signed PDF link",
"description": "Get a download link for a completed (fully signed) Papersign document as a PDF. A fresh link is made on each call and is valid for one week (expires_at_utc). Needs the Papersign API. Paperform: GET /papersign/documents/{id}/completed-document-url.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The id of a completed Papersign document."
}
}
},
"annotations": {
"title": "Get the signed PDF link",
"readOnlyHint": true,
"openWorldHint": true
}
}List Papersign folders (id, name, parent_id, space_id), optionally inside one space or folder. Needs the Papersign API. Paperform: GET /papersign/folders.
| Parameter | Type | Description |
|---|---|---|
| search | string | Only folders whose name matches this text. |
| space_id | string | Only folders in this space. |
| folder_id | string | Only folders below this folder. |
{
"name": "paperform_list_papersign_folders",
"title": "List Papersign folders",
"description": "List Papersign folders (id, name, parent_id, space_id), optionally inside one space or folder. Needs the Papersign API. Paperform: GET /papersign/folders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only folders whose name matches this text."
},
"space_id": {
"type": "string",
"pattern": "^[1-9]\\d{0,18}$",
"description": "Only folders in this space."
},
"folder_id": {
"type": "string",
"pattern": "^[1-9]\\d{0,18}$",
"description": "Only folders below this folder."
}
}
},
"annotations": {
"title": "List Papersign folders",
"readOnlyHint": true,
"openWorldHint": true
}
}List Papersign spaces (id, name, root_folder_id). Needs the Papersign API. Paperform: GET /papersign/spaces.
| Parameter | Type | Description |
|---|---|---|
| search | string | Only spaces whose name matches this text. |
{
"name": "paperform_list_papersign_spaces",
"title": "List Papersign spaces",
"description": "List Papersign spaces (id, name, root_folder_id). Needs the Papersign API. Paperform: GET /papersign/spaces.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only spaces whose name matches this text."
}
}
},
"annotations": {
"title": "List Papersign spaces",
"readOnlyHint": true,
"openWorldHint": true
}
}WRITE: create a coupon code on a form, with a fixed discountAmount or a discountPercentage (not both), an optional target (price or subscription) and expiry. Respondents can use it at checkout as soon as it is enabled. Undo: paperform_update_coupon with enabled=false. Paperform: POST /forms/{slug_or_id}/coupons.
| Parameter | Type | Description |
|---|---|---|
| code * | string | The new coupon code, e.g. SPRING20. |
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| target | string | What the discount applies to: the one-off price or a subscription. |
| enabled | boolean | Whether respondents can use the coupon. |
| expiresAt | any | When the coupon expires (ISO 8601 with a timezone), or null for no expiry. |
| discountAmount | number | A fixed discount, in the form's currency (e.g. 10 = 10.00). |
| discountPercentage | number | A percentage discount, 0-100. |
{
"name": "paperform_create_coupon",
"title": "Create a form coupon",
"description": "WRITE: create a coupon code on a form, with a fixed discountAmount or a discountPercentage (not both), an optional target (price or subscription) and expiry. Respondents can use it at checkout as soon as it is enabled. Undo: paperform_update_coupon with enabled=false. Paperform: POST /forms/{slug_or_id}/coupons.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form",
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The new coupon code, e.g. SPRING20."
},
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"target": {
"enum": [
"price",
"subscription"
],
"type": "string",
"description": "What the discount applies to: the one-off price or a subscription."
},
"enabled": {
"type": "boolean",
"description": "Whether respondents can use the coupon."
},
"expiresAt": {
"anyOf": [
{
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z (sent to Paperform in UTC)."
},
{
"type": "null"
}
],
"description": "When the coupon expires (ISO 8601 with a timezone), or null for no expiry."
},
"discountAmount": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "A fixed discount, in the form's currency (e.g. 10 = 10.00)."
},
"discountPercentage": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "A percentage discount, 0-100."
}
}
},
"annotations": {
"title": "Create a form coupon",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: change a coupon on a form — enable or disable it, change its discount (amount or percentage), target or expiry (null = never expires). Only the fields you pass are sent. Paperform: PUT /forms/{slug_or_id}/coupons/{code}.
| Parameter | Type | Description |
|---|---|---|
| code * | string | The coupon code, e.g. DISCOUNT1. |
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| target | string | What the discount applies to: the one-off price or a subscription. |
| enabled | boolean | Whether respondents can use the coupon. |
| expiresAt | any | When the coupon expires (ISO 8601 with a timezone), or null for no expiry. |
| discountAmount | number | A fixed discount, in the form's currency (e.g. 10 = 10.00). |
| discountPercentage | number | A percentage discount, 0-100. |
{
"name": "paperform_update_coupon",
"title": "Update a form coupon",
"description": "WRITE: change a coupon on a form — enable or disable it, change its discount (amount or percentage), target or expiry (null = never expires). Only the fields you pass are sent. Paperform: PUT /forms/{slug_or_id}/coupons/{code}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form",
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The coupon code, e.g. DISCOUNT1."
},
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"target": {
"enum": [
"price",
"subscription"
],
"type": "string",
"description": "What the discount applies to: the one-off price or a subscription."
},
"enabled": {
"type": "boolean",
"description": "Whether respondents can use the coupon."
},
"expiresAt": {
"anyOf": [
{
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z (sent to Paperform in UTC)."
},
{
"type": "null"
}
],
"description": "When the coupon expires (ISO 8601 with a timezone), or null for no expiry."
},
"discountAmount": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "A fixed discount, in the form's currency (e.g. 10 = 10.00)."
},
"discountPercentage": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "A percentage discount, 0-100."
}
}
},
"annotations": {
"title": "Update a form coupon",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: set how many units of a form product are available (its stock quantity), e.g. after restocking. Replaces the current value; read it first with paperform_get_product. Not atomic: it overwrites rather than adjusts, so a sale between your read and this write is lost. Paperform: PUT /forms/{slug_or_id}/products/{sku}/quantity.
| Parameter | Type | Description |
|---|---|---|
| sku * | string | The product SKU (from paperform_list_products). |
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| quantity * | integer | The new stock quantity (0 or more). |
{
"name": "paperform_set_product_quantity",
"title": "Set a product's stock quantity",
"description": "WRITE: set how many units of a form product are available (its stock quantity), e.g. after restocking. Replaces the current value; read it first with paperform_get_product. Not atomic: it overwrites rather than adjusts, so a sale between your read and this write is lost. Paperform: PUT /forms/{slug_or_id}/products/{sku}/quantity.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form",
"sku",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The product SKU (from paperform_list_products)."
},
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"quantity": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "The new stock quantity (0 or more)."
}
}
},
"annotations": {
"title": "Set a product's stock quantity",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: set the number of units of a form product recorded as sold (e.g. to correct it after a refund or an offline sale). Replaces the current value; read it first with paperform_get_product. Not atomic: it overwrites rather than adjusts, so a sale between your read and this write is lost. Paperform: PUT /forms/{slug_or_id}/products/{sku}/sold.
| Parameter | Type | Description |
|---|---|---|
| sku * | string | The product SKU (from paperform_list_products). |
| form * | string | The form's slug, custom slug or id (from paperform_list_forms). |
| sold * | integer | The new sold count (0 or more). |
{
"name": "paperform_set_product_sold",
"title": "Set a product's sold count",
"description": "WRITE: set the number of units of a form product recorded as sold (e.g. to correct it after a refund or an offline sale). Replaces the current value; read it first with paperform_get_product. Not atomic: it overwrites rather than adjusts, so a sale between your read and this write is lost. Paperform: PUT /forms/{slug_or_id}/products/{sku}/sold.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form",
"sku",
"sold"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The product SKU (from paperform_list_products)."
},
"form": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The form's slug, custom slug or id (from paperform_list_forms)."
},
"sold": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "The new sold count (0 or more)."
}
}
},
"annotations": {
"title": "Set a product's sold count",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Paperform, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many submissions did my contact form get this week?"; "Show the latest 10 submissions on my booking form."; "Which coupon codes are active on my order form?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Paperform data. Free plan: 50 tool calls per month. Run paperform_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 paperform_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 paperform_upgrade without a plan: it returns both plans, each with a payment link for the user to open. paperform_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.