What can you do with otwarteAPI?

otwarteapi-catalog

Publiczne dane katalogu stojące za otwarteAPI.pl — katalogu publicznych API rządowych z całego świata (Polska, Unia Europejska i kraje z 6 kontynentów — 32 jurysdykcje), opisanych tak by mogły być odkrywane i wywoływane przez agentów AI oraz ludzi.

Co to jest

ai-catalog.json w formacie ARD (Agent Resource Directory) — jeden maszynowo czytelny plik opisujący każde API: nazwę, opis, endpoint, wymagany klucz/autoryzację, jurysdykcję (kod kraju, EU lub INT), tagi i przykładowe zapytania. Ten sam plik serwuje sama strona pod otwarteapi.pl/.well-known/ai-catalog.json.

Kto to prowadzi

Bartosz Kuć (ten sam autor co skanfirmy.pl), prywatny projekt non-profit. Kontakt: firma@bartosza.pl. Więcej na otwarteapi.pl/o-projekcie.

To jest lustro, nie źródło prawdy

To repozytorium to kopia stanu produkcyjnego, aktualizowana ręcznie. Zaakceptowane PR-y i issue trafiają najpierw tutaj do przeglądu, a dopiero potem są ręcznie przenoszone do prywatnego repo, które faktycznie zasila stronę produkcyjną — nie ma automatycznej synchronizacji w żadną stronę.

Jak zgłosić nowe API lub poprawkę

Nowe API: otwórz issue albo PR dodający wpis do entries[] w ai-catalog.json. Wymagane pola: identifier (URN, np. urn:air:otwarteapi.pl:api:twoj-slug), displayName, description, url (dokumentacja techniczna), type, jurisdiction (PL/EU/kod kraju), tags, metadata.auth (brak jeśli bez klucza), oraz representativeQueries (2-3 przykładowe pytania, po jednym w naturalnym języku). API musi być publiczne, oficjalne (rządowe, samorządowe lub międzynarodowej instytucji publicznej) i mieć żywą, działającą dokumentację.
Poprawka istniejącego wpisu (zmieniony endpoint, nieaktualny opis, błędna jurysdykcja): PR edytujący konkretny wpis, z krótkim uzasadnieniem w opisie PR.
Każdy PR jest ręcznie recenzowany pod kątem poprawności i tego, czy API faktycznie działa (żywy curl/test), zanim trafi do wersji produkcyjnej.

Licencja

MIT — patrz LICENSE. Same dane API pozostają własnością i na licencji swoich pierwotnych źródeł (rządów/instytucji UE); ten plik tylko je katalogizuje i linkuje do oficjalnej dokumentacji.

Install

Add otwarteAPI to your client. Pick the one you use.

claude mcp add --transport http otwarteapi https://otwarteapi.pl/mcp

codex mcp add otwarteapi --url https://otwarteapi.pl/mcp

{
  "mcpServers": {
    "otwarteapi": {
      "url": "https://otwarteapi.pl/mcp"
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "servers": {
    "otwarteapi": {
      "type": "http",
      "url": "https://otwarteapi.pl/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

{
  "mcpServers": {
    "otwarteapi": {
      "url": "https://otwarteapi.pl/mcp"
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "otwarteapi": {
      "serverUrl": "https://otwarteapi.pl/mcp"
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

Score

39 / 100

Incomplete

Documentation11/25
Maintenance19/25
Trust6/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 8 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
6 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
1.0.0Latest	Aug 23, 2026