OkraPDF PDF Server

npm License: MIT

Give your AI agent real PDF tools over the Model Context Protocol. One command connects Claude, Cursor, ChatGPT, or any MCP host to okraPDF — turn any PDF into a bbox-cited accessible HTML twin, then parse, extract, query, and render.

This package is a thin launcher around the hosted okraPDF MCP endpoint (https://okrapdf.com/mcp). There's no server to run locally — it bridges your MCP host (over stdio) to the remote server and handles sign-in for you.

Quickstart

npx @okrapdf/pdf-mcp

view_html (PDF → accessible HTML twin) works with no account. The doc-intelligence tools prompt a one-time Clerk sign-in in your browser the first time an agent calls them.

Claude Code

claude mcp add okrapdf -- npx -y @okrapdf/pdf-mcp

Claude Desktop / Cursor

Add to your MCP config (claude_desktop_config.json or Cursor's mcp.json):

{
  "mcpServers": {
    "okrapdf": {
      "command": "npx",
      "args": ["-y", "@okrapdf/pdf-mcp"]
    }
  }
}

Hosts with native remote MCP (Claude web, ChatGPT, Cursor)

Skip this package and add the URL directly: https://okrapdf.com/mcp. The launcher above is only needed for hosts that speak stdio. Same endpoint, same sign-in.

Tools

Tool	What it does	Auth
view_html	Stream any public PDF as a live, bbox-cited accessible HTML twin	None
doc-intelligence — parse · extract · query · resolve · upload · execute · render · workflow	Layout-aware parse, schema extraction with page/bbox citations, cross-document Q&A, renders, and multi-step workflows	Clerk sign-in

Sign-in is identity, not a paywall — the doc-intelligence tools are free with an okraPDF account. The public view_html accessibility twin needs no account. See okrapdf.com.

Configuration

Override	How
Point at a different okraPDF endpoint	OKRA_MCP_URL=http://localhost:8787/mcp npx @okrapdf/pdf-mcp (or pass the URL as the first arg)
Pass flags to the underlying bridge	Anything after the command is forwarded to mcp-remote, e.g. --transport sse-only, --debug

How it works

MCP host  ──stdio──▶  @okrapdf/pdf-mcp  ──HTTPS (Streamable HTTP + OAuth)──▶  okrapdf.com/mcp

okraPDF's MCP is a hosted, remote server (Cloudflare Streamable HTTP). This launcher wraps mcp-remote so stdio-only hosts can reach it and complete the Clerk OAuth sign-in for the account-gated tools.

Links

• Website: https://okrapdf.com
• Docs / connector setup: https://okrapdf.com/docs
• Issues: https://github.com/okrapdf/pdf-mcp/issues

License

MIT © okraPDF