otwarteAPI.pl

Official registry Data and databases

Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "otwarteapi-pl": {
            "type": "http",
            "url": "https://otwarteapi.pl/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. otwarteapi-catalog
  2. Co to jest
  3. Kto to prowadzi
  4. To jest lustro, nie źródło prawdy
  5. Jak zgłosić nowe API lub poprawkę
  6. Licencja

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 — 40 jurysdykcji), 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: info@otwarteapi.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ę

  1. 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ę.
  2. Poprawka istniejącego wpisu (zmieniony endpoint, nieaktualny opis, błędna jurysdykcja): PR edytujący konkretny wpis, z krótkim uzasadnieniem w opisie PR.
  3. 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.

Frequently asked questions

What is otwarteAPI.pl?

Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.

How do I install otwarteAPI.pl?

It runs as a remote server. In Claude Code: claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does otwarteAPI.pl need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is otwarteAPI.pl open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains otwarteAPI.pl?

It is published by bartosz-kuc. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.