pontofato

PontoFato — AI エージェント向けスキルと MCP サーバー

PontoFato を使うと、AI エージェントはブラジルの住所とその周辺の企業を見つけられます。郵便番号（CEP）を指定すると、IBGE 2022 年国勢調査（CNEFE）の座標、建物ごとの国勢調査区データ、その建物に登録されている企業とともに住所が返されます。エージェントは、通りを検索したり、地点に最も近い住所を探したり、半径 2 km 以内にある特定の業種の企業数を数えたりすることもできます。このリポジトリには、PontoFato のスキルと、Claude Code、Codex、Cursor などのエージェントからリモート MCP サーバーに接続するための機能が含まれています。

サイト： https://pontofato.com · MCP サーバー： https://pontofato.com/mcp?checkout=site · 料金： https://pontofato.com/pricing · API ドキュメント： https://pontofato.com/developers

エージェントでできること

• CEP を調べて、住所、緯度と経度、各建物の国勢調査区データ（人口、住宅、所得）を確認できます。
• 州または市を指定して通りの名前を検索し、建物の区画（アパート、店舗）を一覧表示できます。
• 座標に最も近い住所を見つけ、最大 2 km の範囲内にある CEP を検索できます。
• CEP に登録されている企業を一覧表示できます。
• 地点の周辺にある特定の業種（CNAE）の営業中、開業済み、閉業済みの企業数を、最近の開業情報とともに確認できます。

例：「CEP 01310-100 の近くでここ数か月に開業したレストランは？」 または 「サンパウロの Avenida Paulista, 1000 の座標を調べて。」

インストール

Claude Code の場合、スキルと MCP サーバーを含むプラグインとしてインストールします。

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

Agent Skills を読み込めるエージェント（Claude Code、Codex、Cursor、OpenCode など）の場合：

npx skills add wrpbr/pontofato

MCP サーバーのみの場合（リモート、Streamable HTTP、無料ツールはキー不要）：

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

上記の JSON は、Cursor では .cursor/mcp.json に、その他のほとんどのクライアントでは MCP の設定に記述します。Claude.ai と Claude Desktop では、［Settings］→［Connectors］→［Add custom connector］を開き、サーバーアドレスを貼り付けます。

料金

CEP の検索、通りの検索、最寄りの住所、範囲検索、CEP に登録されている企業の検索は無料で、キーも不要です。地点周辺の企業数（vizinhanca）には独自の利用枠があり、API インデックスに無料で利用できる条件が記載されています。CNPJ と住所の完全な照合には毎日の無料利用枠があり、その上限を超えると、パックまたはプランを利用します。プランとプリペイドクレジットはサイトで購入でき、プランは自動更新されません。プラグインが支払いを行うことはありません。checkout=site の場合、MCP サーバーには購入ツールも支払い引数もありません。エージェントが料金とリンクを表示し、購入後はクレジットトークンを使用します。最新の料金は https://pontofato.com/pricing に掲載されています。

プラグインが送信するデータ

スキルは、エージェントに pontofato.com の PontoFato API を呼び出すよう指示します。MCP サーバーも pontofato.com で動作します。検索内容（CEP、通りの名前、座標、業種コード）は HTTPS 経由で pontofato.com に送信されます。有料の呼び出しでクレジットトークンを指定した場合にのみ、そのトークンが送信されます。プラグインはローカルプログラムを実行せず、ローカルファイルも読み取りません。

データと制限

住所データは、IBGE の 2022 年国勢調査 CNEFE に基づいています。CEP や住所が現在有効であることを証明するものではありません。企業データは、ブラジル連邦歳入庁の公開 CNPJ ダンプに基づき、CEP を使って住所と照合されます。そのため、企業までの距離は建物までの正確な距離ではなく、CEP 間の距離です。

ポルトガル語で

O PontoFato deixa o agente de IA achar endereços brasileiros e as empresas em volta. O CEP traz os endereços com a coordenada do IBGE (CNEFE 2022), os dados do setor do Censo de cada prédio e as empresas registradas nele. 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.

ファイル

ファイル	内容
skills/pontofato/SKILL.md	スキル：どのツールがどの質問に答えるか、データの制限事項、有料呼び出しに関するルール
.mcp.json	プラグインのリモート MCP サーバー
.claude-plugin/plugin.json	プラグインのマニフェスト
.claude-plugin/marketplace.json	Claude Code でこのリポジトリをプラグインマーケットプレイスとして追加できるようにします
server.json	公式 MCP レジストリ（com.pontofato/pontofato）のマニフェスト
glama.json	Glama MCP ディレクトリ向けのメンテナーファイル

ライセンスとお問い合わせ

このリポジトリ内のファイルは MIT-0 ライセンスの下で公開されています。PontoFato サービスとそのデータはこの ライセンスの対象外です。これらの利用には、利用規約と プライバシーポリシーが適用されます。ご質問や問題がある場合は、こちらでイシューを作成するか、 [email protected] までご連絡ください。