Connect Draftable to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the create comparison from files tool in Draftable
Use the create comparison tool in Draftable
Use the get comparison tool in Draftable
Use the list comparisons tool in Draftable
Use the get change details tool in Draftable
Use the delete comparison tool in Draftable
Supported Tools
create_comparison_from_files
Create Comparison From Files
Creates a new document comparison between two documents (left and right). Documents are uploaded directly from base64-encoded bytes, so no public document URL is required. Supports cross-format comparisons (e.g., Word to PDF). The comparison will be processed asynchronously — check the `ready` field to determine when results are available.
create_comparison
Create Comparison
Creates a new document comparison between two documents (left and right). Documents are provided via publicly accessible URLs. Supports cross-format comparisons (e.g., Word to PDF). The comparison will be processed asynchronously — check the `ready` field to determine when results are available.
get_comparison
Get Comparison
Retrieves a specific comparison by its identifier. Returns the comparison's metadata, processing status, and document details.
list_comparisons
List Comparisons
Lists all comparisons associated with your account, ordered from newest to oldest. Supports pagination via limit and offset parameters.
get_change_details
Get Change Details
Retrieves the comparison results as structured JSON. Provides a programmatic summary of all detected changes between two documents, including insertions, deletions, and replacements with their locations. Useful for integrating comparison results into workflows without the visual viewer.
delete_comparison
Delete Comparison
Permanently deletes a comparison by its identifier. This also removes all associated exports and change details. This action cannot be undone.
get_export_status
Get Export Status
Retrieves the status of a PDF export. Use this to poll for export completion after initiating an export with the **Export Comparison** tool. When ready, provides a downloadable PDF and its current download URL.
export_comparison
Export Comparison
Initiates a PDF export of a comparison. Exports are processed asynchronously — use the returned export identifier to poll for completion with the **Get Export Status** tool. Four export kinds are available: left (original document), right (revised document), combined (both documents), and single_page (redline view with highlights and deletion markers).
get_viewer_url
Get Viewer URL
Generates a viewer URL for a comparison. For private comparisons, generates a signed URL with an expiry time. For public comparisons, generates a direct public URL. The viewer supports side-by-side and single-page (redline) views and can be embedded in an iframe.
Enable Draftable in Metorial. In your Metorial portal, enable the Draftable MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Draftable tools.
Enable Draftable in Metorial. In your Metorial portal, enable the Draftable MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Draftable tools.
Enable Draftable in Metorial. In your Metorial portal, enable the Draftable MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Draftable tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Draftable in Metorial. In your Metorial portal, enable the Draftable MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Draftable tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Draftable in Metorial. In your Metorial portal, enable the Draftable MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Draftable tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Draftable through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Draftable and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Draftable tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Compare two documents to detect differences in text, formatting, and layout. Supports Word, PowerPoint, Excel, PDF, RTF, and text files, including cross-format comparisons (e.g., Word to PDF). Create comparisons by uploading files or providing URLs, retrieve structured change details as JSON, view comparisons in interactive side-by-side or redline viewers, and export comparison results to PDF. Manage comparisons by listing, retrieving, or deleting them.
Frequently asked questions
Common questions about connecting Draftable to AI agents with Metorial.
How many tools does the Draftable MCP server have?
The Draftable MCP server exposes 9 tools, including Create Comparison From Files, Create Comparison, Get Comparison. Each one is governed and traced through Metorial.
Does the Draftable MCP server support triggers?
Draftable exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Draftable MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Draftable MCP server through the same Metorial URL.
How do I give only some teams access to Draftable?
Use role-based access control to decide which teams, users, and agents can use Draftable and which of its tools they can call.
Can I self-host the Draftable MCP server?
Yes. Metorial is open source, so you can run the Draftable MCP server yourself or use the hosted gateway.
Connect Draftable to production AI agents
See how Metorial gives your team governed access to Draftable, with tracing and security controls built in.