1acre MCP

Официальный MCP-сервер (Model Context Protocol) для 1acre.in — проверенной земельной торговой площадки Индии. Подключите Claude Code, Cursor, Claude Desktop или любого MCP-совместимого клиента, чтобы просматривать кадастровые номера, работать с кадастровыми данными и создавать отчёты о земельной аналитике от имени вашего аккаунта 1acre.

Этот репозиторий содержит клиентскую конфигурацию и документацию — как подключиться. Сам сервер работает по адресу https://mcp.1acre.in.

Что вы можете делать

После подключения любой MCP-клиент может вызывать эти инструменты от имени вошедшего пользователя 1acre:

Платные инструменты расходуют ваш баланс токенов "1a": create_survey_number_report и identify_parcel_at_point стоят 10 токенов за каждый запуск. Бесплатные инструменты ничего не стоят — как только отчёт создан, вы можете открывать его и получать координаты границ сколько угодно раз, не тратя дополнительные токены.

Сначала вызовите get_token_balance (это бесплатно), чтобы увидеть текущий баланс и актуальную цену за инструмент. Запуск, который превысил бы баланс, завершается ошибкой insufficient_tokens и может быть повторён — пополните баланс на странице My Tokens на 1acre и повторите попытку.

«Токены» здесь означают кредиты земельной аналитики 1acre — они не связаны с токенами доступа OAuth, которые ваш MCP-клиент использует для входа.

Related MCP server: mcp-rosreestr

Быстрый старт — Claude Code

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

Затем в Claude Code:

1. Введите /mcp — вы увидите 1acre со статусом Needs authentication

2. Нажмите Sign In

3. В браузере откроется страница входа 1acre (номер телефона)

4. Введите номер телефона → получите OTP по SMS → введите код

5. Экран согласия → Allow

6. 1acre переключится в ✓ Connected

Теперь задавайте Клоду любые вопросы о земле: «Сколько у меня осталось токенов 1acre?», «Какие округа есть в Телангане?» и т. д.

Быстрый старт — Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или аналогичный путь в вашей ОС:

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

Перезапустите Claude Desktop. Войдите через диалог MCP-серверов.

Быстрый старт — Cursor

Конфигурация MCP в Cursor находится в ~/.cursor/mcp.json. Добавьте:

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

Cursor предложит пройти аутентификацию при первом вызове инструмента.

Более подробные примеры — в examples/.

Аутентификация

1acre MCP использует OAuth 2.1 с PKCE. Вход выполняется по номеру телефона с одноразовым SMS-подтверждением (безопасно, соответствует требованиям DLT для индийских номеров).

• Ваш номер телефона становится вашей личностью.

• Сначала необходимо создать аккаунт на 1acre.in — зарегистрируйтесь на 1acre.in с тем номером телефона, который планируете использовать. MCP сопоставляет вашу личность Clerk с этой учётной записью по номеру телефона.

• Сеансы управляются сервером аутентификации; ваш MCP-клиент автоматически обновляет токены.

Регистрация OAuth-клиента

Большинство клиентов регистрируются автоматически. OAuth-провайдер 1acre поддерживает динамическую регистрацию клиентов RFC 7591 по адресу https://clerk.1acre.in/oauth/register — MCP-клиенты, поддерживающие DCR (Claude Code, Smithery и другие), обнаруживают это через .well-known/oauth-authorization-server и регистрируются при первом подключении. Вам ничего не нужно делать, а флаг --client-id из быстрого старта выше нужен только в том случае, если ваш клиент не поддерживает DCR.

Свяжитесь с hello@1acre.in, указав:

1. Название вашего MCP-клиента (например, «Внутренний агент X»)

2. Точный URL обратного вызова, который будет использовать ваш клиент

Вы получите client_id (публичный — его можно коммитить; только PKCE, без секрета клиента).

Доступно по адресу

• Конечная точка MCP: https://mcp.1acre.in/mcp

• Обнаружение: https://mcp.1acre.in/.well-known/oauth-protected-resource

• Здоровье: https://mcp.1acre.in/healthz

Стоимость и лимиты

• Бесплатные инструменты (просмотр, список, проверка баланса): без ограничений

• Платные инструменты (создание отчётов, определение участков): 10 токенов за запуск

• Лимит запросов: 60 запросов в минуту на один токен доступа OAuth

Лимит токенов по тарифу аккаунта:

Токены сгорают через 365 дней после начисления — это баланс, а не пожизненный лимит. Приобретённые пакеты пополнения добавляются к лимиту вашего тарифа, поэтому баланс выше указанных значений — это нормально. get_token_balance всегда является источником истины о том, что реально можно потратить.

Для более высоких лимитов обращайтесь по адресу hello@1acre.in.

Поддержка

• Проблемы: github.com/1acre-in/1acre-mcp/issues

• Эл. почта: hello@1acre.in

Лицензия

MIT — см. LICENSE.

Исходный код сервера не является открытым; этот репозиторий содержит только клиентскую конфигурацию и документацию.