@signforge/mcp-server

@signforge/mcp-server

Send documents for e-signature directly from Claude Desktop, Claude Code, Cursor, and other AI agents — powered by SignForge, the free e-signature platform.

What It Does

This MCP server connects AI agents to SignForge's e-signature API. Your AI assistant can:

• Send documents for signature — upload a PDF, specify a signer, and send in one step
• Manage envelopes — send, void, delete, and check status
• Download documents — signed PDFs, audit certificates, and ZIP archives
• Use templates — create envelopes from reusable templates with pre-filled fields
• Manage webhooks — subscribe to real-time envelope events
• Generate embed URLs — create embeddable signing experiences

Quick Start

1. Get Your API Key

Sign up at signforge.io and generate an API key from your Developer Settings.

2. Configure Your AI Client

Choose your client below and add the configuration:

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add signforge -- npx -y @signforge/mcp-server

Then set the environment variable in your shell:

export SIGNFORGE_API_KEY="your-api-key-here"

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Direct (npx)

SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server

3. Restart Your Client

Restart Claude Desktop, Claude Code, or Cursor to pick up the new MCP server.

Tools

Envelope Management

Tool	Description
create_and_send	Upload a PDF, add a signer, and send for e-signature. Accepts a local file path or base64-encoded PDF.
check_status	Check the status of an envelope — see signing progress, timestamps, and available documents.
list_envelopes	List your envelopes with optional status filtering (draft, sent, completed, voided, expired).
send_envelope	Send a draft envelope for signing.
void_envelope	Void (cancel) an active envelope with an optional reason.
delete_envelope	Permanently delete a draft or voided envelope.

Document Downloads

Tool	Description
download_signed	Download the signed PDF for a completed envelope to a local file.
download_certificate	Download the audit certificate PDF with full audit trail.
download_archive	Download a ZIP archive with signed PDF, certificate, and all documents.

Embedded Signing

Tool	Description
get_embed_url	Generate an embeddable signing URL for in-app signing experiences.

Templates

Tool	Description
list_templates	List your reusable document templates.
create_from_template	Create an envelope from a template with optional pre-filled field values. Send immediately or save as draft.

Webhooks

Tool	Description
create_webhook	Subscribe to envelope events (sent, viewed, signed, completed, expired, voided, declined).
list_webhooks	List all configured webhooks.
delete_webhook	Delete a webhook by ID.

Example Conversations

Send a document for signature

You: Send my NDA at ~/Documents/nda.pdf to [e-mail] (Jane Smith) for signature.

AI: I'll send that NDA for signature now.

[Uses create_and_send tool]

Done! I've created and sent the envelope:
- Envelope ID: a1b2c3d4-...
- Status: sent
- Jane Smith ([e-mail]) will receive a signing link via email.

Check status and download

You: Has Jane signed the NDA yet?

AI: Let me check.

[Uses check_status tool]

Yes! Jane signed it on April 7 at 2:15 PM. The envelope is now completed.

You: Great, download the signed copy and the audit certificate.

[Uses download_signed tool]
[Uses download_certificate tool]

Done! Files saved:
- Signed PDF: ~/Documents/nda-signed.pdf
- Audit Certificate: ~/Documents/nda-certificate.pdf

Use a template with pre-filled fields

You: Send our standard consulting agreement to [e-mail].
     Pre-fill the company name as "Acme Corp" and the start date as "May 1, 2026".

AI: I'll create that from your consulting agreement template.

[Uses list_templates tool — finds "Consulting Agreement" template]
[Uses create_from_template tool — with prefill_fields and send_immediately: true]

Done! Envelope created and sent:
- Title: Consulting Agreement
- Recipient: [e-mail]
- Pre-filled: company = "Acme Corp", start_date = "May 1, 2026"
- Status: sent

Manage envelope lifecycle

You: List my sent envelopes.

[Uses list_envelopes tool with status: "sent"]

You: Void the contract for Project Alpha — the deal fell through.

[Uses void_envelope tool with reason]

You: Now delete it.

[Uses delete_envelope tool]

Done — envelope voided and deleted.

Set up a webhook

You: Set up a webhook to notify my server when documents are signed or completed.

[Uses create_webhook tool]

Webhook created:
- URL: https://api.yourapp.com/webhooks/signforge
- Events: envelope.signed, envelope.completed
- Secret: whsec_abc123... (save this for signature verification!)

Environment Variables

Variable	Required	Default	Description
SIGNFORGE_API_KEY	Yes	—	Your SignForge API key. Get one at signforge.io/dashboard/developers.
SIGNFORGE_API_URL	No	https://signforge.io/api/v1	API base URL. Only change this for self-hosted instances or staging.

Sandbox Mode

API keys created in sandbox mode will create test envelopes that don't send real emails. Use sandbox mode during development and testing.

Troubleshooting

"SIGNFORGE_API_KEY environment variable is required" Make sure you've set the SIGNFORGE_API_KEY in your MCP client configuration. See the setup instructions above.

"SignForge API error (401)" Your API key is invalid or expired. Generate a new one at signforge.io/dashboard/developers.

"SignForge API error (403)" Your API key doesn't have permission for this operation. Check your key's scopes.

"SignForge API error (429)" You've hit the rate limit. Wait a moment and try again.

Server not showing up in Claude Desktop

• Make sure the config JSON is valid (no trailing commas)
• Restart Claude Desktop completely (quit + reopen)
• Check the MCP server logs in Claude Desktop's developer console

Links

• SignForge — Free e-signature platform
• API Documentation — Full API reference
• GitHub — Source code
• MCP Protocol — Model Context Protocol specification

License

MIT