mcp-server-docusign (patched)

A Model Context Protocol server exposing DocuSign eSignature operations, authenticated via JWT Grant (headless / service-to-service — no browser OAuth). Suitable for unattended AI-agent runtimes.

Fork of luthersystems/mcp-server-docusign (MIT) with bug fixes found during live integration testing. Used as a self-hosted MCP tool channel in an internal multi-agent AI platform.

Why this fork

The upstream server's status/document tools had several bugs surfaced when integrating against the DocuSign demo environment. This fork fixes them:

Tool	Bug	Fix
get_envelope_status	Accessed non-existent Envelope.signed_date_time (a recipient-level field) → AttributeError	Removed the field
list_envelope_documents	Returned doc.pages (a list of non-serializable Page objects) → MCP "no structured output" error	Return page count instead
list_envelopes	DocuSign requires from_date; omitting it raised INVALID_REQUEST_PARAMETER	Default from_date to a far-past date so no-arg calls list all envelopes

download_envelope_document works as-is — pass a valid document_id such as combined, certificate, or an id returned by list_envelope_documents.

Tools (8)

• Templates: list_templates, get_template_definition
• Send: create_envelope_from_template, create_envelope_from_documents
• Track: get_envelope_status, list_envelopes
• Documents: list_envelope_documents, download_envelope_document

Configuration (JWT Grant)

Provide via environment variables:

Env	Description
DS_AUTH_BASE	https://account-d.docusign.com (demo) / https://account.docusign.com (prod)
DS_INTEGRATION_KEY	DocuSign app Integration Key (client ID)
DS_USER_ID	User GUID to impersonate
DS_PRIVATE_KEY	RSA private key, base64-encoded (single line); or DS_PRIVATE_KEY_PATH for a file
DS_OAUTH_SCOPE	signature impersonation

One-time DocuSign setup: create an Integration Key, add an RSA keypair, grant consent for signature impersonation. See DocuSign JWT Grant.

Run

stdio MCP server (Python ≥ 3.11):

uvx --from git+https://github.com/<you>/mcp-server-docusign@<commit> mcp-server-docusign

License

MIT — inherited from upstream luthersystems/mcp-server-docusign. See LICENSE.