{
  "markdown": "# @bigapi/mcp\n\n[![npm version](https://img.shields.io/npm/v/%40bigapi%2Fmcp)](https://www.npmjs.com/package/@bigapi/mcp)\n[![bigapi-mcp MCP server](https://glama.ai/mcp/servers/BiGapi-2026/bigapi-mcp/badges/score.svg)](https://glama.ai/mcp/servers/BiGapi-2026/bigapi-mcp)\n\nMCP server for **[bigapi.dev](https://bigapi.dev)** – *deterministic file operations for AI agents.*\n\nGives Claude Desktop, Cursor, Cline, Windsurf and any MCP-capable agent the file operations an LLM cannot do itself – over plain HTTPS, with one key, nothing to install server-side:\n\n| Tool | What it does |\n|---|---|\n| `render` | HTML / Markdown / URL → **PDF** or **PNG** via server-side Chromium (reports, invoices, offers, documentation) |\n| `screenshot` | Any public URL, real device presets (desktop / laptop / tablet / mobile), full page |\n| `ocr` | Scanned PDF or photo → searchable PDF, plain text, or per-page JSON (`deu`, `eng`, `deu+eng`, …) |\n| `office_to_pdf` | DOCX, XLSX, PPTX, ODT, RTF, CSV, TXT → PDF via server-side LibreOffice |\n| `pdf_to_pdfa` | PDF → archival **PDF/A-2b** with embedded fonts (long-term storage, compliance) |\n| `pdf_merge` · `pdf_split` · `pdf_rotate` · `pdf_compress` | The PDF basics |\n| `pdf_to_images` | PDF pages → JPEG/PNG, e.g. to look at a document with a vision model |\n| `image_process` | Resize, crop, rotate, convert (webp/avif/…), compress, strip EXIF, watermark – one call |\n| `image_info` | Format, dimensions, color space, EXIF/ICC presence |\n| `get_access` | Free API key, instantly, no signup – 100 free operations that **never expire** |\n| `get_balance` · `get_usage` · `set_monthly_cap` · `get_pricing` | Account |\n\n**$0.01 per operation. 100 free. Free operations and balance never expire. Failed calls are free.** Servers in Germany, GDPR, files deleted after delivery.\n\nAlso listed in the [official MCP Registry](https://registry.modelcontextprotocol.io) as `dev.bigapi/mcp`.\n\n## Install\n\nRequires Node 18+. No API key needed up front – the agent can call `get_access` itself.\n\n### Claude Desktop\n\n`claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"bigapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bigapi/mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Then: *\"Get bigapi access and render this text as a PDF on my Desktop.\"*\n\n### Cursor / Windsurf / Cline\n\nSame block in the respective MCP settings (`.cursor/mcp.json`, `~/.codeium/windsurf/mcp_config.json`, Cline → MCP Servers → Configure).\n\n### With an existing key\n\n```json\n\"bigapi\": { \"command\": \"npx\", \"args\": [\"-y\", \"@bigapi/mcp\"], \"env\": { \"BIGAPI_KEY\": \"bigapi_...\" } }\n```\n\n## How files work\n\nInputs are local paths (`/Users/me/report.pdf`, `C:\\Users\\me\\scan.pdf`). Outputs are written to `output_path` if given, otherwise to a temp folder (`BIGAPI_OUTPUT_DIR` to change). Every result includes the cost, what it was charged from, and the remaining balance.\n\n## Pricing\n\nFlat **$0.01 per operation** (per page for `ocr` and `office_to_pdf`, $0.05 for `pdf_to_pdfa`). Prepaid from $5 – no subscription, no signup, balance never expires, failed calls are free. Machine-readable: `get_pricing` or `GET /v1/pricing`.\n\n## Environment\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `BIGAPI_KEY` | – | Use this key instead of the stored one |\n| `BIGAPI_CONFIG_DIR` | `~/.bigapi` | Where `get_access` stores the key (`config.json`, mode 600) |\n| `BIGAPI_OUTPUT_DIR` | OS temp dir | Default output folder |\n| `BIGAPI_URL` | `https://api.bigapi.dev` | API base (for self-hosting / testing) |\n\n## Without MCP\n\nPlain HTTP works everywhere (n8n, Make, Zapier, LangChain, your code):\n\n```bash\ncurl -X POST https://api.bigapi.dev/v1/keys                       # → key\ncurl -o out.pdf https://api.bigapi.dev/v1/render \\\n  -H \"Authorization: Bearer $KEY\" -H \"content-type: application/json\" \\\n  -d '{\"markdown\":\"# Hello from an agent\"}'\n```\n\nOpenAPI: https://api.bigapi.dev/openapi.json · Docs: https://api.bigapi.dev/docs · Guides: https://bigapi.dev/guides/ · llms.txt: https://api.bigapi.dev/llms.txt\n\n## License\n\nMIT\n",
  "bytes": 4062,
  "sha": "b0ac15bb9d78a55b15af1f9edd94946045b8c0b5ff328a9b0c6eff178b92407e",
  "repo_slug": "bigapi-2026/bigapi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_bigapi_mcp_7868be41/readme"
}