EasyAccessPDF

EasyAccessPDF — MCP Server Examples

[English](README.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [日本語](README.ja.md)

🌐 Official website: [easyaccesspdf.com](https://easyaccesspdf.com/) · Free PDF Checker · Pricing · MCP setup guide

Connect AI clients (Claude Code, Claude Desktop, Cursor, Codex) to the EasyAccessPDF MCP server: convert documents to Markdown, export PDFs to JSON/HTML/text, run veraPDF accessibility checks, and auto-fix PDF/UA issues — directly from your AI workflow.

• Endpoint: https://easyaccesspdf.com/wp-json/easy/v1/mcp
• Protocol: MCP over Streamable HTTP (JSON-RPC 2.0, protocol version 2025-03-26)
• Auth: HTTP Basic — your EasyAccessPDF account email + a WordPress application password
• Introspection: initialize, ping and tools/list answer without auth — only tools/call requires credentials
• Site: https://easyaccesspdf.com/mcp/

Tools (5)

All tools take a publicly accessible URL of the document (max 50MB). Documents are processed in the EU (Frankfurt) and not stored.

Input schemas (live from tools/list)

// eap_convert_to_markdown

{ "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"] }

// eap_export_pdf { "type": "object", "properties": { "url": { "type": "string" }, "format": { "type": "string", "enum": ["json", "html", "text", "annotated-pdf"] } }, "required": ["url", "format"] }

// eap_check_pdf { "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"] }

// eap_fix_pdf { "type": "object", "properties": { "url": { "type": "string" }, "title": { "type": "string" } }, "required": ["url"] }

// eap_get_account_status { "type": "object", "properties": [] }

1. Get your credentials

1. Create an account at https://easyaccesspdf.com/my-account/ and verify your email (6-digit code).
2. Buy the MCP Membership ($19.90 / 32 days, no auto-renewal — purchases stack) or credit packs for eap_fix_pdf.
3. In My Account → Profile → Application Passwords, create a new application password (e.g. named claude).
4. Build the Basic token: base64( youremail@example.com : your-application-password ).

# Linux / macOS

printf 'you@example.com:xxxx xxxx xxxx xxxx xxxx xxxx' | base64

Windows PowerShell

Keep the token private — it can spend your credits. Revoke any time in your WP profile.

2. Client setup

Claude Code

claude mcp add --transport http easyaccesspdf \

https://easyaccesspdf.com/wp-json/easy/v1/mcp \ --header "Authorization: Basic " claude mcp list # should show easyaccesspdf with 5 tools

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{

"mcpServers": { "easyaccesspdf": { "type": "http", "url": "https://easyaccesspdf.com/wp-json/easy/v1/mcp", "headers": { "Authorization": "Basic " } } } }

Cursor

~/.cursor/mcp.json (or project .cursor/mcp.json):

{

"mcpServers": { "easyaccesspdf": { "type": "streamable-http", "url": "https://easyaccesspdf.com/wp-json/easy/v1/mcp", "headers": { "Authorization": "Basic " } } } }

Codex (OpenAI)

~/.codex/config.toml:

[mcp_servers.easyaccesspdf]

url = "https://easyaccesspdf.com/wp-json/easy/v1/mcp" http_headers = { "Authorization" = "Basic " }

Verify with codex mcp list.

Any stdio-only client (bridge)

Clients that only speak stdio MCP can use bridge/eap-mcp-bridge.mjs — a zero-dependency Node 18+ script that forwards stdio JSON-RPC to the hosted endpoint. A Dockerfile is included for containerized runners.

{

"mcpServers": { "easyaccesspdf": { "command": "node", "args": ["bridge/eap-mcp-bridge.mjs"], "env": { "EAP_TOKEN": " " } } } }

Or with Docker: docker build -t eap-mcp-bridge . && docker run -i --rm -e EAP_TOKEN= eap-mcp-bridge. Without EAP_TOKEN the bridge still answers initialize / tools/list (introspection is open); tools/call then returns the upstream 401.

3. Minimal clients (no SDK)

See examples/python_client.py and examples/node_client.mjs — plain HTTP/JSON-RPC, no dependencies beyond requests / Node 18+.

python examples/python_client.py

node examples/node_client.mjs

Both run: initialize → tools/list → eap_get_account_status and print the results.

Billing transparency

• Membership ($19.90 / 32 days, stacking, no auto-renewal) includes unlimited conversions, exports, checks, and account status.
• eap_fix_pdf always costs 1 remediation credit per document ($2.99 single-fix value; credit packs bring it to $0.67) — for members and non-members alike. Membership has no fix privilege.
• Credits never expire. Pricing: https://easyaccesspdf.com/pricing/

License

MIT — see LICENSE. Examples only; EasyAccessPDF is a commercial service operated by HEPA Zweigniederlassung der RUBIX GmbH, Germany.