Skip to main content
PDF CraftGitHub6.5K
On this page

Getting started

Connect your agent with MCP

Let your AI agent convert and translate PDF and EPUB files with PDFCraft.

Connect PDFCraft to an AI agent that supports remote MCP servers. Your agent can convert PDFs to Markdown or EPUB, translate PDFs, and translate EPUB books. It can also check your balance, estimate costs and retrieve conversion results.

Set up the connection

  1. Create your own API Key in OOMOL Console.
  2. Add a remote MCP server in your agent's settings. Use https://api.pdfcraft.ai/v1/mcp as the URL and Streamable HTTP as the transport.
  3. Add the header Authorization: Bearer YOUR_API_KEY, replacing YOUR_API_KEY with your key.

The following JSON shows the connection fields. Configuration keys vary by client; use these values in the corresponding URL and HTTP header settings:

json
{  "url": "https://api.pdfcraft.ai/v1/mcp",  "headers": {    "Authorization": "Bearer YOUR_API_KEY"  }}

Keep your key in the client's protected settings. Do not paste it into conversations or include it in file URLs. Conversions consume PDFCraft credits; you can add credits here.

Check client compatibility

The service uses Streamable HTTP with MCP protocol version 2026-07-28. Your client must support this version and custom Bearer authentication headers. Older initialization and session flows from 2025 are not supported.

There is no interactive OAuth sign-in. Clients that require OAuth and cannot send a Bearer API Key cannot connect directly.

Try your first conversion

Once connected, your agent can discover tools and their instructions. Ask it to call get_capabilities first to learn the supported formats, languages and workflow. For example:

Convert this PDF to EPUB. Check my balance and estimate the cost before starting.

Your agent needs access to the actual file bytes to upload it; a local path alone is not enough for the remote server. It can then create a task, upload the file, launch processing, check progress and obtain a download link. Save the task UUID to resume later.

Full downloads are the default. If an outstanding balance blocks a download, add credits and request a new link for the same task. An incomplete file is returned only when explicitly requested and available.

For direct integration in your own application, see the REST API reference.