1acre MCP

Der offizielle MCP-Server (Model Context Protocol) für 1acre.in – Indiens verifizierter Marktplatz für Grundstücke. Verbinde Claude Code, Cursor, Claude Desktop oder einen beliebigen MCP-kompatiblen Client, um Survey-Nummern nachzuschlagen, Katasterdaten zu durchsuchen und im Namen deines 1acre-Kontos Land-Intelligence-Berichte zu erstellen.

Dieses Repository enthält die clientseitige Konfiguration und Dokumentation – wie man sich verbindet. Der Server selbst läuft unter https://mcp.1acre.in.

Was du tun kannst

Nach dem Verbinden kann jeder MCP-Client diese Tools als angemeldeter 1acre-Benutzer aufrufen:

Kostenpflichtige Tools verbrauchen dein „1a“-Token-Guthaben: create_survey_number_report und identify_parcel_at_point kosten jeweils 10 Tokens pro Durchlauf. Kostenlose Tools kosten nichts – sobald ein Bericht existiert, kannst du ihn beliebig oft erneut öffnen und seine Grenzkoordinaten abrufen, ohne ein weiteres Token auszugeben.

Rufe zuerst get_token_balance auf (es ist kostenlos), um dein aktuelles Guthaben und den aktuellen Preis pro Tool zu sehen. Ein Durchlauf, der das Guthaben überziehen würde, schlägt mit insufficient_tokens fehl und ist behebbar – lade über die Seite My Tokens auf 1acre Guthaben nach und versuche es erneut.

„Tokens“ bedeutet hier 1acre-Land-Intelligence-Credits – unabhängig von den OAuth-Zugriffstokens, die dein MCP-Client für die Anmeldung verwaltet.

Related MCP server: mcp-rosreestr

Schnellstart – Claude Code

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

Dann in Claude Code:

1. Tippe /mcp – du siehst 1acre mit Needs authentication

2. Klicke auf Sign In

3. Der Browser öffnet die Anmeldeseite von 1acre (Telefonnummer)

4. Gib deine Telefonnummer ein → erhalte OTP per SMS → gib den Code ein

5. Zustimmungsbildschirm → Allow

6. 1acre wechselt zu ✓ Connected

Jetzt kannst du Claude alles rund um Grundstücke fragen: „Wie viele 1acre-Tokens habe ich noch?“, „Welche Distrikte hat Telangana?“, usw.

Schnellstart – Claude Desktop

Füge Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder dem entsprechenden Pfad auf deinem Betriebssystem hinzu:

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

Starte Claude Desktop neu. Melde dich über den MCP-Server-Dialog an.

Schnellstart – Cursor

Die MCP-Konfiguration von Cursor befindet sich unter ~/.cursor/mcp.json. Füge Folgendes hinzu:

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

Cursor fordert dich beim ersten Tool-Aufruf zur Authentifizierung auf.

Weitere ausführliche Beispiele findest du in examples/.

Authentifizierung

1acre MCP verwendet OAuth 2.1 mit PKCE. Die Anmeldung erfolgt über eine Telefonnummer per Einmal-SMS-Verifizierung (sicher, DLT-konform für indische Telefonnummern).

• Deine Telefonnummer wird deine Identität.

• Du musst zuerst ein 1acre.in-Konto haben – registriere dich unter 1acre.in mit der Telefonnummer, die du verwenden möchtest. MCP ordnet deine Clerk-Identität diesem Konto zu, indem die Telefonnummer abgeglichen wird.

• Sitzungen werden vom Authentifizierungsserver verwaltet; dein MCP-Client erneuert Tokens automatisch.

Registrieren eines OAuth-Clients

Die meisten Clients registrieren sich automatisch. Der OAuth-Anbieter von 1acre unterstützt RFC 7591 Dynamic Client Registration unter https://clerk.1acre.in/oauth/register – MCP-Clients, die DCR unterstützen (Claude Code, Smithery und andere), finden dies über .well-known/oauth-authorization-server und registrieren sich beim ersten Verbinden selbst. Du musst nichts tun; das --client-id-Flag im obigen Schnellstart wird nur benötigt, wenn dein Client kein DCR kann.

Kontaktiere hello@1acre.in und gib Folgendes an:

1. Den Namen deines MCP-Clients (z. B. „Internal agent X“)

2. Die genaue Callback-URL, die dein Client verwenden wird

Du erhältst eine client_id (öffentlich – kann bedenkenlos eingecheckt werden; nur PKCE, kein Client-Secret).

Verfügbar unter

• MCP-Endpunkt: https://mcp.1acre.in/mcp

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

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

Kosten & Limits

• Kostenlose Tools (Durchsuchen, Auflisten, Guthabenprüfung): unbegrenzt

• Kostenpflichtige Tools (Berichtserstellung, Flurstücksidentifizierung): 10 Tokens pro Durchlauf

• Rate-Limits: 60 Anfragen/Minute pro OAuth-Zugriffstoken

Token-Kontingent nach Kontostufe:

Tokens verfallen 365 Tage nach ihrer Gutschrift – es handelt sich um ein Guthaben, nicht um ein lebenslanges Kontingent. Gekaufte Aufladepakete kommen zusätzlich zu deinem Stufen-Kontingent hinzu; daher ist ein Guthaben über den obigen Werten normal. get_token_balance ist immer die maßgebliche Quelle dafür, was tatsächlich ausgegeben werden kann.

Für höhere Limits kontaktiere hello@1acre.in.

Support

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

• E-Mail: hello@1acre.in

Lizenz

MIT – siehe LICENSE.

Der Servercode ist nicht Open Source; dieses Repository umfasst nur die clientseitige Konfiguration und Dokumentation.