Pontofato

com.pontofatoPublished by pontofato.comOfficial publisherv1.1.0Updated Nov 11, 2026

Find companies near a Brazilian location using prepared address joins. Free allowance, then paid.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for Brazilian addresses: CEP lookups with IBGE coordinates, street search, radius queries and companies by CEP or CNPJ.

What you can do
  • Look up a CEP and get its addresses, latitude/longitude and census tract context, plus the units and companies registered there
  • Search streets by name, neighborhood, state or city, and get suggestions for partial CEPs or street names
  • Find the nearest address to a coordinate and list the CEPs within a radius of up to 2 km
  • Count active, opened and closed companies by CNAE around a point, with recent openings
  • Check a company by CNPJ, including special status, sanctions and partners, and suggest companies by name, partner, phone or e-mail
  • Read the API index, service health and address coverage by state, and send a question or partnership proposal
When to use it
Useful when an assistant needs Brazilian address or company data without downloading and indexing the CNEFE and Receita Federal datasets, for example geocoding a CEP, finding businesses near a point, or checking a CNPJ record.
Requirements
A remote Streamable HTTP endpoint; no local runtime, package or key is needed for the free tools. Paid calls use a credit token supplied by the user, or per-call payment on the direct endpoint. Network access to the provider's domain over HTTPS.
Before you install
Queries (CEPs, street names, coordinates, activity codes) are sent to the provider. Some tools have daily free limits and paid allowances; purchases happen on the site, and the plugin variant has no payment tool. Company data is matched by CEP, so distances are CEP distances, and address data does not prove a CEP is valid today. The contact tool sends messages to the provider.

Installation

In SourceWeft

  1. Open Pontofato in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.pontofato%2Fpontofato/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

PontoFato — skill and MCP server for AI agents

[PontoFato]

PontoFato gives an AI agent prepared address lookups and geographic joins with Brazilian company records. Query a postal code (CEP), a street or a neighborhood without downloading and indexing both datasets. The service returns IBGE 2022 address coordinates (CNEFE), available census tract context and companies matched by CEP. Census tract figures describe the area, not the occupants of a building. This repository packages the skill and remote MCP connection for Claude Code, Codex, Cursor and other agents.

Site: https://pontofato.com · MCP server: https://pontofato.com/mcp?checkout=site · Prices: https://pontofato.com/pricing · API docs: https://pontofato.com/developers

What your agent can do

  • Look up a CEP: addresses, latitude and longitude, with available census tract context.
  • Search a street by name, in a state or a city, and list the units (apartments, shops) of a building.
  • Find the address nearest to a coordinate and the CEPs within a radius of up to 2 km.
  • List the companies registered at a CEP.
  • Count active, opened and closed companies of an activity (CNAE) around a point, with the latest openings.

Try: "Which restaurants opened near CEP 01310-100 in the last months?" or "Find the coordinates of Avenida Paulista, 1000, São Paulo."

Install

Claude Code, as a plugin with the skill and the MCP server:

/plugin marketplace add wrpbr/pontofato/plugin install pontofato@pontofato

Any agent that reads Agent Skills (Claude Code, Codex, Cursor, OpenCode and others):

bash
npx skills add wrpbr/pontofato

Only the MCP server (remote, Streamable HTTP, no key for the free tools):

bash
claude mcp add --transport http pontofato 'https://pontofato.com/mcp?checkout=site'   # Claude Codecodex mcp add pontofato --url 'https://pontofato.com/mcp?checkout=site'               # Codex
json
{ "mcpServers": { "pontofato": { "url": "https://pontofato.com/mcp?checkout=site" } } }

The JSON above goes in .cursor/mcp.json for Cursor and in the MCP settings of most other clients. In Claude.ai and Claude Desktop, open Settings → Connectors → Add custom connector and paste the server address.

Price

The CEP lookup, the street search, the nearest address, the radius and the companies of a CEP are free and need no key. The company count around a point (vizinhanca) has its own allowance; the API index tells when it is free. The full CNPJ check gives a free allowance each day; after it, the check uses a pack or a plan. CEP lookup stays free. You buy plans and prepaid credit on the site, and plans do not renew automatically. The plugin never pays: with checkout=site, the MCP server has no purchase tool and no payment argument. The agent shows the price and the link, and after your purchase it uses your credit token. The current prices are at https://pontofato.com/pricing.

For an agent authorized to pay, the direct /mcp also exposes existing per-call services without an account. Read /api/pricing and /api/billing first. An x402 quote is in structuredContent; retry with params._meta["x402/payment"] only within the user's budget. The site offers Pix or card only when that method is enabled.

What the plugin sends

The skill tells the agent to call the PontoFato API at pontofato.com. The MCP server also runs at pontofato.com. Your queries (CEPs, street names, coordinates and activity codes) go to pontofato.com over HTTPS. A credit token goes only when you give one for a paid call. The plugin runs no local program and reads no local file.

Data and limits

Addresses come from the IBGE CNEFE of the 2022 Census. They do not prove that a CEP or an address is valid today. Companies come from the public CNPJ dump of Receita Federal and are matched to addresses by CEP, so a company distance is a CEP distance, not the exact building. Check the base date, period and truncation. If lenta is true or a company count is missing, report an incomplete result, not zero companies. That result does not consume the neighborhood allowance or charge credit/x402. Reducing the radius changes the question; do it only when the user's task permits it.

Em português

O PontoFato entrega consultas prontas de endereços e cruzamentos com empresas, sem baixar e indexar as duas bases. O CEP traz os endereços com a coordenada do IBGE (CNEFE 2022), o contexto disponível do setor censitário e as empresas relacionadas por CEP. Os números do setor descrevem a área, não os moradores de um imóvel. O agente também busca rua, acha o endereço mais próximo de um ponto e conta as empresas de uma atividade num raio de até 2 km. Este repositório traz a skill e a conexão com o servidor MCP remoto. Instale com os comandos acima. A consulta de CEP é grátis e não pede chave. A compra é sempre no site, e o plugin nunca paga sozinho. Os preços estão em https://pontofato.com/pricing.

Files

FileWhat it is
skills/pontofato/SKILL.mdThe skill: which tool answers which question, the limits of the data and the rules for paid calls
.mcp.jsonThe remote MCP server of the plugin
.claude-plugin/plugin.jsonThe plugin manifest
.claude-plugin/marketplace.jsonLets Claude Code add this repository as a plugin marketplace
server.jsonThe manifest in the official MCP registry (com.pontofato/pontofato)
glama.jsonThe maintainer for the Glama MCP directory

License and contact

The files in this repository are under the MIT-0 license. The PontoFato service and its data are not part of this license: their use follows the terms of use and the privacy policy. For questions or problems, open an issue here or write to [email protected].

Source: README.md at commit 7ced446

Tools

15

api_index

API index

The API index: each route and how to connect the MCP.

Takes no parameters.

health

Service health

Service availability and the address coverage by state (UF).

Takes no parameters.

cep

Addresses of a 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 an individual or the entire postal code. Income is not current purchasing power. Missing data is unknown; company counts do not measure foot traffic.

Parametersceprequireddetalhe

proximo

Nearest address

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.

Parameterslatrequiredlonrequired

buscar

Find a street

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.

Parametersqrequiredufcidade

unidades

Units at a CEP

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.

Parametersceprequiredlimitnumerooffsetlogradouro

empresas

Companies at a CEP

The companies registered at a CEP, up to 50 per page.

Parametersceprequiredpage

raio

CEPs within a radius

The CEPs within N meters of a point (a CEP, or a latitude and longitude), with the distance and the addresses. Free.

Parametersceplatlonraio

vizinhanca

Companies in a neighborhood

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 unknown, not zero. A result with lenta:true or missing counts does not consume the allowance or charge credit/x402. This does not measure foot traffic, demand or exact storefront positions.

Parametersceplatloncnaeraiodesde

contact

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 seconds per network: one that arrives sooner waits its turn and then goes out — no error. The message reaches the team by e-mail, with `email` as the reply address. For voice, send multipart/form-data: `dados` is this JSON (up to 32 KiB), and `audio` is one WebM, Ogg or M4A audio file (up to 2 MB). Audio can replace message. The browser records up to two minutes. Audio is attached to the owner's e-mail.

Parametersfusonamerequiredpaissitetipoemailrequiredprazoespacoduracaoempresaformatomessagerequired+6 more

sugerir

Suggest a CEP or a street

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.

Parametersqrequiredufcidade

api_access

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? }

Parametersapi_pass

api_access_buy

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 after the free allowance the origin buys these packages from the credit, one at a time.

Parameterspaymentapi_passrequiredtransactioncredit_token

pricing

Pricing

Current public prices, free allowances and payment discovery; does not create a charge.

Takes no parameters.

get_api_x402_cnpj_by_cnpj

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 is not charged.

Parameterscnpjrequiredtemascnia_atual

Version history

2
  1. v1.0.1Oct 15, 2026
  2. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts