# Miniframe Tools

> Miniframe Tools is a paid MCP server for finance and payments. Pay-per-call Brazilian toolkit: Pix codes, CEP, CNPJ, BCB rates, web capture and PDF. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://tools.miniframe.com.br
- **Repository:** https://github.com/edsonvmendes/miniframe-tools-mcp
- **MCP Registry name:** io.github.edsonvmendes/miniframe-tools
- **Categories:** finance and payments, web search and scraping
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add miniframe-tools --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y miniframe-tools-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "miniframe-tools": {
      "command": "npx",
      "args": [
        "-y",
        "miniframe-tools-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "miniframe-tools": {
      "command": "npx",
      "args": [
        "-y",
        "miniframe-tools-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "miniframe-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "miniframe-tools-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "miniframe-tools": {
      "command": "npx",
      "args": [
        "-y",
        "miniframe-tools-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "miniframe-tools": {
      "command": "npx",
      "args": [
        "-y",
        "miniframe-tools-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/miniframe-tools
