okraPDF — PDF MCP server

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.

Related MCP server: MCP PDF Reader

Tools

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

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