Draftable MCP server
7 operations0 webhooks
Compare PDF, Word and PowerPoint documents with Draftable, view the differences and export them as PDF.
Try Draftable with your agent
Connect Draftable, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Draftable on my account, then run one read-only example and show me the result.
Draftable tools and triggers
Tools are what your agent can do in Draftable through Corsair's MCP server. Triggers are the Draftable events a routine can start from.
Comparisons
- CreateDestructive
Compare two documents given by URL (PDF, Word, PowerPoint, RTF or text). Uses one comparison from the plan quota.
comparisons.create
- DeleteDestructive
Delete a comparison and its documents from Draftable.
comparisons.delete
- GetRead-only
Get one comparison: both documents, page counts, and whether it is ready or failed.
comparisons.get
- Get Viewer UrlRead-only
Get a link to view a comparison in the Draftable viewer, signed for a limited time unless the comparison is public.
comparisons.getViewerUrl
- ListRead-only
List the comparisons on the Draftable account.
comparisons.list
Exports
- CreateWrite
Start a PDF export of a comparison. Poll exports.get until ready, then download its url.
exports.create
- GetRead-only
Get an export: whether it is ready and the URL to download the PDF.
exports.get
Connect Draftable to Claude, ChatGPT or Cursor
- 1
Connect Draftable in Corsair
Add your Draftable API key once in Corsair. Corsair stores the credential encrypted and makes the Draftable API calls for your agent, so it never goes into a prompt or a config file. Connect Draftable
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Draftable. On a ChatGPT personal plan, connect Draftable here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Draftable's read and write operations run right away and its 2 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/draftable, add the Draftable plugin, and connect with an API key. Then call methods like corsair.draftable.api.comparisons.create() from your app. Corsair syncs data per tenant.
Yes. Draftable requires an API key from your Draftable account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Draftable, GitHub, Notion, Stripe, and the rest. Trigger Draftable from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for compare PDF, Word and PowerPoint documents with Draftable, view the differences and export them as PDF. Common builds include sync jobs, admin tooling, and agents that call Draftable APIs from your backend. Local DB entities let you query synced Draftable records without hitting the API on every read.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Draftable API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/draftable in the open repo. When Draftable ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Draftable data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Draftable data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Draftable on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 2 destructive Draftable operations. You can change a link's mode at hub.corsair.dev/me.