otwarteAPI.pl
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).
claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'
{
"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
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ę
- 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.
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.