acuris-mcp

Acuris Geo MCP Server

あらゆる AI エージェント — Claude、Cursor、ChatGPT、Gemini CLI、およびその他すべての MCP 対応クライアント — に、Acuris の住所検証とジオコーディングへの直接的で自己記述型のアクセスを提供します。240 か国以上に対応し、verified／corrected／部分一致の判定、公式の Royal Mail PAF による英国住所の検証（UDPRN + UPRN）、さらに道路単位で正確に一致した米国／カナダの住所に対する無料の国勢調査・地理情報の補完（国勢調査区、ブロックグループ、FIPS、CBSA/MSA、連邦議会選挙区、学区。カナダの同等の情報も含みます）を利用できます。

このサーバーはAcuris REST API の薄いレイヤーです。各ツールの呼び出しには、お客様ご自身の API キーを使用し、ラップしている API 呼び出しとまったく同じ料金が請求され、返金され、レート制限が適用されます。失敗した検索は自動的に返金されるため、試行ではなく結果に対して料金が発生します。

クイックスタート — ホステッドエンドポイント（推奨、インストール不要）

Claude Code

claude mcp add --transport http acuris-geo https://api.acuris-geo.com/mcp \
  --header "Authorization: Bearer YOUR_ACURIS_API_KEY"

Claude Desktop／JSON 設定に対応した任意のクライアント

{
  "mcpServers": {
    "acuris-geo": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" }
    }
  }
}

Cursor（.cursor/mcp.json）

{ "mcpServers": { "acuris-geo": {
    "url": "https://api.acuris-geo.com/mcp",
    "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" } } } }

API キーをまだお持ちでない場合は、キーなしで接続し、メールアドレスを指定して request_trial_key ツールを呼び出してください。すぐに無料トライアルキーを取得できます（100 クレジット、7 日間、クレジットカード不要、登録フォーム不要）。その後、キーを使って再接続してください。

ツール

ツール	内容	料金
validate_address	住所を 1 件検証して標準化します（240 か国以上に対応。英国では Royal Mail PAF を使用し、UDPRN + UPRN を取得）。道路単位で正確に一致した米国／カナダの住所には、無料の国勢調査情報の補完ブロックが含まれます。	1 クレジット
validate_addresses_batch	1 回の呼び出しで最大 50 件の住所を処理し、国が混在していても対応します。結果は入力順で返されます。	1 行あたり 1 クレジット
enrich_us_ca_address	住所から、国勢調査区、ブロックグループ、郡／州 FIPS、CBSA/MSA、連邦議会選挙区、学区（米国）、または国勢調査細分区域、国勢調査区域、CMA/CA、連邦選挙区（カナダ）を取得します。	1 クレジット（情報補完は無料）
geocode_address	すべての結果に明示的な accuracy_type を含むフォワードジオコーディングを行います。	1 クレジット
reverse_geocode	座標から、距離情報付きで最寄りの住所を取得します。	1 クレジット
expand_uk_postcode	英国の郵便番号から、Royal Mail のすべての配達先を取得します（組織名、UDPRN、UPRN、建物屋上の座標）。	郵便番号 1 件あたり 1 クレジット
check_balance	接続中のキーの残りのクレジット残高を確認します。	無料
request_trial_key	メールアドレスで無料トライアルキーを即時取得します（24 時間は冪等）。	無料

一致する結果がない場合やエラーの場合は、自動的に返金されます。

ローカル（stdio）モード

pip install acuris-mcp        # or: uvx acuris-mcp --stdio
ACURIS_API_KEY=YOUR_KEY acuris-mcp --stdio

Claude Desktop の stdio 設定：

{
  "mcpServers": {
    "acuris-geo": {
      "command": "uvx",
      "args": ["acuris-mcp", "--stdio"],
      "env": { "ACURIS_API_KEY": "YOUR_KEY" }
    }
  }
}

ツールも料金体系も同じです。ホステッドエンドポイントはインストール不要で、常に最新の状態を利用できるため、推奨されます。

ドキュメントとリンク

• MCP ドキュメント全文：https://api.acuris-geo.com/docs/mcp
• REST API リファレンス：https://api.acuris-geo.com/docs
• 料金：https://www.acuris-geo.com/acuris-pricing/
• 米国／カナダの情報補完：https://www.acuris-geo.com/us-canada-address-enrichment/
• Excel アドイン（同じエンジン、コード不要）：https://www.acuris-geo.com/excel-add-in/

ライセンス

MIT（このコネクター）。Acuris API 自体は商用サービスです。詳細は利用規約をご覧ください。