1acre MCP

1acre.in 的官方 MCP（模型上下文协议）服务器——印度经过验证的土地市场。连接 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 失败，并且是可恢复的——从 1acre 的 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. 输入您的手机号码 → 通过短信接收 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 使用 带 PKCE 的 OAuth 2.1。登录基于手机号码，通过一次性短信验证（安全，符合印度手机号码的 DLT 合规要求）。

• 您的手机号码即您的身份。

• 您必须首先拥有 1acre.in 账户——使用您计划使用的手机号码在 1acre.in 注册。MCP 通过匹配手机号码将您的 Clerk 身份解析到该账户。

• 会话由认证服务器管理；您的 MCP 客户端会自动刷新令牌。

注册 OAuth 客户端

大多数客户端会自动注册。 1acre 的 OAuth 提供商支持在 https://clerk.1acre.in/oauth/register 进行 RFC 7591 动态客户端注册——支持 DCR 的 MCP 客户端（Claude Code、Smithery 等）会从 .well-known/oauth-authorization-server 发现此信息并在首次连接时自行注册。您无需做任何操作，上面快速开始中的 --client-id 参数仅在您的客户端不支持 DCR 时才需要。

联系 hello@1acre.in，并提供：

1. 您的 MCP 客户端名称（例如"内部代理 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

费用与限制

• 免费工具（浏览、列表、余额检查）：无限制

• 付费工具（报告生成、地块识别）：每次运行 10 个代币

• 速率限制：每个 OAuth 访问令牌每分钟 60 次请求

按账户层级划分的代币配额：

代币在入账 365 天后过期——这是一个余额，而非终身配额。购买的充值包会叠加在您的层级配额之上，因此余额高于上述数字是正常的。get_token_balance 始终是实际可支出金额的权威来源。

如需更高限额，请联系 hello@1acre.in。

支持

• 问题反馈：github.com/1acre-in/1acre-mcp/issues

• 邮箱：hello@1acre.in

许可证

MIT——请参阅 LICENSE。

服务器代码不是开源的；本仓库仅涵盖客户端配置和文档。