Integrate with AI Agents using MCP

DocuSeal provides an MCP server that allows AI agents and automation systems to interact with DocuSeal using the Model Context Protocol. With MCP, AI systems can:

• Search document templates by name
• Load template details including fields and signing roles
• Create new document templates from PDF or DOCX files
• Send documents for electronic signature with prefilled fields
• Search and track signed or pending documents

This enables AI-native document workflows where document signing is fully automated and driven by AI agents without manual intervention.

https://yourdomain.com/mcp

Authentication depends on the deployment type: self-hosted DocuSeal or DocuSeal Cloud.

Authorization: Bearer YOUR_DOCUSEAL_MCP_TOKEN

The DocuSeal MCP server works with any MCP-compatible client. Below are configuration examples for the most popular clients.

{
  "mcpServers": {
    "docuseal": {
      "type": "http",
      "url": "https://yourdomain.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DOCUSEAL_MCP_TOKEN"
      }
    }
  }
}

The DocuSeal MCP server exposes the following tools:

Tool	Description
search_templates	Search document templates by name.
load_template	Load a template with its fields and signing roles.
create_template	Create a template from a PDF/DOCX file URL, or create an empty template.
send_documents	Send a document template for signing to specified submitters.
search_documents	Search signed or pending documents by submitter name, email, phone, or template name.

{
  "name": "search_templates",
  "arguments": {
    "q": "NDA"
  }
}

[
  {
    "id": 12,
    "name": "Non-Disclosure Agreement"
  },
  {
    "id": 8,
    "name": "NDA - Mutual"
  }
]

{
  "name": "load_template",
  "arguments": {
    "template_id": 12
  }
}

{
  "id": 12,
  "name": "Non-Disclosure Agreement",
  "roles": [
    "First Party",
    "Second Party"
  ],
  "fields": [
    {
      "name": "Full Name",
      "type": "text",
      "role": "First Party"
    },
    {
      "name": "Signature",
      "type": "signature",
      "role": "First Party"
    },
    {
      "name": "Full Name",
      "type": "text",
      "role": "Second Party"
    },
    {
      "name": "Signature",
      "type": "signature",
      "role": "Second Party"
    }
  ]
}

{
  "name": "create_template",
  "arguments": {
    "url": "https://example.com/contract.pdf",
    "name": "Sales Agreement"
  }
}

{
  "id": 15,
  "name": "Sales Agreement",
  "edit_url": "https://docuseal.com/templates/15/edit"
}

{
  "name": "send_documents",
  "arguments": {
    "template_id": 12,
    "submitters": [
      {
        "email": "john@example.com",
        "name": "John Doe",
        "role": "First Party",
        "fields": [
          {
            "name": "Company Name",
            "value": "Acme Inc"
          }
        ]
      }
    ]
  }
}

{
  "id": 42,
  "status": "pending"
}

{
  "name": "search_documents",
  "arguments": {
    "q": "john@example.com"
  }
}

[
  {
    "id": 42,
    "template_name": "Non-Disclosure Agreement",
    "status": "completed",
    "submitters": [
      {
        "email": "john@example.com",
        "name": "John Doe",
        "status": "completed"
      }
    ],
    "documents_url": "https://yourdomain.com/submissions/42"
  }
]

When a tool call fails, the response includes isError: true and a message describing the problem. Below are the possible error messages:

Tool	Error Message	Cause
load_template	Template not found	The template_id does not match any template. Use search_templates to find the correct ID
send_documents	Template not found	The template_id does not match any template. Use search_templates to find the correct ID
send_documents	Template has no fields	The template has no form fields. Open the template in DocuSeal and add fields before sending
send_documents	No valid submitters provided	The submitters array is empty or contains no valid entries

Authentication errors

Verify that your MCP token is correct. Ensure the token was created in Settings > MCP Server.

Template not found

The template_id passed to send_documents must be a valid template ID. Use search_templates first to find the correct ID.

Template has no fields

A template must have at least one field (e.g., signature, text, date) before it can be sent for signing. Open the template in DocuSeal and add the required fields.

Connection issues with self-hosted DocuSeal

Make sure your DocuSeal instance is accessible from the MCP client. The MCP endpoint must be reachable over HTTPS at https://YOUR_DOMAIN/mcp.