Spec serwera MCP

Dokumentacja API albo lista endpointów: [API]. Język (TS / Python): [JEZYK]. Lokalny vs zdalny: [TRANSPORT].

NIE PISZ PEŁNEGO SERWERA I NIE WKLEJAJ SEKRETÓW. To spec tooli, zanim padnie SDK. Jeśli [API] puste - poproś o docs albo listę endpointów i stop.
Jeśli [JEZYK] puste - pytaj TS albo Python i stop.

Transport (wybierz jeden, z uzasadnieniem 1 zdanie):

- `stdio` - serwer lokalny przy agencie
- streamable HTTP - serwer zdalny; preferuj bezstanowe JSON, nie sesję "na czata"

Jeśli [TRANSPORT] puste: lokalny = stdio, zdalny = streamable HTTP.

Zwracasz:

## 1. Lista tooli
Dla każdego toola:

- nazwa: prefiks serwisu + czasownik, snake albo kebab zgodny ze stackiem (`github_list_repos`). Zakaz: `doStuff`, `handle`, `generic_call`, nazwa bez czasownika
- opis: 1-3 zdania, kiedy agent MA to wybrać; zero kluczy, tokenów, connection string
- input schema (JSON Schema / Zod / Pydantic - zgodnie z [JEZYK]): typy, required, enum, limity
- output schema: pola, które agent ma dostać (zwięźle; listy z paginacją)
- adnotacje, KAŻDA wypełniona:
  - `readOnlyHint`
  - `destructiveHint`
  - `idempotentHint`
- błąd: komunikat z podpowiedzią "co zrobić dalej" (np. "podaj `cursor` z poprzedniej strony"), nie surowy stack
- paginacja: jeśli to lista - parametry `cursor`/`limit` i jak wraca następna strona; bez paginacji na liście = błąd specu

Priorytet: pokrycie API (endpoint = tool albo świadomie złączony workflow). Nie chowaj 20 endpointów w jednym `do_everything`.

## 2. Wybór transportu
Jedna linia: stdio albo streamable HTTP + dlaczego. Auth: skąd sekret (env / credential store), nigdy w opisie toola i nigdy w przykładzie.

## 3. Dziesięć pytań ewaluacyjnych (read-only)
Dokładnie 10. Każde:

- niezależne od pozostałych
- tylko operacje nie-destrukcyjne
- wymaga użycia toola (nie zgadywania z docs)
- jedna weryfikowalna odpowiedź
- stabilne w czasie (nie "ile jest issue NA TERAZ" bez kotwicy)

Format: numer | pytanie | który tool | oczekiwany kształt odpowiedzi.

Zakazy: owijanie `cat`/`Read` na lokalne pliki; ukrywanie sekretu w description; tool bez trzech hintów; eval, które mutuje dane. Dywiz "-". Nazwy tooli i schematy po angielsku.