1acre MCP

The official MCP (Model Context Protocol) server for 1acre.in — India's verified land marketplace. Connect Claude Code, Cursor, Claude Desktop, or any MCP-compatible client to look up survey numbers, browse cadastral data, and generate land-intelligence reports on behalf of your 1acre account.

This repository contains the client-side configuration and documentation — how to connect. The server itself runs at https://mcp.1acre.in.

What you can do

Once connected, any MCP client can call these tools as the signed-in 1acre user:

Regular 1acre accounts get 3 lifetime lookups. create_survey_number_report and identify_parcel_at_point permanently consume one each. Free tools have no cost.

Related MCP server: mcp-rosreestr

Quick start — Claude Code

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

Then in Claude Code:

1. Type /mcp — you'll see 1acre with Needs authentication

2. Click Sign In

3. Browser opens 1acre's sign-in page (phone number)

4. Enter your phone number → receive OTP via SMS → enter code

5. Consent screen → Allow

6. 1acre flips to ✓ Connected

Now ask Claude anything land-related: "How many survey lookups do I have left?", "What districts does Telangana have?", etc.

Quick start — Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on your OS:

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

Restart Claude Desktop. Sign in via the MCP servers dialog.

Quick start — Cursor

Cursor's MCP config lives at ~/.cursor/mcp.json. Add:

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

Cursor prompts you to authenticate on first tool call.

More detailed examples in examples/.

Authentication

1acre MCP uses OAuth 2.1 with PKCE. Sign-in is phone-number-based via one-time SMS verification (secure, DLT-compliant for Indian phone numbers).

• Your phone number becomes your identity.

• You must have a 1acre.in account first — sign up at 1acre.in with the phone number you plan to use. MCP resolves your Clerk identity to that Account by matching the phone.

• Sessions are managed by the auth server; your MCP client refreshes tokens automatically.

Registering an OAuth client

The client_id you use in the config comes from 1acre's OAuth provider. To request one, contact hello@1acre.co with:

1. Your MCP client name (e.g. "Claude Code", "Cursor", "Internal agent X")

2. The exact callback URL your client will use (e.g. http://localhost:8118/callback for Claude Code)

You'll receive a client_id (public — safe to commit; PKCE-only, no client secret).

Available at

• MCP endpoint: https://mcp.1acre.in/mcp

• Discovery: https://mcp.1acre.in/.well-known/oauth-protected-resource

• Health: https://mcp.1acre.in/healthz

Costs & limits

• Free tools (browse, list, quota check): unlimited

• Paid tools (report generation, parcel identification): 3 lifetime lookups per regular account

• Rate limits: 60 requests/minute per token

For higher limits, contact hello@1acre.co.

Support

• Issues: github.com/1acre-in/1acre-mcp/issues

• Email: hello@1acre.co

License

MIT — see LICENSE.

Server code is not open source; this repo covers client-side configuration and documentation only.