About otwarteAPI.pl
otwarteAPI.pl is a catalog of official public APIs for people and AI agents, organized in a machine-readable ARD file. It covers 40 jurisdictions and includes example queries and authentication details.
Key features
- 01Machine-readable ARD catalog
- 02Coverage of 40 jurisdictions
- 03Endpoint and authentication details
- 04Natural-language query examples
Use cases
- 01Discover APIs from public institutions
- 02Check API endpoints and authentication requirements
MCP support
The project provides an ARD catalog for AI agents to discover and call APIs; the input does not describe it as an MCP server.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://otwarteapi.pl/mcpclaude mcp add --transport http bartosz-kuc-otwarteapi https://otwarteapi.pl/mcp{"mcpServers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}Open in Cursor{"servers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}Open in VS Code{"mcpServers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}{"mcpServers":{"bartosz-kuc-otwarteapi":{"serverUrl":"https://otwarteapi.pl/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
1| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Maximum number of results (1–92, default 8). |
| temat | string | No | Tag to narrow results, e.g. „firmy”, „dane-statystyczne”, „bez-klucza”. Optional. |
| zasieg | string | No | Jurisdiction code to narrow results, e.g. PL, EU, DE, GB, US. Optional. |
| zapytanie | string | No | Natural-language query (PL or EN), e.g. „sprawdź VAT firmy w Estonii” or „company register Germany”. Optional. |
Details
From the project READMEotwarteapi-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: [email protected]. 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[]wai-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(brakjeśli bez klucza), orazrepresentativeQueries(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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.