Skip to content
MCP server

Pontofato

Brazilian address lookups, nearby CEPs and company counts around a point

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
License
MIT-0
Version
1.1.0
Listing updated
2 days ago

About Pontofato

Pontofato is a freemium MCP server for maps and travel. It runs as a hosted remote server, so there is nothing to install locally.

PontoFato joins IBGE 2022 Census address coordinates (CNEFE) with census tract context and Brazilian company records. An agent can look up a CEP, search a street in a state or city, list a building's units, find the address nearest a coordinate, list CEPs within up to 2 km, and list companies registered at a CEP. A company count by activity code (CNAE) around a point also lists the latest openings.

The README is open about limits. Addresses come from the 2022 Census and do not prove a CEP is valid today. Companies come from the public Receita Federal CNPJ dump and are matched by CEP, so a distance is a CEP distance, not an exact building. Census tract figures describe an area, not the occupants. Results should be read with their base date and truncation flags.

CEP lookup, street search, nearest address, radius and companies-of-a-CEP are free; other calls have allowances or credit. The checkout=site setting means the server has no purchase tool.

Install

Run in a terminal

claude mcp add --transport http pontofato https://pontofato.com/mcp

Add to Settings → Connectors → Add custom connector

https://pontofato.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pontofato": {
      "url": "https://pontofato.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pontofato": {
      "type": "http",
      "url": "https://pontofato.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pontofato": {
      "serverUrl": "https://pontofato.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pontofato": {
      "type": "http",
      "url": "https://pontofato.com/mcp"
    }
  }
}

Tools this server provides (15)

Read directly from the server.

api_index
The API index: each route and how to connect the MCP.
health
Service availability and the address coverage by state (UF).
cep
The summary of a CEP (Brazilian postal code): the center (latitude and longitude), the place, the counts, the Census and the source. For every address point, pass `detalhe: "pontos"`. We join CNEFE addresses, company records and census sectors. Use the prepared result instead of importing and joining those datasets. Addresses and census data reflect 2022. Census measures describe the sector, not a
proximo
The address nearest to a latitude and longitude. A missing or empty value does not become zero. `(0,0)` is in the Gulf of Guinea, and the tool uses it only when you send it.
buscar
Finds a street by name (or by neighborhood) in Brazil, up to 20 results: one for each street in each city. When the query has a house number that exists, the result has the point of that number.
unidades
The units at a CEP (apartment, store), with the complement and the type, in pages. The CEP lookup groups the addresses by street and number; this tool returns each unit. Without `logradouro` and `numero`, it pages through the whole CEP.
empresas
The companies registered at a CEP, up to 50 per page.
raio
The CEPs within N meters of a point (a CEP, or a latitude and longitude), with the distance and the addresses. Free.
vizinhanca
The active, opened and closed companies within a radius in meters, by CNAE (activity code), with the recent openings and the distance. We import the address and company data and join them geographically. Query the neighborhood without downloading and indexing both datasets. CNEFE reflects 2022. Company positions and distances use postal codes. Check base, truncado and lenta. Missing counts are unk
contact
Write to the people behind the product: a question, or a sponsorship/partnership/advertising proposal. Free, no captcha and no payment; one message every 10 s per network (one that arrives sooner waits its turn). One route for a question and for a sponsorship, partnership or ad proposal (`tipo`, with the placements of `GET /api/partners`). No captcha, no account, no payment. One message every 10 s
sugerir
Suggestions for a partial CEP or a street name, with the neighborhood and the city. Up to eight places. A CEP accepts a prefix of 3 to 8 digits, with an optional hyphen after the fifth digit. A street search accepts an optional state (UF) and city. One address represents each CEP; the full lookup returns the others. The reference is CNEFE 2022, and it does not certify the current postal CEP.
api_access
Discover the monthly data package or inspect a private purchase. Returns: { offer{id,price_usd,credits,days,auto_renew,unit,products,purchase,method,status,header,payment_methods,prepaid_credit,instructions,generate_pass,client,guide,workflow,evaluation}, enabled?, id?, status?, granted_credits?, expires_at?, receipt?, via?, message? }
api_access_buy
Buy 1000 basic data reads for US$0.10, valid for 30 days. Same pass in retries recovers the same purchase. No automatic renewal. OCR, AI, documents and delivery keep their own tariffs. Send X-API-Pass on eligible data reads; remaining credits come in X-API-Credits-Remaining. With prepaid credit, you can skip this purchase: send X-Credito (or Authorization: Bearer cred_…) on the data read, and afte
pricing
Current public prices, free allowances and payment discovery; does not create a charge.
get_api_x402_cnpj_by_cnpj
CNPJ lookup paid per call, without an account: the Federal Revenue record, the sanctions, the tax standing and the address on the map. The same record as `GET /api/consulta/cnpj/:cnpj`, for agents: no account, no allowance and no pack. A request without payment gets the 402; a paid one gets the record in the same response, with the payment in `uso`. A lookup that fails or does not find the company

What it does

CEP lookup
Addresses and coordinates with census tract context.
Street search
Search by name and list a building's units.
Radius search
CEPs within up to 2 km.
Company counts
Active, opened and closed companies by activity near a point.
Stated limits
Responses carry base date and truncation flags.

Good for

  • Find coordinates for an address
  • Which restaurants opened near a CEP lately
  • Scope competitors around a site
  • List companies at a postal code

Pricing

Freemium

Core lookups free; some calls use an allowance, pack or plan; prices not published here

Prices change. Check pontofato.com before you buy.

Pontofato FAQ

What is free?

CEP lookup, street search, nearest address, radius and companies of a CEP.

Does the plugin pay for me?

No. With checkout=site there is no purchase tool; you buy credit on the site.

Is the company distance exact?

No. Companies are matched by CEP, so it is a CEP distance, not the building.

Is Pontofato free?

Pontofato has a free plan, with paid plans for more usage or features.

How do I add Pontofato to Claude Code?

Run this command in your terminal: claude mcp add --transport http pontofato https://pontofato.com/mcp

What are the best alternatives to Pontofato?

The closest alternatives to Pontofato are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to Pontofato

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel