Pontofato
概览
作者提供的说明(英文原文)
Brazilian addresses for agents: IBGE-geocoded CEP points, radius search and companies by CEP.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i3 项中通过 3 项依据公开信息检查;尚未扫描代码
- 使用情况i非常新★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: Streamable HTTP
- 分类: 搜索与 AI 记忆
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:3 项中通过 3 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 可以做 23 件事(工具) api_index, health, cep, proximo …
- 注册中心没有列出需要填写的密钥。
你需要
- 在云端运行无需安装任何东西,通过互联网连接
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
- 打开 Settings → Connectors
- 点击 Add custom connector
- 粘贴下面的地址,然后点击 Add
- 如果要求登录,请登录作者的服务
https://pontofato.com/mcp在终端中运行这条命令
claude mcp add --transport http pontofato https://pontofato.com/mcp或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"pontofato": {
"url": "https://pontofato.com/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"pontofato": {
"type": "http",
"url": "https://pontofato.com/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
- 打开网页版 ChatGPT → Settings → Connectors (Apps)
- 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
- 粘贴下面的地址,起个名字,然后保存
- 如果要求登录,请登录作者的服务
https://pontofato.com/mcp菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
工具名称和描述与服务器在 2026年11月8日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
api_indexThe API index: each route and how to connect the MCP.
healthService availability and the address coverage by state (UF).
cepThe addresses of a CEP (Brazilian postal code), with latitude and longitude. 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
proximoThe 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.
buscarFinds 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.
unidadesThe 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.
empresasThe companies registered at a CEP, up to 50 per page.
raioThe CEPs within N meters of a point (a CEP, or a latitude and longitude), with the distance and the addresses. Free.
vizinhancaThe 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
contactWrite 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 p
consulta_cadastroName, status, activity and address of a Brazilian company by CNPJ. It does not count against the daily free limit, does not show contacts or partners and runs no extra checks. The origin's protection limit still applies. For sanctions, tax status and a live CNIA check, use consul
consulta_enderecoAddresses and companies at a CEP (Brazilian postal code), without counting against the daily free limit. Up to 20 addresses and 20 companies; `pontos_total` has the total number of addresses. The origin's protection limit still applies.
consulta_sugerirSuggests up to 8 Brazilian companies for a CNPJ, company name, partner, phone or e-mail, ordered by how well they match. It does not count against the daily free limit and does not show contacts. `incompleto` means one of the sources did not answer.
consulta_cnpjAdditional CNPJ lookup with prepared public records and an attempted CNIA source check during the request. Set cnia_atual=true when that check is required: source failure returns 503 without charging or using a previous record. Without this requirement, the last stored CNIA may b
consulta_cepAddresses at a CEP (Brazilian postal code) with coordinates (CNEFE/IBGE) and the companies registered there. Returns up to 20 addresses and up to 20 companies; the total number of addresses is in `pontos_total`. Free: it uses no daily allowance or balance.
consulta_planosThe CNPJ and address lookup service: today's free allowance, the single package, the three plans and your balance. Without a credential, it shows the free allowance and the offers. With an account, credit (`X-Credito`) or an x402 wallet (`X-Wallet-Token`), it also shows the balan
consulta_comprarBuys the single package or one of the three plans, with credit or x402, also without an account. Without payment, it returns 402 with the price in dollars and reais. The body uses x402 v1; PAYMENT-REQUIRED uses v2. With an account or credit, the balance stays with that holder. Wi
sugerirSuggestions 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
api_accessDiscover 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?,
api_access_buyBuy 1000 basic data reads for US$1, 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 pr
pricingCurrent prices and free allowances. Returns: { product, quota{free,paid,how_to_pay,live,free_now?,charged_now?,trial?}, pricing, billing, api_index }
billingPublic discovery of payment and prepaid credit. Returns: { product, quota{free,paid,how_to_pay,live,free_now?,charged_now?,trial?}, pricing, billing, api_index, payment{provider,mode,network,chain_id,pay_to,homolog,dev,dev_gate,alternavel,gratis?,cobrados?,facilitator,asset,asset
get_api_x402_cnpj_by_cnpjCNPJ 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 pa
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月9日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 pontofato.com 验证(注册中心会核实域名所有权)
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 585 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 23 个工具描述,未发现针对 AI 的隐藏指令
与“搜索与 AI 记忆”中的其他服务器比较i
- 星标数多于此分类中其他 5787 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 5787 个服务器的 60% 更新
- 基础检查结果等于或优于此分类中其他 5787 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Pontofato 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于–,最新版本(1.0.1)于26天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:Context7, Codebase Memory, Exa
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
PontoFato — skill and MCP server for AI agents
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):
npx skills add wrpbr/pontofato
Only the MCP server (remote, Streamable HTTP, no key for the free tools):
claude mcp add --transport http pontofato 'https://pontofato.com/mcp?checkout=site' # Claude Code
codex mcp add pontofato --url 'https://pontofato.com/mcp?checkout=site' # Codex
{ "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
| File | What it is |
|---|---|
skills/pontofato/SKILL.md | The skill: which tool answers which question, the limits of the data and the rules for paid calls |
.mcp.json | The remote MCP server of the plugin |
.claude-plugin/plugin.json | The plugin manifest |
.claude-plugin/marketplace.json | Lets Claude Code add this repository as a plugin marketplace |
server.json | The manifest in the official MCP registry (com.pontofato/pontofato) |
glama.json | The 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 contato@pontofato.com.