Veřejná vývojářská platforma

API & MCP pro české firemní údaje

Nízkoobjemový přístup bez registrace. REST pro projekty a Streamable HTTP MCP pro AI agenty.

Rychlý start REST

curl

curl https://rejstr.cz/api/v1/subjects/28862961

JavaScript

const response = await fetch('https://rejstr.cz/api/v1/search?q=alfa');
const result = await response.json();

Python

import requests
result = requests.get('https://rejstr.cz/api/v1/subjects/28862961').json()

REST API reference

GET /api/v1/subjects/{ico}

Veřejný firemní profil podle IČO (jedna až osm číslic; kratší hodnoty se doplní nulami). Anonymous limit: 60/min/IP. Sdílená cache, ETag a metadata čerstvosti.

200 · 400 · 404 · 429 · Retry-After · public-core

GET /api/v1/search?q=&limit=&offset=

Hledání firem podle názvu. Anonymous limit: 15/min/IP; limit ≤ 10 a offset ≤ 100.

200 · 400 · 404 · 429 · Retry-After · public-core

Chyby používají BAD_REQUEST, NOT_FOUND, RATE_LIMITED, PAYLOAD_TOO_LARGE, UNAUTHORIZED a INTERNAL_ERROR. Neplatný zaslaný klíč vrátí 401; bez klíče se použije anonymous kvóta.

MCP pro AI agenty

Kanonický endpoint: https://rejstr.cz/mcp. Transport: stateless Streamable HTTP. Token není povinný.

Obecná MCP konfigurace

{
  "mcpServers": {
    "rejstr": {
      "type": "streamable-http",
      "url": "https://rejstr.cz/mcp"
    }
  }
}

tool search_subjects({ query, limit? })

Vyhledání, když neznáte přesné IČO.

200 · 400 · 404 · 429 · Retry-After · public-core

tool get_subject({ ico })

Preferovaný pro přesné faktické odpovědi; citujte URL profilu a datum dat.

200 · 400 · 404 · 429 · Retry-After · public-core

Klienti s vlastními hlavičkami

Volitelně pošlete Authorization: Bearer <public-key> nebo X-API-Key pro vyšší kvótu. Vrácená data se nemění.

Klienti bez remote MCP

Volejte REST endpointy přímo z agenta. Lokální stdio proxy lze doplnit později; REST zůstává významově shodnou alternativou.

Návody naposledy ověřeny: 21. července 2026.

Data, soukromí a férové používání

Profil public-core povoluje firemní údaje a vylučuje fyzické osoby, data narození, bydliště, raw registry payloady a interní diagnostiku. Službu nepoužívejte k profilování osob ani obcházení limitů.

Rizikové příznaky říkají, co uvedl zdroj; nejsou důkazem podvodu ani úvěrovým skóre. Faktické odpovědi mají citovat zdrojové URL a metadata čerstvosti.

Verzování a podpora

Kontrakt /v1 dostává aditivní změny. Breaking změny vyžadují novou verzi a zdokumentované deprekační období.

Integrační nebo bezpečnostní problém? Použijte kontakt uvedený na stránce projektu a ochrany soukromí.