1acre Land Intelligence MCP server

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:

Paid tools spend from your "1a" token balance. Free tools cost nothing — once a report exists, you can re-open it and pull its boundary coordinates as often as you like without spending another token.

Call gettokenbalance first (it's free) to see your live balance and the current per-tool price. A run that would overdraw fails with insufficienttokens and is recoverable — top up from the My Tokens** page on 1acre and retry.

"Tokens" here means 1acre land-intelligence credits — unrelated to the OAuth access tokens your MCP client manages for sign-in.

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 1acre tokens do I have left?", "What districts does Telangana have?", etc.

Quick start — Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.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

Shortened. The full README is on GitHub.