Pontofato

com.pontofato由 pontofato.com 發布官方發布者v1.1.0更新於 Nov 11, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

面向巴西地址的遠端 MCP 伺服器:CEP 查詢含 IBGE 座標、街道搜尋、半徑查詢,以及依 CEP 或 CNPJ 查詢企業。

可以做什麼
  • 查詢 CEP,取得地址、經緯度與可用的人口普查區背景,以及該處的單元與企業
  • 依街道名、街區、州或城市搜尋街道,並為不完整 CEP 或街道名提供建議
  • 找出距離某座標最近的地址,並列出半徑 2 公里內的 CEP
  • 依 CNAE 統計某點周邊的活躍、新開與關閉企業,並列出近期開業
  • 依 CNPJ 查詢企業,含特殊狀態、制裁與合夥人,並依名稱、合夥人、電話或電子郵件推薦企業
  • 讀取 API 索引、服務健康狀態與各州地址涵蓋情形,並可送出詢問或合作提案
適用情境
當助理需要巴西地址或企業資料、又不想自行下載並索引 CNEFE 與聯邦稅務局資料集時適用,例如為 CEP 做地理編碼、尋找某點附近的企業,或查核 CNPJ 紀錄。
執行需求
需要遠端 Streamable HTTP 端點;免費工具不需本機執行環境、套件或金鑰。付費呼叫使用使用者提供的額度權杖,或在直連端點上按次付費。需透過 HTTPS 連線至服務商網域。
安裝前請注意
查詢內容(CEP、街道名、座標、活動代碼)會傳送給服務商。部分工具有每日免費額度與付費額度;購買在網站完成,外掛版本不含付款工具。企業資料依 CEP 比對,因此距離是 CEP 距離;地址資料不能證明 CEP 目前有效。聯絡工具會向服務商送出訊息。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Pontofato,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.pontofato%2Fpontofato/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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].

來源:README.md,提交 7ced446

工具

15

api_index

API index

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

無需輸入參數。

health

Service health

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

無需輸入參數。

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.

輸入參數cep必填detalhe

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.

輸入參數lat必填lon必填

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.

輸入參數q必填ufcidade

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.

輸入參數cep必填limitnumerooffsetlogradouro

empresas

Companies at a CEP

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

輸入參數cep必填page

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.

輸入參數ceplatlonraio

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.

輸入參數ceplatloncnaeraiodesde

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.

輸入參數fusoname必填paissitetipoemail必填prazoespacoduracaoempresaformatomessage必填另有 6 個

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.

輸入參數q必填ufcidade

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

輸入參數api_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.

輸入參數paymentapi_pass必填transactioncredit_token

pricing

Pricing

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

無需輸入參數。

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.

輸入參數cnpj必填temascnia_atual

版本歷史

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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分