@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 Conversation

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.

You: Has Jane signed it yet?

AI: Let me check the status.

[Uses check_status tool]

Not yet — the envelope is still in "sent" status. Jane has viewed the document
but hasn't signed. I'll check again later if you'd like.

You: Download it once she's done.

[Later, uses download_signed tool]

The signed PDF has been saved to ~/Documents/nda-signed.pdf.

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