{"_id":"@builtsign/mcp","name":"@builtsign/mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@builtsign/mcp","version":"0.2.0","description":"Model Context Protocol server for BuiltSign — lets AI assistants upload documents, send signing requests, and track signature status","type":"module","bin":{"builtsign-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsc --watch","typecheck":"tsc --noEmit","start":"node dist/index.js","prepublishOnly":"npm run build"},"repository":{"type":"git","url":"git+https://github.com/crul-ey/Built-sign.git","directory":"packages/mcp-server"},"homepage":"https://builtsign.com/developers","engines":{"node":">=18.0.0"},"keywords":["builtsign","mcp","model-context-protocol","e-signature","document-signing"],"author":{"name":"BuiltSign","email":"developers@builtsign.com"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.4.0"},"_id":"@builtsign/mcp@0.2.0","gitHead":"e25666b0a0951da4d712afc0ee96928df19d876c","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/crul-ey/Built-sign/issues"},"_nodeVersion":"24.14.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-KHSnsqKIibetG6IDj7Ik75EtPIMlZXHiDE0SOVDK4dEPfA6JhbddOIKcukkBwkyCjoe9cQdOdrCC7tGpR0zjew==","shasum":"6f17edb5d0e127b3e3371686c50ffa5132d6dac9","tarball":"https://registry.npmjs.org/@builtsign/mcp/-/mcp-0.2.0.tgz","fileCount":26,"unpackedSize":50164,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFYoHp6obwKhilDRoYazHuqUT8Mv8WJr/GX1zsYZen7aAiEAx1B4qnSbdAGYvNF76g+tRwkDTTEgARBSTwL9XeHLvDw="}]},"_npmUser":{"name":"crul.dev","email":"info@crul.dev"},"directories":{},"maintainers":[{"name":"crul.dev","email":"info@crul.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.0_1784930288599_0.24154575121847777"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-24T21:58:08.459Z","0.2.0":"2026-07-24T21:58:08.753Z","modified":"2026-07-24T21:58:08.952Z"},"maintainers":[{"name":"crul.dev","email":"info@crul.dev"}],"description":"Model Context Protocol server for BuiltSign — lets AI assistants upload documents, send signing requests, and track signature status","homepage":"https://builtsign.com/developers","keywords":["builtsign","mcp","model-context-protocol","e-signature","document-signing"],"repository":{"type":"git","url":"git+https://github.com/crul-ey/Built-sign.git","directory":"packages/mcp-server"},"author":{"name":"BuiltSign","email":"developers@builtsign.com"},"bugs":{"url":"https://github.com/crul-ey/Built-sign/issues"},"license":"MIT","readme":"# BuiltSign MCP Server\n\nConnect AI assistants like Claude to [BuiltSign](https://builtsign.com), the e-signature platform for documents up to 1GB. Upload PDFs, send signing requests, place signature fields, track status and download signed documents, straight from a conversation.\n\n## Requirements\n\n- Node.js 18 or newer\n- A BuiltSign API key (Enterprise plan): create one under **Settings, API Keys** in your BuiltSign dashboard\n- Tip: use a **sandbox** API key while testing. Sandbox keys skip real emails and keep test data separated.\n\n## Installation\n\n### Claude Desktop / Claude Code\n\nAdd the server to your MCP configuration (for Claude Desktop: `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"builtsign\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@builtsign/mcp\"],\n      \"env\": {\n        \"BUILTSIGN_API_KEY\": \"bs_your_api_key\",\n        \"BUILTSIGN_API_URL\": \"https://api.builtsign.com\"\n      }\n    }\n  }\n}\n```\n\nFor Claude Code:\n\n```bash\nclaude mcp add builtsign -e BUILTSIGN_API_KEY=bs_your_api_key -e BUILTSIGN_API_URL=https://api.builtsign.com -- npx -y @builtsign/mcp\n```\n\n### From source\n\n```bash\nnpm install\nnpm run build\nBUILTSIGN_API_KEY=bs_... BUILTSIGN_API_URL=https://api.builtsign.com node dist/index.js\n```\n\n## Environment variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `BUILTSIGN_API_KEY` | Yes | API key with `read` and/or `write` scope (`bs_...`) |\n| `BUILTSIGN_API_URL` | Yes | API base URL, e.g. `https://api.builtsign.com` |\n\n## Tools (15)\n\n**Documents**\n- `upload_document`: upload a PDF from a local path, returns a `document_id`\n- `list_documents`: list uploaded documents\n\n**Signing requests**\n- `create_signing_request`: create a draft (signers are not notified yet)\n- `create_and_send_signing_request`: create and send in one step\n- `send_signing_request`: send a draft to all signers\n- `get_signing_request`: status and details, including per-signer progress and signer ids\n- `list_signing_requests`: list with filters, paginate with `limit` + `offset`\n- `cancel_signing_request`: cancel a pending request\n- `send_reminder`: remind all pending signers\n- `download_signed_pdf`: presigned URL (24h) for the signed PDF of a completed request\n- `add_signature_fields`: place signature fields (replaces all fields; positions in % of the page)\n\n**Templates**\n- `list_templates`: list reusable templates\n- `send_from_template`: send a signing request from a template, with role mapping and variables\n\n**Events and usage**\n- `list_events`: org-wide signing events with cursor pagination\n- `get_usage`: current-period usage and plan limits\n\n## Example prompts\n\n- \"Upload contract.pdf and send it to jan@example.com for signature.\"\n- \"Create a draft signing request for offer.pdf with two signers who sign in order: first Anna, then Mark. Place a signature field for each on page 3.\"\n- \"Which signing requests are still pending? Send everyone a reminder.\"\n- \"The Meridian contract is completed. Give me the download link for the signed PDF.\"\n\n## Notes\n\n- Signers sign in the browser; they never need a BuiltSign account.\n- Sequential signing: set `signing_order` to `sequential` and give each signer an `order` (1, 2, ...).\n- Creates support an optional `idempotency_key` so retried calls never produce duplicates.\n- Errors return the BuiltSign error message plus a machine-readable code, e.g. `Rate limit exceeded (rate_limit_exceeded)`.\n\n## Links\n\n- [API documentation](https://builtsign.com/developers)\n- [BuiltSign](https://builtsign.com)\n\nMIT License\n","readmeFilename":"README.md","_rev":"1-d33aa9e1a8c460a7f2781099152e05e3"}