Miniframe Tools
Pay-per-call Brazilian toolkit: Pix codes, CEP, CNPJ, BCB rates, web capture and PDF
- Pricing
- Paid
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 1.3.0
- Listing updated
- 1 day ago
About Miniframe Tools
Miniframe Tools is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
MiniFrame Tools bundles services an agent usually cannot do inside a sandbox. For Brazil it generates Pix payment codes (BR Code plus QR PNG), resolves CEP postal codes to addresses with a BrasilAPI to ViaCEP fallback, looks up companies by CNPJ, builds a consolidated company profile for lead qualification and fetches official Central Bank rates such as Selic, CDI and USD/BRL.
For the web it renders JavaScript pages to Markdown, screenshots or PDF, extracts structured data such as JSON-LD, Open Graph and CSS-selected fields, and compresses PDFs with Ghostscript. The README says the web tools refuse private and internal addresses.
There is no signup or subscription: each call is billed through x402 on Base, from half a cent to three cents depending on the tool. The npm package signs payments locally with a private key from a wallet funded with a small amount of USDC; the registry entry advises a dedicated low-balance wallet and says the key is never sent to the API.
Install
Run in a terminal
claude mcp add miniframe-tools --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y miniframe-tools-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"miniframe-tools": {
"command": "npx",
"args": [
"-y",
"miniframe-tools-mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"miniframe-tools": {
"command": "npx",
"args": [
"-y",
"miniframe-tools-mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"miniframe-tools": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"miniframe-tools-mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"miniframe-tools": {
"command": "npx",
"args": [
"-y",
"miniframe-tools-mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"miniframe-tools": {
"command": "npx",
"args": [
"-y",
"miniframe-tools-mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
}
}
}
}Configuration
EVM_PRIVATE_KEYPrivate key of a wallet on Base funded with a small amount of USDC, used to sign per-call payments locally. Use a dedicated low-balance wallet; the key is never sent to the API.RequiredMINIFRAME_API_URLOverride the API base URL. Defaults to https://tools.miniframe.com.br
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- pix_brcode
- Generate a Brazilian Pix payment code plus a QR PNG.
- cep_lookup
- Resolve a Brazilian postal code to a full street address.
- cnpj_lookup
- Look up a Brazilian company by CNPJ in the public registry.
- empresa_profile
- Consolidated company profile for qualifying a lead.
- url_to_markdown
- Fetch a JavaScript-rendered page as clean Markdown.
- screenshot_url
- Take a screenshot of a web page.
- url_to_pdf
- Render a web page as a PDF.
- extract
- Extract structured data a page exposes plus chosen CSS-selected fields.
- compress_pdf
- Compress a PDF with Ghostscript.
What it does
- Pix code generation
- Builds Pix BR Code strings and QR images locally to spec.
- CEP and CNPJ lookup
- Resolves postal codes and company registry records, with personal fields left out.
- Central Bank rates
- Returns Selic, CDI and USD/BRL from the BCB's own API.
- Web rendering
- Converts JavaScript pages to Markdown, screenshots or PDF.
- Structured extraction
- Pulls JSON-LD, meta tags, tables and chosen selectors from a page.
- PDF compression
- Shrinks PDFs with Ghostscript in light, balanced or max modes.
Good for
- Generate a Pix payment code for an invoice
- Resolve a customer's address from a CEP
- Verify a Brazilian company before a deal
- Give an agent clean Markdown of a script-heavy page
- Compress a PDF an agent cannot process itself
Pricing
Paid
Pay per call via x402 from $0.005 (CEP) to $0.03 (screenshot, PDF); no subscription
Prices change. Check tools.miniframe.com.br before you buy.
Miniframe Tools FAQ
How is it billed?
Per call through x402 on Base, from $0.005 to $0.03, with no subscription.
What do I need to run it?
Node via npx plus a Base wallet key funded with a little USDC, set as EVM_PRIVATE_KEY.
Is the private key sent anywhere?
The registry entry says it is used to sign payments locally and never sent to the API.
Does the CNPJ tool expose personal data?
Personal fields are omitted and partner tax IDs masked, and it is for business verification only.
Is Miniframe Tools free?
No. Miniframe Tools is a paid product.
How do I add Miniframe Tools to Claude Code?
Run this command in your terminal: claude mcp add miniframe-tools --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y miniframe-tools-mcp
What are the best alternatives to Miniframe Tools?
The closest alternatives to Miniframe Tools are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.
Alternatives to Miniframe Tools

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

SearXNG Search
MCP serverMCP server for web search and page reading through a SearXNG instance
Runs locally- 3 tools
- Open source
- 1.4K GitHub stars
- Web search and scraping

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments