# Pontofato

> Pontofato is a freemium MCP server for maps and travel. Brazilian address lookups, nearby CEPs and company counts around a point. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://pontofato.com
- **Repository:** https://github.com/wrpbr/pontofato
- **License:** MIT-0
- **MCP Registry name:** com.pontofato/pontofato
- **Categories:** maps and travel, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://pontofato.com/mcp
```

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

```json
{
  "mcpServers": {
    "pontofato": {
      "url": "https://pontofato.com/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

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

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [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.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/pontofato
