Skip to content
MCP server

Miniframe Tools

Pay-per-call Brazilian toolkit: Pix codes, CEP, CNPJ, BCB rates, web capture and PDF

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • MINIFRAME_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

  1. MCP 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
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP 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
  4. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments