Dla agentów AI i programistów

Konto w Teście udostępnia swoje pomiary agentom AI i programistom: publicznie, tylko do odczytu, bez rejestracji i kluczy. To te same liczby, które widać na stronach serwisu: indeks niezawodności, dostępność stron logowania, zaplanowane przerwy KIR, oceny aplikacji i decyzje UOKiK. Każda odpowiedź ma adres strony serwisu, źródło i datę odczytu.

Serwer MCP

Adres (Streamable HTTP, JSON-RPC 2.0, bez logowania i bez sesji): https://kontowtescie.pl/mcp. Konfiguracja klienta:

{
    "mcpServers": {
        "kontowtescie": {
            "type": "http",
            "url": "https://kontowtescie.pl/mcp"
        }
    }
}

Narzędzia (publiczne tylko do odczytu; trzy ostatnie działają na alertach zalogowanego czytelnika – logowanie OAuth):

• get_reliability_index – Indeks niezawodności 12 banków w Polsce (0–100) liczony automatycznie z danych publicznych: Dostępność 50%, Aplikacja 30%, Decyzje UOKiK 20%. Zwraca klucze banków, indeks (null, dopóki obszary nie mają pełnego okresu pomiaru), oceny obszarów z flagą pelny_okres_pomiaru i okres. Linkuj do pola url.
• get_bank – Wszystkie publiczne dane jednego banku z jego karty: indeks i obszary, dostępność strony logowania w 30 dniach, przerwy KIR, aplikacja w App Store, decyzje UOKiK, opłaty z porównywarki KNF (poza indeksem).
• get_bank_status – Czy strona logowania banku działała przy ostatnim sprawdzeniu (co 5 minut), ile sprawdzeń dziś, przerwy w ostatnich 30 dniach, godziny i zapowiedziane przerwy przelewów Express Elixir. Sprawdzamy otwieranie strony logowania, nie samo logowanie ani przelewy.
• get_login_availability – Dostępność stron logowania banków w ostatnich 30 dniach: odsetek udanych sprawdzeń, liczba i minuty przerw, średni czas odpowiedzi, liczba sprawdzeń. Kolejność od najmniejszej liczby minut przerw.
• get_instant_transfer_breaks – Zaplanowane okna niedostępności przelewów natychmiastowych Express Elixir ogłoszone przez KIR, według banków (uczestników) w danym miesiącu, oraz przerwy zapowiedziane od dziś. To przerwy planowane, nie awarie.
• get_app_ratings – Aplikacje 13 banków w polskim App Store: średnia ocena, liczba ocen, udział ocen 1–2★ w 50 najnowszych recenzjach, okres tych recenzji, wersja. Ostatni codzienny odczyt.
• get_uokik_decisions – Decyzje Prezesa UOKiK z ostatnich 36 miesięcy, w których bank jest stroną (ochrona zbiorowych interesów konsumentów, klauzule niedozwolone): numer, data, kategoria. wszystkie=true zwraca całą historię z flagą liczy_sie_do_indeksu.
• list_articles – Opublikowane poradniki Konta w Teście (awarie i przerwy banków, przelewy natychmiastowe, aplikacje, decyzje UOKiK): tytuł, data, zajawka, url. Bez zapytania: najnowsze.
• list_my_alerts – Wymaga zalogowania (OAuth, scope alerts:read). Czy czytelnik ma włączone alerty e-mail o awariach i dla których banków (alert = e-mail, gdy strona logowania banku przestaje odpowiadać i gdy znowu działa).
• add_alert – Wymaga zalogowania (OAuth, scope alerts:write). Dodaje bank do alertów e-mail czytelnika: e-mail przyjdzie, gdy strona logowania banku nie odpowiada w 2 kolejnych sprawdzeniach (co 5 minut), i drugi, gdy znowu działa. Wymaga zgody na alerty wyrażonej na ekranie zgody.
• remove_alert – Wymaga zalogowania (OAuth, scope alerts:write). Usuwa bank z alertów e-mail czytelnika. Pozostałe banki zostają.

Osobiste alerty o awariach przez MCP (OAuth 2.1)

Agent może – za Twoją zgodą – sprawdzać, włączać i wyłączać Twoje alerty e-mail o awariach banków (to samo co formularz alertów na stronie banku). Logujesz się linkiem z e-maila, bez hasła, i na ekranie zgody widzisz, kto prosi o dostęp i do czego. Dostęp odwołasz w każdej chwili na stronie Twoje połączone aplikacje.

• Klienci MCP (np. Claude, MCP Inspector) robią to sami: po odpowiedzi 401 znajdą serwer autoryzacji https://kontowtescie.pl (metadane RFC 8414), zarejestrują się (RFC 7591) i otworzą okno logowania. PKCE S256, tokeny 1 h, refresh rotowany.
• Agenci bez przeglądarki: rejestracja według auth.md (service_auth z Twoim e-mailem, kod do wpisania na naszej stronie).
• Zakresy: alerts:read (odczyt), alerts:write (włączanie i wyłączanie). Token działa tylko na https://kontowtescie.pl/mcp.

REST API

Baza: https://kontowtescie.pl/wp-json/kw/v1. Opis OpenAPI 3.1: /wp-json/kw/v1/openapi. Katalog API (RFC 9727): /.well-known/api-catalog.

Przykład: curl "https://kontowtescie.pl/wp-json/kw/v1/banki/ing/status"

Jak liczymy

• Dostępność (50%). Co 5 minut serwer otwiera publiczną stronę logowania do bankowości internetowej. Przerwa to co najmniej 2 kolejne nieudane sprawdzenia (błąd 5xx, brak odpowiedzi w 20 s, błąd połączenia), liczona w krokach po 5 minut. Do minut przerw doliczamy zaplanowane okna niedostępności przelewów Express Elixir ogłoszone przez KIR. Ocena = 100 minus 1 punkt za każde 6 minut przerw w 30 dniach.
• Aplikacja (30%). Codziennie 50 najnowszych recenzji aplikacji w polskim App Store i odsetek ocen 1–2★. Ocena = 100 minus średni odsetek z dziennych odczytów w ostatnich 30 dniach.
• Decyzje UOKiK (20%). Decyzje Prezesa UOKiK z ostatnich 36 miesięcy, w których bank jest stroną, w kategoriach ochrona zbiorowych interesów konsumentów i klauzule niedozwolone. Ocena = 100 minus 25 punktów za każdą decyzję.
• Indeks 0–100 to średnia ważona ocen obszarów. Bank ma indeks, gdy wszystkie obszary mają pełny okres pomiaru (30 dni monitoringu od 25.10.2026, pierwszy indeks 24.11.2026). Przelicza się automatycznie co godzinę.

Pełny opis i ograniczenia: metodyka. Surowe dane: dane i CSV.

Strony w Markdown

Każda strona serwisu zwraca Markdown, gdy klient wyśle nagłówek Accept: text/markdown. Przeglądarki dostają HTML jak dotąd. Mapa serwisu dla modeli: /llms.txt, wersja z liczbami: /llms-full.txt.

Odkrywanie

• Katalog zasobów AI (AI Catalog / ARD): /.well-known/ai-catalog.json
• Karta serwera MCP: /.well-known/mcp/server-card.json
• Skill dla agentów: /.well-known/agent-skills/index.json
• Uwierzytelnianie: /auth.md (potrzebne tylko do osobistych alertów o awariach)
• Nagłówki Link na każdej stronie wskazują te same zasoby.

Zasady korzystania

• Limit: 60 zapytań na minutę z jednego adresu IP (REST i MCP razem). Po przekroczeniu HTTP 429 i nagłówek Retry-After.
• Cytowanie: linkuj do strony serwisu z pola url i podawaj źródło oraz datę odczytu (zrodlo, odczyt). Pole cytuj ma gotowy dopisek.
• Zakres pomiaru: monitoring sprawdza, czy otwiera się strona logowania, a nie czy działa logowanie, przelewy czy aplikacja. Przerwy KIR są planowane, nie są awariami.
• Prywatność: publiczne API i narzędzia MCP nie przyjmują danych osobowych, niczego nie zapisują i nie potrzebują cookies ani logowania. Narzędzia alertów działają wyłącznie na danych zalogowanego czytelnika (polityka prywatności).
• Prawa do treści: cytowanie z podaniem źródła i linku jest dozwolone. Preferencje wykorzystania treści przez systemy AI są w robots.txt.
• Status: /wp-json/kw/v1/status. Błędy w danych: korekty, kontakt: redakcja@kontowtescie.pl.

English