BotMarket.sk

Search published real-estate and land listings from BotMarket.sk (Košice, Slovakia).

Hosted MCP Server

npx add-mcp 'https://api.botmarket.sk/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

BotMarket pre AI agentov

Ponuky z BotMarketu (pozemky a komerčné nehnuteľnosti, Košice a východné Slovensko) môže čítať každý AI agent cez MCP server, A2A alebo REST API, bez registrácie a bez kľúča. Vidno len zverejnené inzeráty. Obchod vždy potvrdzuje človek.

MCP server

Adresa (Streamable HTTP): https://api.botmarket.sk/mcp

Nástroje: search_listings (text, kategória, typ, lokalita, cena od/do, limit), get_listing (podľa id), list_categories. Zoznam nástrojov aj volanie nástrojov funguje bez kľúča.

Každý inzerát má štruktúrované polia: price (suma, cena za m², rozpätie, vat – či je cena s DPH, bez DPH alebo predávajúci nie je platca DPH), area (výmery v m²), utilities (siete), access (prístupová cesta), zoning (územný plán), availability a updated_at. Čo predajca neuviedol, je null.

Claude Desktop, Cursor a iné MCP klienty

{
  "mcpServers": {
    "botmarket": {
      "type": "http",
      "url": "https://api.botmarket.sk/mcp"
    }
  }
}

Klient, ktorý podporuje len lokálne (stdio) servery, sa pripojí cez mcp-remote:

{
  "mcpServers": {
    "botmarket": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.botmarket.sk/mcp"]
    }
  }
}

Claude Code: claude mcp add --transport http botmarket https://api.botmarket.sk/mcp

S voliteľným kľúčom pridajte hlavičku "headers": { "Authorization": "Bearer VAS_API_KLUC" } (pri Claude Code --header "Authorization: Bearer VAS_API_KLUC").

Rýchly test bez kľúča:

curl -s https://api.botmarket.sk/mcp -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_listings","arguments":{"query":"pozemok"}}}'

A2A

Agent Card: /.well-known/agent-card.json. JSON-RPC endpoint https://api.botmarket.sk/a2a odpovedá na message/send (A2A 0.3) aj SendMessage (A2A 1.0) textom alebo dátami s filtrami.

REST API

Limity a voliteľný API kľúč

Bez kľúča: 30 požiadaviek za minútu na IP adresu (IPv6 po /64) a spolu 600 za minútu pre všetkých anonymných klientov. Pri prekročení dostanete HTTP 429 s hlavičkou Retry-After.

Ak potrebujete viac, napíšte na riso.sala@gmail.com, kto ste a na čo kľúč použijete. S kľúčom v hlavičke Authorization: Bearer … alebo X-API-Key je limit 120 požiadaviek za minútu. Neplatný kľúč vráti chybu, preto ho radšej vynechajte, než aby ste posielali starý.