{
  "markdown": "# EasyAccessPDF — MCP Server Examples\n\n**[English](README.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [日本語](README.ja.md)**\n\n> 🌐 **Official website: [easyaccesspdf.com](https://easyaccesspdf.com/)** · [Free PDF Checker](https://easyaccesspdf.com/checker/) · [Pricing](https://easyaccesspdf.com/pricing/) · [MCP setup guide](https://easyaccesspdf.com/mcp/)\n\nConnect 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.\n\n- **Endpoint:** `https://easyaccesspdf.com/wp-json/easy/v1/mcp`\n- **Protocol:** MCP over Streamable HTTP (JSON-RPC 2.0, protocol version `2025-03-26`)\n- **Auth:** HTTP Basic — your EasyAccessPDF account email + a WordPress **application password**\n- **Introspection:** `initialize`, `ping` and `tools/list` answer without auth — only `tools/call` requires credentials\n- **Site:** https://easyaccesspdf.com/mcp/\n\n## Tools (5)\n\n| Tool | What it does | Cost |\n|---|---|---|\n| `eap_convert_to_markdown` | Document (PDF, DOCX, DOC, PPT, XLS, HTML, EPUB, RTF, ODT, TXT) → clean Markdown | Included with membership |\n| `eap_export_pdf` | PDF → `json` (structured tree), `html`, `text`, or `annotated-pdf` (layout visualization, 24h download URL) | Included with membership |\n| `eap_check_pdf` | veraPDF PDF/UA-1 (ISO 14289-1) accessibility audit: pages, grade A/B/C/F, issue list, tag coverage | Included with membership |\n| `eap_get_account_status` | Plan, expiry, credit balance, current prices | Included with membership |\n| `eap_fix_pdf` | Auto-tag + metadata injection + veraPDF re-audit → 24h download URL for a zip (tagged PDF + report + manual-review checklist) | **1 credit per document** — billed for members and non-members alike |\n\nAll tools take a **publicly accessible URL** of the document (max 50MB). Documents are processed in the EU (Frankfurt) and not stored.\n\n### Input schemas (live from `tools/list`)\n\n```jsonc\n// eap_convert_to_markdown\n{ \"type\": \"object\", \"properties\": { \"url\": { \"type\": \"string\" } }, \"required\": [\"url\"] }\n\n// eap_export_pdf\n{ \"type\": \"object\",\n  \"properties\": {\n    \"url\": { \"type\": \"string\" },\n    \"format\": { \"type\": \"string\", \"enum\": [\"json\", \"html\", \"text\", \"annotated-pdf\"] } },\n  \"required\": [\"url\", \"format\"] }\n\n// eap_check_pdf\n{ \"type\": \"object\", \"properties\": { \"url\": { \"type\": \"string\" } }, \"required\": [\"url\"] }\n\n// eap_fix_pdf\n{ \"type\": \"object\",\n  \"properties\": { \"url\": { \"type\": \"string\" }, \"title\": { \"type\": \"string\" } },\n  \"required\": [\"url\"] }\n\n// eap_get_account_status\n{ \"type\": \"object\", \"properties\": [] }\n```\n\n## 1. Get your credentials\n\n1. Create an account at https://easyaccesspdf.com/my-account/ and verify your email (6-digit code).\n2. Buy the **MCP Membership** ($19.90 / 32 days, no auto-renewal — purchases stack) or credit packs for `eap_fix_pdf`.\n3. In **My Account → Profile → Application Passwords**, create a new application password (e.g. named `claude`).\n4. Build the Basic token: `base64( youremail@example.com : your-application-password )`.\n\n```bash\n# Linux / macOS\nprintf 'you@example.com:xxxx xxxx xxxx xxxx xxxx xxxx' | base64\n# Windows PowerShell\n[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('you@example.com:xxxx xxxx xxxx xxxx xxxx xxxx'))\n```\n\nKeep the token private — it can spend your credits. Revoke any time in your WP profile.\n\n## 2. Client setup\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http easyaccesspdf \\\n  https://easyaccesspdf.com/wp-json/easy/v1/mcp \\\n  --header \"Authorization: Basic <BASE64>\"\nclaude mcp list   # should show easyaccesspdf with 5 tools\n```\n\n### Claude Desktop\n\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) / `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"easyaccesspdf\": {\n      \"type\": \"http\",\n      \"url\": \"https://easyaccesspdf.com/wp-json/easy/v1/mcp\",\n      \"headers\": { \"Authorization\": \"Basic <BASE64>\" }\n    }\n  }\n}\n```\n\n### Cursor\n\n`~/.cursor/mcp.json` (or project `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"easyaccesspdf\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://easyaccesspdf.com/wp-json/easy/v1/mcp\",\n      \"headers\": { \"Authorization\": \"Basic <BASE64>\" }\n    }\n  }\n}\n```\n\n### Codex (OpenAI)\n\n`~/.codex/config.toml`:\n\n```toml\n[mcp_servers.easyaccesspdf]\nurl = \"https://easyaccesspdf.com/wp-json/easy/v1/mcp\"\nhttp_headers = { \"Authorization\" = \"Basic <BASE64>\" }\n```\n\nVerify with `codex mcp list`.\n\n### Any stdio-only client (bridge)\n\nClients that only speak stdio MCP can use [`bridge/eap-mcp-bridge.mjs`](bridge/eap-mcp-bridge.mjs) — a zero-dependency Node 18+ script that forwards stdio JSON-RPC to the hosted endpoint. A [`Dockerfile`](Dockerfile) is included for containerized runners.\n\n```json\n{\n  \"mcpServers\": {\n    \"easyaccesspdf\": {\n      \"command\": \"node\",\n      \"args\": [\"bridge/eap-mcp-bridge.mjs\"],\n      \"env\": { \"EAP_TOKEN\": \"<BASE64>\" }\n    }\n  }\n}\n```\n\nOr with Docker: `docker build -t eap-mcp-bridge . && docker run -i --rm -e EAP_TOKEN=<BASE64> eap-mcp-bridge`. Without `EAP_TOKEN` the bridge still answers `initialize` / `tools/list` (introspection is open); `tools/call` then returns the upstream 401.\n\n## 3. Minimal clients (no SDK)\n\nSee [`examples/python_client.py`](examples/python_client.py) and [`examples/node_client.mjs`](examples/node_client.mjs) — plain HTTP/JSON-RPC, no dependencies beyond `requests` / Node 18+.\n\n```bash\npython examples/python_client.py\nnode examples/node_client.mjs\n```\n\nBoth run: `initialize` → `tools/list` → `eap_get_account_status` and print the results.\n\n## Billing transparency\n\n- Membership ($19.90 / 32 days, stacking, no auto-renewal) includes unlimited conversions, exports, checks, and account status.\n- `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.\n- Credits never expire. Pricing: https://easyaccesspdf.com/pricing/\n\n## License\n\nMIT — see [LICENSE](LICENSE). Examples only; EasyAccessPDF is a commercial service operated by HEPA Zweigniederlassung der RUBIX GmbH, Germany.\n",
  "bytes": 6297,
  "sha": "78c613470f772e9014c64e3fa27209c5e6db9a63924432c399d12da16d5adbcb",
  "repo_slug": "luotwo/easyaccesspdf-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_luotwo_easyaccesspdf_mcp_85bfe100/readme"
}