1acre Land Intelligence

1acre MCP

1acre.in の公式 MCP（Model Context Protocol）サーバーです。1acre は、検証済みの土地を取り扱うインドのマーケットプレイスです。Claude Code、Cursor、Claude Desktop、または MCP 互換のクライアントを接続すると、1acre アカウントに代わって地番を調べたり、地籍データを閲覧したり、土地インテリジェンスレポートを生成したりできます。

このリポジトリには、クライアント側の設定とドキュメントが含まれています — 接続方法について説明しています。サーバー自体は https://mcp.1acre.in で稼働しています。

---

できること

接続すると、MCP クライアントから、サインイン中の 1acre ユーザーとして次のツールを呼び出せます。

ツール	費用	説明
get_token_balance	無料	トークン残高、利用可能なティア別上限、有料ツールごとの費用を確認します
browse_locations	無料	地域階層（州 → 地区 → マンダル → 村）をたどります
list_survey_numbers	無料	指定した村に存在する地番の一覧を取得します
list_available_layers	無料	緯度・経度をカバーする地図レイヤー（マスタープラン、エアファンネル、高速道路、地下鉄など）を確認します。メタデータのみです
get_survey_number_report	無料	ID を指定して、以前に生成したレポートを再度開きます。トークンは消費しません
get_report_coordinates	無料	以前に生成したレポートの GeoJSON 境界座標を取得します
create_sell_listing_intent	無料	「土地を売りたい」という問い合わせを受け付けます。1acre の掲載チームへの、入力済みの WhatsApp リンクを返します
get_layer_info	レイヤーごとに 5 トークン	有料地図レイヤー内の緯度・経度地点におけるフィーチャー属性（ゾーン、許容高さ、回廊までの距離）を取得します。該当データがない場合は無料です
list_lands_in_region	ページごとに 1 トークン	緯度・経度地点を中心とする半径内の、検証済み 1acre 土地物件を最大 10 件取得します（ページごと）。結果が空のページは無料です
create_survey_number_report	10 トークン	特定の地番について、土地インテリジェンスレポートを作成します
identify_parcel_at_point	10 トークン	緯度・経度座標地点の地籍区画を特定し、そのレポートを作成します

有料ツールは、「1a」トークン残高からトークンを消費します。無料ツールは費用がかかりません。レポートを作成した後は、追加のトークンを消費せずに、何度でも再度開いて境界座標を取得できます。

最初に get_token_balance を呼び出して（無料）、現在の残高とツールごとの最新価格を確認してください。残高を超過する実行は insufficient_tokens エラーで失敗しますが、復旧可能です。1acre の My Tokens ページでチャージしてから、再試行してください。

ここでいう「トークン」は、1acre の土地インテリジェンス用クレジットを指します。MCP クライアントがサインイン用に管理する OAuth アクセストークンとは関係ありません。

---

クイックスタート — Claude Code

claude mcp add --scope user --transport http 1acre https://mcp.1acre.in/mcp \
  --callback-port 8118 \
  --client-id eKg8BebDnd09zxwy

続いて、Claude Code で次の操作を行います。

1. /mcp と入力すると、1acre に Needs authentication と表示されます
2. Sign In をクリックします
3. ブラウザーで 1acre のサインインページが開きます（電話番号）
4. 電話番号を入力 → SMS で OTP を受信 → コードを入力します
5. 同意画面で Allow をクリックします
6. 1acre が ✓ Connected に切り替わります

これで、土地に関する質問を Claude に尋ねられます。例：「1acre のトークンはあといくつありますか？」、「Telangana にはどんな地区がありますか？」 など。

---

クイックスタート — Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）またはお使いの OS の同等のパスに追加します。

{
  "mcpServers": {
    "1acre": {
      "url": "https://mcp.1acre.in/mcp",
      "transport": "http",
      "oauth": {
        "clientId": "eKg8BebDnd09zxwy",
        "callbackPort": 8118
      }
    }
  }
}

Claude Desktop を再起動します。MCP サーバーダイアログからサインインしてください。

---

クイックスタート — Cursor

Cursor の MCP 設定は ~/.cursor/mcp.json にあります。次の内容を追加します。

{
  "mcpServers": {
    "1acre": {
      "url": "https://mcp.1acre.in/mcp"
    }
  }
}

Cursor は、最初のツール呼び出し時に認証を求めます。

詳細な例については、examples/ を参照してください。

---

認証

1acre MCP は OAuth 2.1 with PKCE を使用します。電話番号を使ってサインインし、SMS で一度限りの確認コードを受け取ります（セキュリティが確保されており、インドの電話番号については DLT に準拠しています）。

• 電話番号がユーザー ID になります。
• 先に 1acre.in アカウントを作成してください — 使用する電話番号で 1acre.in に登録してください。MCP は電話番号を照合して、Clerk の ID を該当するアカウントに紐付けます。
• セッションは認証サーバーが管理し、MCP クライアントがトークンを自動更新します。

---

OAuth クライアントの登録

ほとんどのクライアントは自動で登録されます。 1acre の OAuth プロバイダーは、https://clerk.1acre.in/oauth/register で RFC 7591 Dynamic Client Registration をサポートしています。DCR に対応した MCP クライアント（Claude Code、Smithery など）は、.well-known/oauth-authorization-server からこの機能を検出し、初回接続時に自動で登録します。特別な操作は不要です。上記のクイックスタートにある --client-id フラグが必要なのは、クライアントが DCR に対応していない場合のみです。

手動登録（クライアントが DCR に対応していない場合のみ）

以下の情報を [email protected] までご連絡ください。

1. MCP クライアント名（例：「Internal agent X」）
2. クライアントが使用する正確なコールバック URL

client_id をお送りします（公開情報のため、コミットしても安全です。PKCE のみで、クライアントシークレットはありません）。

---

利用可能なエンドポイント

• MCP エンドポイント： https://mcp.1acre.in/mcp
• ディスカバリー： https://mcp.1acre.in/.well-known/oauth-protected-resource
• ヘルスチェック： https://mcp.1acre.in/healthz

---

コストと制限

• 無料ツール（残高の確認、ディスカバリー、階層の参照、調査番号の一覧表示、売却リスティングの意図、レポートの再読み込み、座標の取得）：無制限
• 有料ツール：
  • get_layer_info — フィーチャーを返すレイヤーごとに 5 トークン（見つからない場合は無料）
  • list_lands_in_region — 空でないページごとに 1 トークン（1 ページあたり 10 件のリスティング。空のページは無料）
  • create_survey_number_report — レポートごとに 10 トークン
  • identify_parcel_at_point — 実行ごとに 10 トークン
• レート制限：OAuth アクセストークンごとに毎分 60 リクエスト

アカウントのティアごとのトークン割り当て：

ティア	割り当て
非プレミアム（通常、無料トライアル、プレミアム期限切れ）	100 トークン
プレミアム — 四半期プラン	500 トークン
プレミアム — 年間プラン	2,000 トークン

トークンの有効期限は付与から 365 日後です。これは残高であり、生涯にわたる割り当てではありません。購入した追加トークンパックはティアの割り当てに加算されるため、上記の数値を超える残高があっても問題ありません。実際に使用可能な残高は、常に get_token_balance を正として確認してください。

上限の引き上げについては、[email protected] までお問い合わせください。

---

サポート

• イシュー：github.com/1acre-in/1acre-mcp/issues
• メール：[email protected]

---

ライセンス

MIT — LICENSE を参照してください。

サーバーコードはオープンソースではありません。このリポジトリには、クライアント側の設定とドキュメントのみが含まれています。