1acre MCP

1acre.in（インドの認証済み土地マーケットプレイス）公式のMCP（Model Context Protocol）サーバーです。Claude Code、Cursor、Claude Desktop、またはMCP対応の任意のクライアントを接続して、地番の検索、地籍データの閲覧、土地インテリジェンスレポートの生成を1acreアカウントに代わって実行できます。

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

できること

接続後、MCP対応クライアントはサインイン済みの1acreユーザーとして以下のツールを呼び出せます：

有料ツールは**「1a」トークン残高から消費されます：create_survey_number_report と identify_parcel_at_point は実行ごとに10トークン**かかります。無料ツールはコストなし — レポートが存在すれば、トークンを追加消費せずに何度でも再表示したり境界座標を取得したりできます。

まず get_token_balance（無料）を呼び出して、現在の残高とツールごとの最新価格を確認してください。残高不足で実行に失敗した場合は insufficient_tokens エラーが返り、My Tokens ページでチャージすれば再試行できます。

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

Related MCP server: mcp-rosreestr

クイックスタート — 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のトークン残高は？"、"テランガーナ州にはどの地区がある？" など。

クイックスタート — 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非対応のクライアントでのみ必要です。

hello@1acre.in まで以下を連絡してください：

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

コストと制限

• 無料ツール（browse、list、balance確認）：無制限

• 有料ツール（レポート生成、区画特定）：実行ごとに10トークン

• レート制限：OAuthアクセストークンあたり毎分60リクエスト

アカウントティア別のトークン付与量：

トークンは付与から365日で失効します — 無期限ではなく残高方式です。購入したチャージパックはティア付与量の上に積み増しされるため、上記の数値より残高が多くなるのは正常です。実際の利用可能額は常に get_token_balance が正となります。

より高い上限が必要な場合は hello@1acre.in までお問い合わせください。

サポート

• 問題報告： github.com/1acre-in/1acre-mcp/issues

• メール： hello@1acre.in

ライセンス

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

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