← Solertio Parcela

MCP dla agentów AI

Twój agent (Claude, Cursor, dowolny klient MCP) może sam sprawdzać działki w polskich rejestrach rządowych — przez Model Context Protocol. Ten sam silnik i te same redakcje RODO co w raporcie na stronie; wyniki są przesiewowe — nie zastępują operatu ani wypisu z MPZP.

Endpoint

https://parcela.solertio.pl/api/mcp

Streamable HTTP (tylko POST, bezstanowo — bez sesji i bez SSE). `initialize` i `tools/list` działają bez klucza; wywołania narzędzi wymagają klucza API.

Narzędzia

  • parcel_report — pełny raport działki (identyfikator TERYT albo lat/lon): plan, powódź, zagregowane ceny zł/m², media, geologia, przyroda + scoring przesiewowy. Ten sam kontrakt co REST /api/v1/report.
  • parcel_screen — szybkie sito dla punktu (plan + powódź + mini-ranking); do triage wielu lokalizacji, zanim finalistów sprawdzisz pełnym raportem.

Klucz API

Klucze (sk_slt_…) wydajemy indywidualnie, w becie bezpłatnie, z dziennymi limitami per narzędzie. Napisz: kontakt@solertio.pl (jedno zdanie: do czego chcesz używać). Klucz działa w obu kanałach: MCP i REST.

Claude Code (CLI)

claude mcp add --transport http parcela https://parcela.solertio.pl/api/mcp \
  --header "Authorization: Bearer sk_slt_..."

Claude Desktop / inne klienty (konfiguracja JSON)

{
  "mcpServers": {
    "parcela": {
      "url": "https://parcela.solertio.pl/api/mcp",
      "headers": { "Authorization": "Bearer sk_slt_..." }
    }
  }
}

Cursor, Windsurf i inne klienty MCP przyjmują analogiczny wpis (zdalny serwer HTTP + nagłówek autoryzacji).

Gołym curlem (JSON-RPC 2.0)

curl -X POST https://parcela.solertio.pl/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_slt_..." \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"parcel_report",
        "arguments":{"parcel":"281410_2.0023.715/41"}}}'

Zasady

  • Wyniki są przesiewowe (UGN): bez wyceny nieruchomości, bez porady prawnej; ceny wyłącznie jako agregaty zł/m² (RODO — bez pojedynczych transakcji).
  • Limity dzienne per klucz; przekroczenie zwraca czytelny komunikat w wyniku narzędzia.
  • Dla crawlerów i agentów bez MCP: /llms.txt.