Documenso MCP by usefulapi is an MCP server published by io.usefulapi, hosted at documenso.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 16 tools, including documenso_list_documents, documenso_get_document, documenso_get_documents_by_ids, documenso_get_recipient, documenso_get_field.
Read and send documents for signature — templates, recipients, fields and folders.
4,160 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 documents, optionally filtered by status, folder, source template or a text query. Documenso v2: GET /document.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| query | string | Free-text search over document titles. |
| source | string | How the document was created. |
| status | string | Only documents in this state. |
| perPage | integer | Results per page, 1-100. |
| folderId | string | Only documents in this folder. |
| templateId | integer | Only documents created from this template. |
| orderByDirection | string | Sort by creation time. Defaults to desc. |
{
"name": "documenso_list_documents",
"title": "List documents",
"description": "List documents, optionally filtered by status, folder, source template or a text query. Documenso v2: GET /document.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"query": {
"type": "string",
"description": "Free-text search over document titles."
},
"source": {
"enum": [
"DOCUMENT",
"TEMPLATE",
"TEMPLATE_DIRECT_LINK"
],
"type": "string",
"description": "How the document was created."
},
"status": {
"enum": [
"DRAFT",
"PENDING",
"COMPLETED",
"REJECTED",
"CANCELLED"
],
"type": "string",
"description": "Only documents in this state."
},
"perPage": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100."
},
"folderId": {
"type": "string",
"description": "Only documents in this folder."
},
"templateId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only documents created from this template."
},
"orderByDirection": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort by creation time. Defaults to desc."
}
}
},
"annotations": {
"title": "List documents",
"readOnlyHint": true
}
}Fetch a single document with its recipients, fields and current status. Documenso v2: GET /document/{documentId}.
| Parameter | Type | Description |
|---|---|---|
| documentId * | integer | The document's numeric id. |
{
"name": "documenso_get_document",
"title": "Get one document",
"description": "Fetch a single document with its recipients, fields and current status. Documenso v2: GET /document/{documentId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The document's numeric id."
}
}
},
"annotations": {
"title": "Get one document",
"readOnlyHint": true
}
}Fetch several documents in one call. Read-only despite being a POST — the v2 API is action-shaped. Documenso v2: POST /document/get-many.
| Parameter | Type | Description |
|---|---|---|
| documentIds * | array | The numeric document ids to fetch. |
{
"name": "documenso_get_documents_by_ids",
"title": "Get several documents by id",
"description": "Fetch several documents in one call. Read-only despite being a POST — the v2 API is action-shaped. Documenso v2: POST /document/get-many.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentIds"
],
"properties": {
"documentIds": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "The numeric document ids to fetch."
}
}
},
"annotations": {
"title": "Get several documents by id",
"readOnlyHint": true
}
}Fetch a single recipient — their email, role, signing order and whether they have signed. Documenso v2: GET /document/recipient/{recipientId}.
| Parameter | Type | Description |
|---|---|---|
| recipientId * | integer | The recipient's numeric id. |
{
"name": "documenso_get_recipient",
"title": "Get one recipient",
"description": "Fetch a single recipient — their email, role, signing order and whether they have signed. Documenso v2: GET /document/recipient/{recipientId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"recipientId"
],
"properties": {
"recipientId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The recipient's numeric id."
}
}
},
"annotations": {
"title": "Get one recipient",
"readOnlyHint": true
}
}Fetch a single document field — its type, page, position and inserted value. Documenso v2: GET /document/field/{fieldId}.
| Parameter | Type | Description |
|---|---|---|
| fieldId * | integer | The field's numeric id. |
{
"name": "documenso_get_field",
"title": "Get one field",
"description": "Fetch a single document field — its type, page, position and inserted value. Documenso v2: GET /document/field/{fieldId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fieldId"
],
"properties": {
"fieldId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The field's numeric id."
}
}
},
"annotations": {
"title": "Get one field",
"readOnlyHint": true
}
}List the attachments on one document. Documenso v2: GET /document/attachment.
| Parameter | Type | Description |
|---|---|---|
| documentId * | integer | The document's numeric id. |
{
"name": "documenso_list_document_attachments",
"title": "List document attachments",
"description": "List the attachments on one document. Documenso v2: GET /document/attachment.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The document's numeric id."
}
}
},
"annotations": {
"title": "List document attachments",
"readOnlyHint": true
}
}Get a download URL for a document's PDF. Returns a link, not the file bytes. Documenso v2: GET /document/{documentId}/download.
| Parameter | Type | Description |
|---|---|---|
| version | string | Which PDF to link to. Defaults to the signed version when one exists. |
| documentId * | integer | The document's numeric id. |
{
"name": "documenso_get_document_download_url",
"title": "Get a document download link",
"description": "Get a download URL for a document's PDF. Returns a link, not the file bytes. Documenso v2: GET /document/{documentId}/download.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"version": {
"enum": [
"original",
"signed"
],
"type": "string",
"description": "Which PDF to link to. Defaults to the signed version when one exists."
},
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The document's numeric id."
}
}
},
"annotations": {
"title": "Get a document download link",
"readOnlyHint": true
}
}List reusable document templates. Templates are how you create a new document without uploading a PDF. Documenso v2: GET /template.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| query | string | Free-text search over template titles. |
| perPage | integer | Results per page, 1-100. |
| folderId | string | Only templates in this folder. |
{
"name": "documenso_list_templates",
"title": "List templates",
"description": "List reusable document templates. Templates are how you create a new document without uploading a PDF. Documenso v2: GET /template.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"query": {
"type": "string",
"description": "Free-text search over template titles."
},
"perPage": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100."
},
"folderId": {
"type": "string",
"description": "Only templates in this folder."
}
}
},
"annotations": {
"title": "List templates",
"readOnlyHint": true
}
}Fetch a single template with its recipient placeholders and fields — read this before calling documenso_create_document_from_template so you know the recipient ids. Documenso v2: GET /template/{templateId}.
| Parameter | Type | Description |
|---|---|---|
| templateId * | integer | The template's numeric id. |
{
"name": "documenso_get_template",
"title": "Get one template",
"description": "Fetch a single template with its recipient placeholders and fields — read this before calling documenso_create_document_from_template so you know the recipient ids. Documenso v2: GET /template/{templateId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"templateId"
],
"properties": {
"templateId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The template's numeric id."
}
}
},
"annotations": {
"title": "Get one template",
"readOnlyHint": true
}
}List folders used to organise documents and templates. Documenso v2: GET /folder.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| query | string | Free-text search over folder names. |
| perPage | integer | Results per page, 1-100. |
| parentId | string | Only folders inside this parent folder. |
{
"name": "documenso_list_folders",
"title": "List folders",
"description": "List folders used to organise documents and templates. Documenso v2: GET /folder.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"query": {
"type": "string",
"description": "Free-text search over folder names."
},
"perPage": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100."
},
"parentId": {
"type": "string",
"description": "Only folders inside this parent folder."
}
}
},
"annotations": {
"title": "List folders",
"readOnlyHint": true
}
}Create a new document from an existing template, filling in the real recipients. Set distribute_document to true to send it for signature immediately. Call documenso_get_template first to read the placeholder recipient ids. Documenso v2: POST /template/use.
| Parameter | Type | Description |
|---|---|---|
| folderId | string | Create the document inside this folder. |
| externalId | string | Your own reference id for the new document. |
| recipients * | array | One entry per template recipient placeholder. |
| templateId * | integer | The template to instantiate. |
| distribute_document | boolean | Send the document for signature immediately. Defaults to false (creates a draft). |
{
"name": "documenso_create_document_from_template",
"title": "Create a document from a template",
"description": "Create a new document from an existing template, filling in the real recipients. Set distribute_document to true to send it for signature immediately. Call documenso_get_template first to read the placeholder recipient ids. Documenso v2: POST /template/use.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"templateId",
"recipients"
],
"properties": {
"folderId": {
"type": "string",
"description": "Create the document inside this folder."
},
"externalId": {
"type": "string",
"description": "Your own reference id for the new document."
},
"recipients": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"email"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The template placeholder recipient id this person fills."
},
"name": {
"type": "string",
"description": "The real recipient's name."
},
"email": {
"type": "string",
"description": "The real recipient's email address."
}
}
},
"description": "One entry per template recipient placeholder."
},
"templateId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The template to instantiate."
},
"distribute_document": {
"type": "boolean",
"description": "Send the document for signature immediately. Defaults to false (creates a draft)."
}
}
},
"annotations": {
"title": "Create a document from a template",
"destructiveHint": true
}
}Add a signer, approver, viewer or CC to a draft document. Documenso v2: POST /document/recipient/create.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The recipient's name. |
| role * | string | What this recipient does with the document. |
| email * | string | The recipient's email address. |
| documentId * | integer | The document's numeric id. Must still be a draft. |
| signingOrder | integer | Position in a sequential signing order. |
{
"name": "documenso_add_recipient",
"title": "Add a recipient to a document",
"description": "Add a signer, approver, viewer or CC to a draft document. Documenso v2: POST /document/recipient/create.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId",
"email",
"name",
"role"
],
"properties": {
"name": {
"type": "string",
"description": "The recipient's name."
},
"role": {
"enum": [
"SIGNER",
"APPROVER",
"CC",
"VIEWER",
"ASSISTANT"
],
"type": "string",
"description": "What this recipient does with the document."
},
"email": {
"type": "string",
"description": "The recipient's email address."
},
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The document's numeric id. Must still be a draft."
},
"signingOrder": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Position in a sequential signing order."
}
}
},
"annotations": {
"title": "Add a recipient to a document",
"destructiveHint": true
}
}Send a draft document to its recipients for signature. This emails real people. Documenso v2: POST /document/distribute.
| Parameter | Type | Description |
|---|---|---|
| message | string | Override the invitation email body. |
| subject | string | Override the invitation email subject. |
| documentId * | integer | The draft document to send. |
{
"name": "documenso_distribute_document",
"title": "Send a document for signature",
"description": "Send a draft document to its recipients for signature. This emails real people. Documenso v2: POST /document/distribute.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"message": {
"type": "string",
"description": "Override the invitation email body."
},
"subject": {
"type": "string",
"description": "Override the invitation email subject."
},
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The draft document to send."
}
}
},
"annotations": {
"title": "Send a document for signature",
"destructiveHint": true
}
}Resend the signing invitation to named recipients of an already-sent document. This emails real people. Documenso v2: POST /document/redistribute.
| Parameter | Type | Description |
|---|---|---|
| documentId * | integer | The document to resend. |
| recipients * | array | The numeric recipient ids to email again. |
{
"name": "documenso_redistribute_document",
"title": "Resend a document to recipients",
"description": "Resend the signing invitation to named recipients of an already-sent document. This emails real people. Documenso v2: POST /document/redistribute.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId",
"recipients"
],
"properties": {
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The document to resend."
},
"recipients": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "The numeric recipient ids to email again."
}
}
},
"annotations": {
"title": "Resend a document to recipients",
"destructiveHint": true
}
}Copy an existing document into a new draft, keeping its fields. Documenso v2: POST /document/duplicate.
| Parameter | Type | Description |
|---|---|---|
| documentId * | integer | The document to copy. |
{
"name": "documenso_duplicate_document",
"title": "Duplicate a document",
"description": "Copy an existing document into a new draft, keeping its fields. Documenso v2: POST /document/duplicate.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"documentId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The document to copy."
}
}
},
"annotations": {
"title": "Duplicate a document",
"destructiveHint": true
}
}Create a folder for organising documents or templates. Documenso v2: POST /folder/create.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The folder name. |
| type | string | What the folder holds. |
| parentId | string | Nest it inside this parent folder. |
{
"name": "documenso_create_folder",
"title": "Create a folder",
"description": "Create a folder for organising documents or templates. Documenso v2: POST /folder/create.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The folder name."
},
"type": {
"enum": [
"DOCUMENT",
"TEMPLATE"
],
"type": "string",
"description": "What the folder holds."
},
"parentId": {
"type": "string",
"description": "Nest it inside this parent folder."
}
}
},
"annotations": {
"title": "Create a folder",
"destructiveHint": true
}
}Tools for Documenso, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which documents are still waiting for a signature?"; "Show who has signed and who has not on my latest contract."; "List my saved document templates so I can pick one for a contract.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Documenso data. Free plan: 50 tool calls per month. Run documenso_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 documenso_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 documenso_upgrade without a plan: it returns both plans, each with a payment link for the user to open. documenso_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.