API i serwer MCP

Sprawdzaj polskie numery telefonów we własnych aplikacjach i u asystentów AI: operator, typ, etykieta spamu z opinii, wykaz DNO UKE (spoofing) i Biała Lista oficjalnych infolinii. Zwracamy wyłącznie dane widoczne publicznie na stronach numerów, nigdy treści opinii.

REST API

GET /api/v1/check/{numer} — numer w formacie krajowym (9 cyfr, bez +48). Dodatkowo GET /api/v1/spam-weather — zagregowane wskaźniki phishingu i spamu w Polsce (bez limitu, CC-BY).

curl https://numertel.pl/api/v1/check/800302302

Przykładowa odpowiedź:

{
  "number": "800302302",
  "e164": "+48800302302",
  "operator": "Numer usługowy",
  "number_type": "non_mobile",
  "spam_label": "dno_spoofing",
  "total_opinions": 0,
  "score_avg": null,
  "sightings_30d": 0,
  "is_dno": true,
  "dno_note": "Numer służy wyłącznie do odbierania połączeń (wykaz DNO UKE)...",
  "whitelist": { "institution": "PKO Bank Polski", "label": "infolinia główna 24/7", "verified_on": "2026-06-10" },
  "url": "https://numertel.pl/numer/800302302",
  "attribution": "dane: numertel.pl"
}

Limity: bez klucza 20 zapytań/dzień na IP. Wyższy limit (klucz API): napisz na [email protected] z krótkim opisem zastosowania.

Wartości spam_label: brak_danych · raczej_bezpieczny · podejrzany · niebezpieczny · dno_spoofing (numer z wykazu DNO — połączenie przychodzące jest sfałszowane).

Warunki: wymagana atrybucja „dane: numertel.pl" z linkiem przy publicznej prezentacji wyników. Zakaz masowego kopiowania bazy.

Serwer MCP (asystenci AI)

Podłącz NumerTel do Claude, ChatGPT, Cursora lub dowolnego klienta MCP. Narzędzia: check_phone_number (reputacja numeru), check_scam_domain (wklej całą wiadomość — sprawdza domeny/linki/e-maile na Liście Ostrzeżeń CERT oraz polskie numery z treści w wykazie DNO i na Białej Liście), pogoda_spamowa (skala phishingu w Polsce, parametr days), search (numer albo nazwa instytucji z Białej Listy) i fetch — dwa ostatnie zapewniają zgodność z trybem deep research ChatGPT. Do tego trzy gotowe prompty (np. „Czy ten SMS to oszustwo?"), widoczne w menu „+" w Claude. Narzędzia są read-only (annotations), wyniki mają structured output. Wyższy limit: klucz API w nagłówku Authorization: Bearer.

Wariant zalecany: zdalny serwer, bez instalacji

Dodaj sam adres URL https://numertel.pl/api/mcp jako serwer MCP. Nic nie pobierasz.

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

Wariant lokalny: jeden plik Node.js (stdio)

Dla klientów obsługujących wyłącznie stdio. Serwer to pojedynczy plik bez zależności, pobierz: numertel-mcp.mjs (kod otwarty, MIT: github.com/AMR-DEV-PS/numertel-mcp).

{
  "mcpServers": {
    "numertel": {
      "command": "node",
      "args": ["/sciezka/do/numertel-mcp.mjs"]
    }
  }
}

Inne ekosystemy

ChatGPT (Plus/Pro, działa w Polsce): Settings → Apps & Connectors → Advanced → włącz Developer mode → Create connector → wklej https://numertel.pl/api/mcp (No authentication).
Gemini CLI: w settings.json dodaj {"mcpServers":{"numertel":{"httpUrl":"https://numertel.pl/api/mcp"}}}.
Microsoft Copilot Studio: Tools → Add Tool → MCP → wklej URL serwera.
Własny GPT (Actions): w edytorze GPT → Create new action → Import from URL → wklej https://numertel.pl/openapi.json (schemat OpenAPI 3.1, endpointy REST bez klucza).

Co potem powiedzieć asystentowi:

„Kto dzwonił z numeru 500 100 200?"
„Czy 22 598 40 44 to prawdziwy numer banku, czy oszustwo?"
„Sprawdź ten numer: 730 111 222"
„Jaka jest dziś skala phishingu w Polsce?"

Otwarte dane

Szukasz agregatów (fala phishingu CERT, wykaz DNO, struktura numeracji)? Zobacz Obserwatorium Spamu — datasety CC-BY do pobrania.