# Signwell — how to use (mcp.ai)

Connect your Signwell account and use 12 tools for e-signatures straight from your AI agent. Connect with your own API key. SignWell is an electronic signature tool for legally binding e-signatures and faster document signing.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_signwell?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `signwell_create_document`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/signwell`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/signwell/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/signwell/create/document` — Tool to create and optionally send a new document for signing. Use when you have files and recipients defined and want to programmatically submit a signature request in one call.
  - body: { draft?: boolean, files: object[], message?: string, subject?: string, language?: string, metadata?: object, reminders?: boolean, test_mode?: boolean, text_tags?: boolean, expires_in?: integer, recipients: object[], redirect_url?: string, allow_decline?: boolean, allow_reassign?: boolean, embedded_signing?: boolean, api_application_id?: string, apply_signing_order?: boolean, with_signature_page?: boolean, decline_redirect_url?: string, custom_requester_name?: string, custom_requester_email?: string, embedded_signing_notifications?: boolean }
- `POST https://api.mcp.ai/api/signwell/create/document/from/template` — Tool to create and optionally send a new document for signing from a template. Use when you need to generate a document using a pre-configured template with placeholders. If draft is set to true the d
  - body: { name?: string, draft?: boolean, files?: object[], fields?: object[][], labels?: object[], message?: string, subject?: string, metadata?: object, reminders?: boolean, test_mode?: boolean, text_tags?: boolean, expires_in?: integer, recipients: object[], template_id?: string, redirect_url?: string, template_ids?: string[], allow_decline?: boolean, allow_reassign?: boolean, copied_contacts?: object[], template_fields?: object[], embedded_signing?: boolean, api_application_id?: string, apply_signing_order?: boolean, attachment_requests?: object[], with_signature_page?: boolean, decline_redirect_url?: string, custom_requester_name?: string, custom_requester_email?: string, embedded_signing_notifications?: boolean }
- `POST https://api.mcp.ai/api/signwell/create/webhook` — Tool to register a webhook callback URL. Use when you need to receive document event notifications.
  - body: { callbackUrl: string, apiApplicationId?: string }
- `POST https://api.mcp.ai/api/signwell/delete/document` — Tool to delete a document (and cancel signing if in progress). Use when you need to remove a document by ID after confirming it.
  - body: { id: string }
- `POST https://api.mcp.ai/api/signwell/delete/webhook` — Deletes a registered webhook by its ID. Use this to remove webhooks that are no longer needed. Returns no content on success.
  - body: { id: string }
- `POST https://api.mcp.ai/api/signwell/get/credentials` — Retrieve account information for the authenticated API key. Returns comprehensive details including user profile, account settings, workspace configuration, and contact information. Use this to valida
- `POST https://api.mcp.ai/api/signwell/get/document` — Tool to return a document and all associated document data. Use when you need to fetch document details by ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/signwell/list/bulk/sends` — Tool to list all Bulk Sends. Use after setting up API credentials to retrieve paginated records.
  - body: { page?: integer, email?: string, per_page?: integer, api_application_id?: string }
- `POST https://api.mcp.ai/api/signwell/list/webhooks` — Tool to list all registered webhooks. Use when you need to retrieve the active webhooks for your SignWell account after setup.
- `POST https://api.mcp.ai/api/signwell/send/reminder` — Tool to send a reminder email to recipients that have not signed yet. Use when you need to prompt unsigned recipients to complete their signature.
  - body: { id: string, recipients?: object[] }
- `POST https://api.mcp.ai/api/signwell/update/and/send/document` — Tool to update a draft document and send it to recipients for signing. Use when you need to modify document settings and initiate the signing process.
  - body: { id: string, name?: string, labels?: object[], message?: string, subject?: string, metadata?: object, reminders?: boolean, test_mode?: boolean, expires_in?: integer, redirect_url?: string, allow_decline?: boolean, allow_reassign?: boolean, embedded_signing?: boolean, api_application_id?: string, apply_signing_order?: boolean, decline_redirect_url?: string, custom_requester_name?: string, custom_requester_email?: string, embedded_signing_notifications?: boolean }
- `POST https://api.mcp.ai/api/signwell/update/template` — Tool to update an existing template in SignWell. Use when you need to modify template properties such as name, subject, message, reminders, expiration, or other settings.
  - body: { id: string, name?: string, draft?: boolean, labels?: object[], message?: string, subject?: string, metadata?: object, reminders?: boolean, expires_in?: integer, redirect_url?: string, allow_decline?: boolean, allow_reassign?: boolean, api_application_id?: string, apply_signing_order?: boolean, decline_redirect_url?: string }

## Example prompts
- "What can I do in Signwell?"
- "Show me a summary of my Signwell account"

## More
- Page: https://mcp.ai/signwell
- Agent spec (llms.txt): https://mcp.ai/signwell/llms.txt
- Postman collection: https://mcp.ai/signwell/postman.json