permits

AddressIntel MCP サーバー

Model Context Protocol の読み取り専用サーバーです。サンフランシスコ半島の建築許可および区画の建築可能性に関するデータを、Claude、ChatGPT、その他の MCP 対応エージェントで利用できます。

公開されている AddressIntel API を利用する薄いクライアントであるため、API の認証、レート制限、プランごとの上限が適用されます。すべてのツールは GET を使用します。書き込み操作は一切できません。

ツール

ツール	回答できる質問
search_permits	住所または市内で、実際にどのような建築が許可されたか。市、キーワード（住所、プロジェクトの種類、工事内容の説明、施工業者、建築家、許可番号）、最低評価額で絞り込めます。
list_sb9_inventory	SB 9 に基づいて分割または二戸化できる販売中物件と、それができない物件の制約は何か。
list_adu_leads	ADU を建築できる余地がある区画と、建築可能な戸数／床面積はどれくらいか。
list_redevelopment_leads	許容される建築可能範囲に対して未開発の区画（解体・再建または増築）はどれか。
list_market_signals	解体または転売の可能性が最も高い物件はどれか。
get_property_intelligence	1 件の物件 ID の詳細なスコアと類似物件の販売情報。

建築許可と区画に関するツールが、このサーバーの独自性を支える部分です。全米の所有者リストではなく、半島地域の建築許可レベルの詳細情報と区画レベルの建築可能性を提供します。

インストール

インストール手順はありません。npx が必要に応じて取得します。

Claude Code

claude mcp add addressintel \
  -e ADDRESSINTEL_API_KEY=your_key \
  -- npx -y addressintel-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "addressintel": {
      "command": "npx",
      "args": ["-y", "addressintel-mcp"],
      "env": {
        "ADDRESSINTEL_API_KEY": "your_key"
      }
    }
  }
}

ソースから実行

サーバー自体を開発する場合：

git clone https://github.com/RantumBits/addressintel-mcp.git
cd addressintel-mcp
npm install
npm run build     # emits dist/index.js

次に、上記の npx コマンドの代わりに、クライアントの接続先を node /absolute/path/to/addressintel-mcp/dist/index.js に設定します。

クライアントを再起動し、「今年、Menlo Park でどのような解体許可が発行されましたか？」 や 「Palo Alto で SB 9 の対象となる販売物件はどれですか？」 といった質問をしてみてください。

設定

変数	デフォルト	備考
ADDRESSINTEL_API_KEY	demo	キーがない場合、サーバーは公開デモプランを使用します。1 分あたり 10 件のリクエスト、1 回あたり 5 行までです。https://addressintel.co/developers で無料キーを取得すると、1 分あたり 30 件、1 回あたり 25 行まで利用できます。キーは入力したメールアドレスに送信されます。
ADDRESSINTEL_API_BASE	https://addressintel.co/api	API の開発時は、ローカルの開発サーバー（http://localhost:3000/api）を指定します。

開発

npm run dev       # run from source over stdio
node test_mcp.mjs # smoke test: connect, list tools, call one

ツールは src/index.ts の 1 つのテーブルで宣言されています。各エントリーには zod スキーマと、公開する JSON Schema が並べて記述されているため、ツールを追加する際はエントリーを 1 つ追加するだけで済み、両者の形式にずれが生じることもありません。