Serwer
| Element | Wartość |
|---|---|
| Adres | https://docs.niebieskiorzel.pl/mcp |
| Transport | Streamable HTTP: żądanie POST z wiadomością JSON-RPC, odpowiedź application/json |
| Logowanie | niewymagane; serwer jest publiczny i działa tylko w trybie odczytu |
| Sesje | brak; serwer jest bezstanowy (żądania GET i DELETE zwracają 405) |
| Karta serwera | https://docs.niebieskiorzel.pl/mcp/server-card (application/mcp-server-card+json) |
| Pliki wykrywania | https://docs.niebieskiorzel.pl/.well-known/ai-catalog.json, https://docs.niebieskiorzel.pl/.well-known/ard.json |
| Limit rozmiaru żądania | 64 KB (większe żądania otrzymują kod 413) |
Narzędzia
list_pages
Zwraca listę stron dokumentacji, maksymalnie 200 w jednej odpowiedzi.
| Parametr | Opis |
|---|---|
section |
pierwszy segment ścieżki, np. poradniki, albo index dla strony głównej |
cursor |
wartość nextCursor z poprzedniej odpowiedzi |
Każdy element zawiera title, url, markdownUrl, section i opcjonalnie description. Jeśli dostępne są kolejne strony, odpowiedź zawiera również nextCursor.
get_page
Zwraca treść jednej strony w formacie Markdown.
| Parametr | Opis |
|---|---|
url |
adres z list_pages albo ścieżka w serwisie, np. /poradniki/ksef/wyslij-fakture/ |
Odpowiedź ma postać { title, url, markdownUrl, content }. Treść dłuższa niż ok. 100 000 znaków jest skracana i oznaczana jako truncated: true; pełną stronę zawiera adres markdownUrl.
Błędy
Błąd jest zwracany w wyniku narzędzia z flagą isError, w postaci { error: { code, message } }:
| Kod | Znaczenie |
|---|---|
invalid_input |
nieprawidłowe parametry |
not_found |
strona nie istnieje |
unavailable |
treść jest chwilowo niedostępna |
Test w MCP Inspector
npx @modelcontextprotocol/inspector --cli https://docs.niebieskiorzel.pl/mcp --transport http --method tools/list