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, Cursora lub dowolnego klienta MCP. Asystent zyskuje dwa narzędzia: check_phone_number (sprawdzenie konkretnego numeru, gdy rozmowa dotyczy nieznanego lub podejrzanego numeru w Polsce) oraz pogoda_spamowa (aktualna skala phishingu i spamu w Polsce: nowe domeny oszustów wg CERT, wykaz DNO).

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"]
    }
  }
}

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.