1acre Land Intelligence

1acre MCP

1acre.in 的官方 MCP（Model Context Protocol）服务——印度经过验证的土地交易市场。连接 Claude Code、Cursor、Claude Desktop 或任何兼容 MCP 的客户端，即可代表你的 1acre 账户查询地块编号、浏览地籍数据并生成土地情报报告。

此代码库包含客户端配置和文档——介绍如何连接。服务本身运行于 https://mcp.1acre.in。

---

你可以做什么

连接后，任何 MCP 客户端都可以以已登录的 1acre 用户身份调用以下工具：

工具	费用	说明
get_token_balance	免费	查看你的令牌余额、套餐额度，以及每项付费工具的费用
browse_locations	免费	浏览地理位置层级（州 → 区 → mandal → 村庄）
list_survey_numbers	免费	列出指定村庄中存在的地块编号
list_available_layers	免费	查找覆盖某个纬度/经度的地图图层（总体规划、空中通道、快速路、地铁等）——仅提供元数据
get_survey_number_report	免费	按 ID 重新打开之前生成的报告——不消耗令牌
get_report_coordinates	免费	获取之前生成的报告中的 GeoJSON 边界坐标
create_sell_listing_intent	免费	收集“出售我的土地”信息——返回一个预填好的 WhatsApp 链接，指向 1acre 房源团队
get_layer_info	每个图层 5 个令牌	获取付费地图图层中某个纬度/经度位置的要素属性（区域、允许高度、距走廊的距离）。未命中不收费。
list_lands_in_region	每页 1 个令牌	列出某个纬度/经度指定半径内最多 10 个经过验证的 1acre 土地房源（按页计费）。空页面不收费。
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. 输入手机号 → 通过短信接收 OTP → 输入验证码
5. 在授权页面点击 Allow
6. 1acre 状态变为 ✓ Connected

现在可以向 Claude 询问任何与土地相关的问题：“我还剩多少个 1acre 令牌？”、“Telangana 有哪些区？” 等等。

---

快速开始 — Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或你所用操作系统上的对应路径：

{
  "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 和 PKCE。登录时通过手机号进行，并使用一次性短信验证码（安全，符合印度手机号的 DLT 规范）。

• 你的手机号将作为你的身份标识。
• 你必须先拥有 1acre.in 账户——使用你计划用于 MCP 的手机号在 1acre.in 注册。MCP 会通过匹配手机号，将你的 Clerk 身份关联到该账户。
• 会话由身份验证服务管理；MCP 客户端会自动刷新令牌。

---

注册 OAuth 客户端

大多数客户端会自动注册。 1acre 的 OAuth 提供方支持 RFC 7591 动态客户端注册，地址为 https://clerk.1acre.in/oauth/register。支持 DCR 的 MCP 客户端（Claude Code、Smithery 等）会从 .well-known/oauth-authorization-server 发现此功能，并在首次连接时自行注册。你无需执行任何操作；只有当客户端不支持 DCR 时，才需要使用上方快速入门中的 --client-id 标志。

手动注册（仅当客户端不支持 DCR 时）

请发送邮件至 [email protected]，并提供：

1. MCP 客户端名称（例如“内部 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 个代币（每页 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。

服务端代码并非开源；此仓库仅包含客户端配置和文档。