1acre MCP

El servidor oficial MCP (Model Context Protocol) para 1acre.in — el mercado de tierras verificado de la India. Conecta Claude Code, Cursor, Claude Desktop o cualquier cliente compatible con MCP para consultar números de catastro, explorar datos catastrales y generar informes de inteligencia territorial en nombre de tu cuenta de 1acre.

Este repositorio contiene la configuración y documentación del lado del cliente — cómo conectarse. El servidor en sí se ejecuta en https://mcp.1acre.in.

Lo que puedes hacer

Una vez conectado, cualquier cliente MCP puede llamar a estas herramientas como el usuario de 1acre con sesión iniciada:

Las herramientas de pago gastan de tu saldo de tokens "1a": create_survey_number_report e identify_parcel_at_point cuestan 10 tokens por ejecución cada una. Las herramientas gratuitas no cuestan nada: una vez que existe un informe, puedes reabrirlo y obtener sus coordenadas de límite tantas veces como quieras sin gastar otro token.

Llama primero a get_token_balance (es gratis) para ver tu saldo en vivo y el precio actual por herramienta. Una ejecución que exceda el saldo falla con insufficient_tokens y es recuperable: recarga desde la página My Tokens en 1acre y vuelve a intentarlo.

"Tokens" aquí significa créditos de inteligencia territorial de 1acre — no relacionados con los tokens de acceso OAuth que tu cliente MCP gestiona para el inicio de sesión.

Related MCP server: mcp-rosreestr

Inicio rápido — Claude Code

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

Luego, en Claude Code:

1. Escribe /mcp — verás 1acre con Necesita autenticación

2. Haz clic en Iniciar sesión

3. El navegador abre la página de inicio de sesión de 1acre (número de teléfono)

4. Ingresa tu número de teléfono → recibe OTP por SMS → ingresa el código

5. Pantalla de consentimiento → Permitir

6. 1acre cambia a ✓ Conectado

Ahora pregúntale a Claude cualquier cosa relacionada con tierras: "¿Cuántos tokens de 1acre me quedan?", "¿Qué distritos tiene Telangana?", etc.

Inicio rápido — Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o la ruta equivalente en tu sistema operativo:

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

Reinicia Claude Desktop. Inicia sesión a través del diálogo de servidores MCP.

Inicio rápido — Cursor

La configuración MCP de Cursor se encuentra en ~/.cursor/mcp.json. Añade:

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

Cursor te pedirá que te autentiques en la primera llamada a una herramienta.

Ejemplos más detallados en examples/.

Autenticación

1acre MCP utiliza OAuth 2.1 con PKCE. El inicio de sesión se basa en el número de teléfono mediante verificación SMS de un solo uso (seguro, compatible con DLT para números de teléfono indios).

• Tu número de teléfono se convierte en tu identidad.

• Debes tener una cuenta en 1acre.in primero — regístrate en 1acre.in con el número de teléfono que planeas usar. MCP resuelve tu identidad de Clerk a esa cuenta haciendo coincidir el teléfono.

• Las sesiones son gestionadas por el servidor de autenticación; tu cliente MCP renueva los tokens automáticamente.

Registro de un cliente OAuth

La mayoría de los clientes se registran automáticamente. El proveedor OAuth de 1acre admite Registro Dinámico de Clientes RFC 7591 en https://clerk.1acre.in/oauth/register — los clientes MCP que hablan DCR (Claude Code, Smithery y otros) descubren esto desde .well-known/oauth-authorization-server y se registran en la primera conexión. No necesitas hacer nada, y la bandera --client-id en el Inicio Rápido anterior solo es necesaria si tu cliente no puede hacer DCR.

Contacta con hello@1acre.in con:

1. El nombre de tu cliente MCP (por ejemplo, "Agente interno X")

2. La URL de devolución de llamada exacta que usará tu cliente

Recibirás un client_id (público — seguro para commit; solo PKCE, sin secreto de cliente).

Disponible en

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

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

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

Costos y límites

• Herramientas gratuitas (navegar, listar, verificar saldo): ilimitadas

• Herramientas de pago (generación de informes, identificación de parcelas): 10 tokens por ejecución

• Límites de velocidad: 60 solicitudes/minuto por token de acceso OAuth

Asignación de tokens por nivel de cuenta:

Los tokens expiran 365 días después de ser acreditados — esto es un saldo, no una asignación de por vida. Los paquetes de recarga comprados se acumulan sobre tu asignación de nivel, por lo que un saldo superior a las cifras anteriores es normal. get_token_balance es siempre la fuente de verdad sobre lo que realmente se puede gastar.

Para límites más altos, contacta con hello@1acre.in.

Soporte

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

• Correo electrónico: hello@1acre.in

Licencia

MIT — consulta LICENSE.

El código del servidor no es de código abierto; este repositorio cubre solo la configuración y documentación del lado del cliente.