{
  "markdown": "# 1acre MCP\n\nThe official MCP (Model Context Protocol) server for [1acre.in](https://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.\n\n> **This repository contains the client-side configuration and documentation** — how to connect. The server itself runs at `https://mcp.1acre.in`.\n\n---\n\n## What you can do\n\nOnce connected, any MCP client can call these tools as the signed-in 1acre user:\n\n| Tool | Cost | Description |\n|---|---|---|\n| `get_token_balance` | Free | Check your token balance, tier allowance, and what each paid tool costs |\n| `browse_locations` | Free | Walk the location hierarchy (state → district → mandal → village) |\n| `list_survey_numbers` | Free | List survey numbers that exist in a given village |\n| `list_available_layers` | Free | Discover which map layers (Master Plan, air-funnels, expressways, metro, etc.) cover a lat/lng — metadata only |\n| `get_survey_number_report` | Free | Re-open a previously generated report by ID — no tokens spent |\n| `get_report_coordinates` | Free | Get GeoJSON boundary coordinates for a previously generated report |\n| `create_sell_listing_intent` | Free | Capture a \"sell my land\" intake — returns a pre-filled WhatsApp link to the 1acre listings team |\n| `get_layer_info` | **5 tokens per layer** | Fetch feature attributes at a lat/lng inside a paid map layer (zone, permissible height, corridor distance). Misses are free. |\n| `list_lands_in_region` | **1 token per page** | Up to 10 verified 1acre land listings within a radius of a lat/lng (per page). Empty pages are free. |\n| `create_survey_number_report` | **10 tokens** | Generate a full land-intelligence report for a specific survey number |\n| `identify_parcel_at_point` | **10 tokens** | Identify the cadastral parcel at a lat/lng coordinate and generate its report |\n\nPaid 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.\n\nCall `get_token_balance` first (it's free) to see your live balance and the current per-tool price. A run that would overdraw fails with `insufficient_tokens` and is recoverable — top up from the **My Tokens** page on 1acre and retry.\n\n> \"Tokens\" here means 1acre land-intelligence credits — unrelated to the OAuth access tokens your MCP client manages for sign-in.\n\n---\n\n## Quick start — Claude Code\n\n```bash\nclaude mcp add --scope user --transport http 1acre https://mcp.1acre.in/mcp \\\n  --callback-port 8118 \\\n  --client-id eKg8BebDnd09zxwy\n```\n\nThen in Claude Code:\n\n1. Type `/mcp` — you'll see `1acre` with **Needs authentication**\n2. Click **Sign In**\n3. Browser opens 1acre's sign-in page (phone number)\n4. Enter your phone number → receive OTP via SMS → enter code\n5. Consent screen → **Allow**\n6. `1acre` flips to **✓ Connected**\n\nNow ask Claude anything land-related: *\"How many 1acre tokens do I have left?\"*, *\"What districts does Telangana have?\"*, etc.\n\n---\n\n## Quick start — Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent path on your OS:\n\n```json\n{\n  \"mcpServers\": {\n    \"1acre\": {\n      \"url\": \"https://mcp.1acre.in/mcp\",\n      \"transport\": \"http\",\n      \"oauth\": {\n        \"clientId\": \"eKg8BebDnd09zxwy\",\n        \"callbackPort\": 8118\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Sign in via the MCP servers dialog.\n\n---\n\n## Quick start — Cursor\n\nCursor's MCP config lives at `~/.cursor/mcp.json`. Add:\n\n```json\n{\n  \"mcpServers\": {\n    \"1acre\": {\n      \"url\": \"https://mcp.1acre.in/mcp\"\n    }\n  }\n}\n```\n\nCursor prompts you to authenticate on first tool call.\n\nMore detailed examples in [examples/](./examples).\n\n---\n\n## Authentication\n\n1acre 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).\n\n- Your phone number becomes your identity.\n- **You must have a 1acre.in account first** — sign up at [1acre.in](https://1acre.in) with the phone number you plan to use. MCP resolves your Clerk identity to that Account by matching the phone.\n- Sessions are managed by the auth server; your MCP client refreshes tokens automatically.\n\n---\n\n## Registering an OAuth client\n\n**Most clients register automatically.** 1acre's OAuth provider supports [RFC 7591 Dynamic Client Registration](https://datatracker.ietf.org/doc/html/rfc7591) at `https://clerk.1acre.in/oauth/register` — MCP clients that speak DCR (Claude Code, Smithery, and others) discover this from `.well-known/oauth-authorization-server` and register themselves on first connect. You don't need to do anything, and the `--client-id` flag in the Quick Start above is only needed if your client can't do DCR.\n\n<details>\n<summary>Manual registration (only if your client doesn't support DCR)</summary>\n\nContact `hello@1acre.in` with:\n\n1. Your MCP client name (e.g. \"Internal agent X\")\n2. The exact callback URL your client will use\n\nYou'll receive a `client_id` (public — safe to commit; PKCE-only, no client secret).\n\n</details>\n\n---\n\n## Available at\n\n- **MCP endpoint:** `https://mcp.1acre.in/mcp`\n- **Discovery:** `https://mcp.1acre.in/.well-known/oauth-protected-resource`\n- **Health:** `https://mcp.1acre.in/healthz`\n\n---\n\n## Costs & limits\n\n- **Free tools** (balance check, discovery, hierarchy browse, list survey numbers, sell-listing intent, re-read reports, get coordinates): unlimited\n- **Paid tools**:\n  - `get_layer_info` — **5 tokens per layer** that returns a feature (misses are free)\n  - `list_lands_in_region` — **1 token per non-empty page** (10 listings per page; empty pages are free)\n  - `create_survey_number_report` — **10 tokens** per report\n  - `identify_parcel_at_point` — **10 tokens** per run\n- **Rate limits**: 60 requests/minute per OAuth access token\n\nToken allowance by account tier:\n\n| Tier | Allowance |\n|---|---|\n| Non-premium (regular, free trial, expired premium) | 100 tokens |\n| Premium — quarterly plan | 500 tokens |\n| Premium — yearly plan | 2,000 tokens |\n\nTokens **expire 365 days after they are credited** — this is a balance, not a lifetime allowance. Purchased top-up packs stack on top of your tier allowance, so a balance above the figures above is normal. `get_token_balance` is always the source of truth for what's actually spendable.\n\nFor higher limits, contact `hello@1acre.in`.\n\n---\n\n## Support\n\n- Issues: [github.com/1acre-in/1acre-mcp/issues](https://github.com/1acre-in/1acre-mcp/issues)\n- Email: `hello@1acre.in`\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\nServer code is not open source; this repo covers client-side configuration and documentation only.\n",
  "bytes": 6847,
  "sha": "8a61f9c582c59780ca9d3446b1531e478b651c33ddb184c90bb8533e9247f80b",
  "repo_slug": "1acre-in/1acre-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_in_1acre_land_intelligence_e89f93bc/readme"
}