DocuSign
List envelopes, fill templates, send or void agreements, and download signed PDFs from DocuSign via MCP.
Overview
Connect DocuSign to give AI clients access to your eSignature account: list envelopes, inspect recipients, fill templates, send or void agreements, and download signed PDFs.
Prerequisites
- A DocuSign account (developer demo or production)
- A stackgate.ai account
- For production, the hub integration key must have passed DocuSign go-live review
Getting credentials
- Sign in to stackgate.ai.
- Go to My Integrations and open DocuSign.
- Click Connect DocuSign.
- Choose Demo (developer account) or Production (live account after go-live).
- Approve the DocuSign consent screen (
signatureandextendedscopes). - If your user can access more than one DocuSign account, choose the default account.
- stackgate.ai stores your OAuth tokens securely. No API keys to paste.
You can change the default account later from My Integrations. AI clients can override it per request with account_id.
Platform setup (stackgate.ai operators)
- In the DocuSign Apps and Keys page (or the production admin equivalent), create an integration key.
- Add redirect URIs:
- Production hub:
https://stackgate.ai/oauth/docusign/callback - Local Herd:
https://stackgate.ai/oauth/docusign/callback
- Production hub:
- Request scopes
signatureandextended. - Copy the integration key and secret into the hub environment:
DOCUSIGN_CLIENT_IDDOCUSIGN_CLIENT_SECRET
- Demo works immediately. Production requires DocuSign go-live after successful demo testing.
Using with AI clients
- Dedicated endpoint:
POST /mcp/docusignwith a Sanctum bearer token - Private gateway: one config for all integrations - use
docusign__*namespaced tools
Example prompts:
- List envelopes changed in the last 14 days and summarize who still needs to sign.
- Find the NDA template and send it to jane@example.com as Signer.
- Void envelope 93be49ab-... because the deal was cancelled.
- Download the combined PDF for the completed MSA and store it in temp storage.
See Documentation for HTTP authentication and private gateway setup.
Troubleshooting
- 422 integration not configured - complete the OAuth connect flow in My Integrations and choose a default account if prompted.
- Auth errors / 401 - disconnect and reconnect. Confirm you chose Demo vs Production to match the DocuSign account.
- Wrong account - use Change account in My Integrations, or pass
account_idon the tool call. - 429 rate limit - the connected DocuSign account hit its hourly (3,000) or burst limit. Wait for the window. Do not poll the same envelope more than once every 15 minutes.
- Production connect fails - the integration key must pass DocuSign go-live before production accounts can authorize it.
- PDF download is large - files over 10 MB (or
store_in_temp_storage=true) return a temp storagefile_idinstead of inline bytes.
Available tools
-
get_account
Return details for the connected DocuSign account (name, plan, and settings).
-
list_envelopes
List envelopes that changed in a date window, or fetch specific envelope IDs. from_date or envelope_ids is required.
-
get_envelope
Get status and details for one DocuSign envelope.
-
list_recipients
List recipients and signing status for an envelope.
-
list_templates
List envelope templates on the connected DocuSign account.
-
get_template
Get one DocuSign template, including roles and documents.
-
list_envelope_documents
List documents on an envelope (ids, names, and types). Does not return PDF bytes.
-
download_envelope_document
Download an envelope document as PDF. Use document_id=combined for the full envelope. Files under 10 MB are returned inline; larger files (or store_in_temp_storage=true) return a temp storage file_id.
-
create_envelope_from_template
Create a DocuSign envelope from a template. status=created saves a draft; status=sent emails recipients immediately.
-
void_envelope
Void an in-progress DocuSign envelope. Requires a voided_reason.
-
resend_envelope
Resend an in-progress DocuSign envelope to remaining recipients.
MCP endpoint:
https://stackgate.ai/mcp/docusign
(HTTP) or via the
private gateway.