# ZapSign — how to use (mcp.ai)

ZapSign electronic document signing via the official API: create documents for signature (from PDF, DOCX, URL or template), track status, manage signers and authentication, templates, webhooks, background checks and account plan. Generate your API Token in the dashboard under Settings → Integrations → ZAPSIGN API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zapsign?ms=1782513840000`
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. `zapsign_account_plan`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zapsign`
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/zapsign/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zapsign/account/plan` — Conta ZapSign (leitura).
  - body: { page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/account/users` — Conta ZapSign (leitura).
  - body: { page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/account/write/create/user` — Gerenciar usuários da conta ZapSign.
  - body: { email?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/account/write/delete/user` — Gerenciar usuários da conta ZapSign.
  - body: { email?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/checks/get` — Verificação de antecedentes no ZapSign (leitura).
  - body: { check_id: string, account?: string, check_ids?: string[] }
- `POST https://api.mcp.ai/api/zapsign/checks/write/create` — Criar verificação de antecedentes no ZapSign (consome créditos).
  - body: { data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/get` — Documentos de assinatura no ZapSign (leitura).
  - body: { doc_token?: string, status?: string, folder_path?: string, deleted?: boolean, signer_email?: string, created_from?: string, created_to?: string, sort_order?: string, include_signers?: boolean, download_pdf?: boolean, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/list` — Documentos de assinatura no ZapSign (leitura).
  - body: { doc_token?: string, status?: string, folder_path?: string, deleted?: boolean, signer_email?: string, created_from?: string, created_to?: string, sort_order?: string, include_signers?: boolean, download_pdf?: boolean, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/signer/log` — Documentos de assinatura no ZapSign (leitura).
  - body: { doc_token?: string, status?: string, folder_path?: string, deleted?: boolean, signer_email?: string, created_from?: string, created_to?: string, sort_order?: string, include_signers?: boolean, download_pdf?: boolean, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/add/extra/doc` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/create` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/create/from/template` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/delete` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/place/signatures` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/refuse` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/documents/write/update` — Criar/alterar documentos de assinatura no ZapSign.
  - body: { doc_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/list/accounts` — Lista contas ZapSign vinculadas a este install — id e apelido.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/zapsign/signers/get` — Signatários no ZapSign (leitura).
  - body: { signer_token: string, account?: string }
- `POST https://api.mcp.ai/api/zapsign/signers/write/add` — Gerenciar signatários no ZapSign.
  - body: { doc_token?: string, signer_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/signers/write/remove` — Gerenciar signatários no ZapSign.
  - body: { doc_token?: string, signer_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/signers/write/sign` — Gerenciar signatários no ZapSign.
  - body: { doc_token?: string, signer_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/signers/write/update` — Gerenciar signatários no ZapSign.
  - body: { doc_token?: string, signer_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/templates/get` — Templates (modelos DOCX) no ZapSign (leitura).
  - body: { template_token?: string, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/templates/list` — Templates (modelos DOCX) no ZapSign (leitura).
  - body: { template_token?: string, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/zapsign/templates/write/create` — Gerenciar templates no ZapSign.
  - body: { template_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/templates/write/delete` — Gerenciar templates no ZapSign.
  - body: { template_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/templates/write/update` — Gerenciar templates no ZapSign.
  - body: { template_token?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/zapsign/webhooks/write/create` — Gerenciar webhooks no ZapSign (não há endpoint de listagem na API).
  - body: { id?: string, data?: object, account?: string, ids?: string[] }
- `POST https://api.mcp.ai/api/zapsign/webhooks/write/delete` — Gerenciar webhooks no ZapSign (não há endpoint de listagem na API).
  - body: { id?: string, data?: object, account?: string, ids?: string[] }

## Example prompts
- "Create a document for signature from this PDF and add signer João (joao@email.com)"
- "List documents pending signature"
- "What is the signing status of document X?"

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