{
  "markdown": "# MiniFrame Tools\n\n**The Brazilian toolkit for AI agents** — plus the web and document work agents\ncan't do inside a sandbox.\n\nAsk your agent to generate a Pix payment code, resolve a CEP to a full address, or\npull a company's record from the CNPJ registry. Point it at a JavaScript-heavy page\nand get clean Markdown, a screenshot or a PDF back.\n\nA CNPJ lookup costs **$0.01** — billed per call, with no monthly plan, no contract\nand no minimum, which is unusual for Brazilian data APIs.\n\n- **API:** https://tools.miniframe.com.br\n- **Try a tool in one click:** [storefront](https://tryponcho.com/m/tools.miniframe.com.br)\n- **Machine-readable spec:** [openapi.json](https://tools.miniframe.com.br/openapi.json) · [llms.txt](https://tools.miniframe.com.br/llms.txt)\n\n## Tools\n\n- **pix_brcode** — Generate a Brazilian Pix payment code (BR Code / \"Copia e Cola\" string) plus a QR PNG. $0.01 per call.\n- **cep_lookup** — Resolve a Brazilian postal code (CEP) to a full street address. $0.005 per call.\n- **cnpj_lookup** — Look up a Brazilian company by its CNPJ number in the public registry. $0.01 per call.\n- **empresa_profile** — Consolidated Brazilian company profile to qualify a lead: registry + address completed via CEP + derived flags (active, headquarters, age, MEI/Simples, size, risk). $0.02 per call.\n- **url_to_markdown** — Fetch a JavaScript-rendered web page and return clean Markdown for an LLM. $0.02 per call.\n- **screenshot_url** — Take a screenshot of a web page and return it as PNG or JPEG. $0.03 per call.\n- **url_to_pdf** — Render a web page as a PDF. $0.03 per call.\n- **extract** — Extract the structured data a page exposes (JSON-LD, Open Graph, meta, tables, links) plus any fields you pass as CSS selectors. $0.02 per call.\n- **compress_pdf** — Compress a PDF file with Ghostscript. $0.02 per call.\n\nEach tool maps to an HTTP endpoint of the same service:\n\n| Tool | Endpoint |\n|---|---|\n| `pix_brcode` | `POST /pix/brcode` |\n| `cep_lookup` | `POST /cep` |\n| `cnpj_lookup` | `POST /cnpj` |\n| `empresa_profile` | `POST /empresa` |\n| `url_to_markdown` | `POST /url-to-markdown` |\n| `screenshot_url` | `POST /screenshot` |\n| `url_to_pdf` | `POST /url-to-pdf` |\n| `extract` | `POST /extract` |\n| `compress_pdf` | `POST /compress-pdf` |\n\n## What makes these worth paying for\n\n**Brazilian sources, handled properly.** CEP lookups hit BrasilAPI first and fall\nback to ViaCEP automatically, so a single upstream outage doesn't break your agent.\nBoth sources come back through one normalized, English-keyed shape — your prompt\nnever has to know which one answered.\n\n**Pix codes built to spec, locally.** The BR Code follows the Central Bank's EMV\nlayout, CRC16 and all, generated on our side with no third-party payment provider in\nthe path. The key you send is used to build the code and is not stored.\n\n**Privacy taken seriously.** CNPJ responses carry the company record — legal name,\ntrade name, status, main activity, address — with personal fields left out by design.\n\n**Rendering that doesn't become an attack surface.** The web tools run real Chromium,\nso JavaScript pages resolve, and they refuse private and internal addresses (SSRF\nguard) before a page is ever loaded.\n\n**Nothing to install for the hard parts.** Ghostscript and a headless browser are the\nkind of dependency an agent sandbox doesn't have and can't install. That is exactly\nwhat this is for — anything an agent already does well on its own (parsing a CSV,\nreading a spreadsheet) is not sold here.\n\n## Use it as an MCP server\n\nWorks with Claude Desktop, Claude Code, Cursor, Windsurf, Cline and any MCP client.\n\n```json\n{\n  \"mcpServers\": {\n    \"miniframe-tools\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"miniframe-tools-mcp\"],\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"0xyour_private_key\"\n      }\n    }\n  }\n}\n```\n\nRestart the client and the seven tools appear. Then just ask:\n\n> \"Generate a Pix code for R$ 50 to key `abc@example.com`, name Maria Silva, city Recife\"\n>\n> \"What's the address for CEP 01310-100?\"\n>\n> \"Look up CNPJ 00.000.000/0001-91 and tell me if the company is active\"\n>\n> \"Turn https://example.com into Markdown so I can summarise it\"\n\n## Use it as a plain HTTP API\n\nNo MCP needed — every tool is a normal endpoint:\n\n```bash\ncurl -i -X POST https://tools.miniframe.com.br/cep \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"cep\":\"01310100\"}'\n```\n\n## Paying\n\nCalls are billed per request in USDC on Base, using the\n[x402](https://x402.org) protocol: the endpoint answers `402` with the price, your\nclient signs the payment and repeats the request. Most agent runtimes handle this\nfor you.\n\nFor MCP, set `EVM_PRIVATE_KEY` to a wallet funded with a few dollars of USDC — use a\ndedicated low-balance wallet, never your main one. The key stays on your machine and\nsigns locally; it is never sent to the API.\n\n| Variable | Required | Default |\n|---|---|---|\n| `EVM_PRIVATE_KEY` | yes | — |\n| `MINIFRAME_API_URL` | no | `https://tools.miniframe.com.br` |\n\nOver plain HTTP, wrap your client with any x402 library — see\n[`examples/`](examples/) for a runnable Node script.\n\n## License\n\nMIT\n",
  "bytes": 5102,
  "sha": "bd5f115cf8e3ae35683ba25e96fd09ad50b0fdb2ed1d4f89e3a89cec401e5160",
  "repo_slug": "edsonvmendes/miniframe-tools-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_edsonvmendes_miniframe_tools_c6e7ecf4/readme"
}