Numertel

pl.numertelPublished by numertel.plOfficial publisherv1.4.0Updated Oct 24, 2026

Polish phone number lookup: who called, spam and scam checks, UKE DNO registry, CERT phishing stats

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingSecurity & Monitoring

Overview

AI-generated overview

Remote MCP server for checking Polish phone numbers: who called, spam or scam risk, official hotlines, and CERT Polska phishing data.

What you can do
Look up a Polish phone number's reputation: operator range, risk label, UKE DNO registry status and report counts, or fetch a full card by search result id. Find the verified official hotline of a Polish bank, office or operator by institution name. Analyze a pasted suspicious message, extracting domains, links, emails and Polish numbers and checking them against CERT Polska's Warning List and the NumerTel base. List the latest phishing domains from CERT Polska's Warning List in defanged form. Show current phone-abuse indicators for Poland, such as new scam domains and DNO registry size. Search the NumerTel base by number or institution name.
When to use it
Useful when an assistant needs to answer questions about unknown Polish callers, suspected bank or office impersonation, whether a number is a real official hotline, or the current scale of phone phishing and scam domains in Poland.
Requirements
A remote streamable HTTP endpoint; no installation or authentication needed for the free tier. Clients without native remote MCP support need the mcp-remote bridge or the optional single-file local stdio server, which requires Node 18+. An optional API key (NUMERTEL_API_KEY or an Authorization Bearer header) raises the free limit of 30 requests per day per IP.
Before you install
Read-only and returns only data already public on numertel.pl number pages, with queries not logged beyond anonymous rate-limit counters. Public presentation of results requires attribution to numertel.pl with a link; aggregate datasets are CC-BY 4.0. Free daily limits can return HTTP 429. Only Polish numbering ranges are covered.

Installation

In SourceWeft

  1. Open Numertel in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/pl.numertel%2Fnumertel/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

[NumerTel MCP Server]

English · Polski

NumerTel MCP Server

Check Polish phone numbers from any AI assistant: who called, is it spam or a scam, is this really a bank's number — plus live phone-abuse stats for Poland.

Backed by NumerTel.pl: 130M numbers built on official UKE numbering ranges, user reports, the state DNO registry and CERT Polska's public Warning List.

[License: MIT] [Website] [MCP Registry] [Glama MCP server]

[Install MCP Server] [Install in VS Code]

Remote server (recommended)

One endpoint, zero install:

https://numertel.pl/api/mcp

Generic config that works in most MCP clients:

json
{  "mcpServers": {    "numertel": {      "type": "http",      "url": "https://numertel.pl/api/mcp"    }  }}
Claude Code
bash
claude mcp add --transport http numertel https://numertel.pl/api/mcp
Cursor

Use the install button above, or add to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "numertel": { "url": "https://numertel.pl/api/mcp" }  }}
VS Code

Use the install button above, or add to mcp.json:

json
{  "servers": {    "numertel": { "type": "http", "url": "https://numertel.pl/api/mcp" }  }}
Claude Desktop (or any client without native streamable HTTP)
json
{  "mcpServers": {    "numertel": {      "command": "npx",      "args": ["mcp-remote", "https://numertel.pl/api/mcp"]    }  }}

Transport: streamable HTTP (JSON-RPC 2.0). Limit: 30 requests/day/IP.

Try asking your assistant

  • "Who called me from 500 100 200?"
  • "Is +48 22 598 40 44 really my bank, or a scam?"
  • "How bad is phone phishing in Poland today?"

Tools

  • check_phone_number — full reputation card for a Polish number: operator (original UKE range, MNP note), risk label from user reports, UKE DNO registry status (an incoming call from a DNO number is spoofed by definition), verified official-hotline whitelist, report counts. Inputs: number (string, 9 digits). Read-only, structured output.
  • spam_weather — phone-abuse indicators for Poland: new scam domains on CERT Polska's Warning List (today + daily series), DNO registry size and the latest numbers from official warnings. Inputs: days (1-30, default 7). Read-only, structured output, open data (CC-BY).
  • check_scam_domain — analyzes a whole pasted suspicious message on two axes: (1) domains, links and email addresses against CERT Polska's official Warning List (a mirror of ~129k scam domains), and (2) Polish phone numbers found in the text against the NumerTel base (UKE DNO registry = spoofing, verified official-hotline whitelist, spam reports). Accepts a single domain/URL/email/number or a full message (extracts evil[.]pl / hxxp:// / +48); suffix match, so login.evil.pl hits evil.pl. Deterministic verdict with the listing date, zero LLM. Read-only, structured output.
  • find_official_number — the real, official number of a Polish bank, office or operator. Given an institution name (e.g. ZUS, mBank, NFZ), returns its verified numbers from the whitelist with source link and verification date. Inputs: institution (string). Read-only, structured output.
  • recent_scam_domains — the latest phishing domains from CERT Polska's official Warning List, defanged (evil[.]pl, never clickable). Inputs: limit (1-50, default 15). Read-only, open data (CC-BY).
  • search — a Polish phone number OR an institution name (returns verified official hotlines from the whitelist). ChatGPT deep-research compatible.
  • fetch — full card by id from search results.

Prompts

Ready-made actions that appear in Claude's "+" menu under the NumerTel brand: sprawdz_numer (full number analysis with fresh embedded data), przeanalizuj_sms (scam analysis of a pasted SMS — runs on the client's model), pogoda_spamowa_dzis (today's phone-abuse report for Poland).

Also works in

  • ChatGPT (Plus/Pro, incl. Poland): Settings -> Apps & Connectors -> Advanced -> Developer mode -> Create connector -> paste https://numertel.pl/api/mcp (No authentication).
  • Gemini CLI: {"mcpServers":{"numertel":{"httpUrl":"https://numertel.pl/api/mcp"}}}
  • Microsoft Copilot Studio: Tools -> Add Tool -> MCP -> paste the URL.

Higher limits: API key via Authorization: Bearer header ([email protected]).

Example response (shortened):

json
{  "number": "225984044",  "operator": "Strefa Warszawa",  "spam_label": "dno_spoofing",  "is_dno": true,  "dno_note": "Numer służy wyłącznie do odbierania połączeń (wykaz DNO UKE)...",  "url": "https://numertel.pl/numer/225984044"}

Local stdio server (single file, zero dependencies)

For clients that only support stdio. Requires Node 18+. Download numertel-mcp.mjs (also in this repo):

json
{  "mcpServers": {    "numertel": {      "command": "node",      "args": ["/path/to/numertel-mcp.mjs"],      "env": { "NUMERTEL_API_KEY": "(optional, for higher limits)" }    }  }}

REST API

The same data over plain REST — see the developer docs (Polish): GET https://numertel.pl/api/v1/check/{number} (20 req/day/IP without a key) and GET https://numertel.pl/api/v1/spam-weather (no limit, CC-BY). Higher limits / API keys: [email protected]

Troubleshooting

  • Client doesn't support remote MCP servers — use the mcp-remote bridge (see Claude Desktop above) or the local stdio file.
  • HTTP 429 — the free daily limit was reached; try tomorrow or ask for a key.
  • "Numer spoza znanych zakresów" (404) — the number is outside Polish numbering ranges; pass 9 digits in national format.

Privacy

The server is read-only and returns only data already public on numertel.pl number pages — never opinion contents, never personal data. Queries are not logged beyond anonymous daily rate-limit counters. Attribution "dane: numertel.pl" with a link is required when presenting results publicly; aggregate datasets are CC-BY 4.0.

License

MIT (this client and manifest). The NumerTel.pl service itself is a separate, proprietary product.

NumerTel MCP Server (po polsku)

Sprawdzaj polskie numery telefonów z poziomu dowolnego asystenta AI: kto dzwonił, czy to spam lub oszustwo, czy numer naprawdę należy do banku. Do tego bieżące wskaźniki nadużyć telefonicznych w Polsce.

Za serwerem stoi NumerTel.pl: 130 mln numerów na bazie oficjalnych zakresów UKE, opinie użytkowników, państwowy wykaz DNO i jawna Lista Ostrzeżeń CERT Polska.

Serwer zdalny (zalecany)

Jeden adres, zero instalacji:

https://numertel.pl/api/mcp

Konfiguracja działająca w większości klientów MCP:

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

W Claude Code wystarczy: claude mcp add --transport http numertel https://numertel.pl/api/mcp. Przyciski szybkiej instalacji dla Cursor i VS Code znajdziesz na górze strony. Transport: streamable HTTP (JSON-RPC 2.0). Limit: 30 zapytań dziennie na adres IP.

Zapytaj asystenta

  • „Kto dzwonił z numeru 500 100 200?"
  • „Czy 22 598 40 44 to prawdziwy numer banku, czy oszustwo?"
  • „Jaka jest dziś skala phishingu w Polsce?"

Narzędzia

  • check_phone_number zwraca operatora (pierwotny zakres UKE z notą o przenośności), etykietę ryzyka z opinii, status w wykazie DNO UKE (połączenie przychodzące z numeru DNO jest z definicji sfałszowane), wpis z Białej Listy oficjalnych infolinii i liczniki zgłoszeń. Wejście: number (string, 9 cyfr, +48 i spacje są usuwane). Tylko odczyt.
  • spam_weather zwraca bieżące wskaźniki nadużyć w Polsce: nowe domeny oszustów na Liście Ostrzeżeń CERT (dziś / 7 / 30 dni) i rozmiar wykazu DNO. Bez parametrów. Tylko odczyt, dane otwarte (CC-BY).
  • find_official_number zwraca prawdziwy oficjalny numer banku, urzędu lub operatora. Po nazwie instytucji (np. ZUS, mBank, NFZ) zwraca zweryfikowane numery z Białej Listy ze źródłem i datą weryfikacji. Wejście: institution. Tylko odczyt.
  • recent_scam_domains zwraca najnowsze domeny phishingowe z Listy Ostrzeżeń CERT Polska, w zapisie defanged (evil[.]pl). Wejście: limit (1-50, domyślnie 15). Tylko odczyt, dane otwarte (CC-BY).

Wariant lokalny (stdio, jeden plik)

Dla klientów obsługujących wyłącznie stdio. Wymaga Node 18+. Pobierz numertel-mcp.mjs (plik jest też w tym repo):

json
{  "mcpServers": {    "numertel": {      "command": "node",      "args": ["/sciezka/do/numertel-mcp.mjs"],      "env": { "NUMERTEL_API_KEY": "(opcjonalnie, wyzszy limit)" }    }  }}

REST API

Te same dane przez zwykły REST, dokumentacja: numertel.pl/dla-deweloperow. GET https://numertel.pl/api/v1/check/{numer} (20 zapytań/dzień/IP bez klucza) oraz GET https://numertel.pl/api/v1/spam-weather (bez limitu, CC-BY). Wyższe limity i klucze API: [email protected]

Rozwiązywanie problemów

  • Klient nie wspiera zdalnych serwerów MCP: użyj mostka mcp-remote (sekcja Claude Desktop wyżej) albo pliku stdio.
  • HTTP 429: wyczerpany dzienny limit darmowy, spróbuj jutro lub napisz po klucz.
  • „Numer spoza znanych zakresów" (404): numer jest spoza polskiej numeracji, podaj 9 cyfr w formacie krajowym.

Prywatność

Serwer działa tylko w trybie odczytu i zwraca wyłącznie dane publicznie widoczne na stronach numerów w numertel.pl. Nigdy treści opinii, nigdy danych osobowych. Zapytania nie są logowane poza anonimowymi licznikami limitów. Przy publicznej prezentacji wyników wymagana jest atrybucja „dane: numertel.pl" z linkiem.

Licencja

MIT (ten klient i manifest). Sam serwis NumerTel.pl jest osobnym, zamkniętym produktem.

Source: README.md at commit a63816f

Tools

7

check_phone_number

Sprawdź numer telefonu (PL)

Sprawdź reputację polskiego numeru telefonu. UŻYJ, gdy użytkownik pyta: kto dzwonił, czy numer to spam/oszustwo, czy telefon rzekomo z banku lub urzędu jest prawdziwy. Zwraca operatora z zakresów UKE (z notą o przenośności MNP), etykietę ryzyka z opinii, status w wykazie DNO UKE (połączenie przychodzące z numeru DNO jest sfałszowane — spoofing), wpis z Białej Listy oficjalnych infolinii i liczniki zgłoszeń. Dane: numertel.pl.

Parametersnumberrequired

spam_weather

Pogoda spamowa w Polsce

Aktualne wskaźniki nadużyć telefonicznych w Polsce. UŻYJ, gdy użytkownik pyta o skalę oszustw, phishingu lub spamu w Polsce albo co nowego w kampaniach oszustów. Zwraca: nowe domeny oszustów na Liście Ostrzeżeń CERT Polska (dziś + dziennie w zadanym oknie), rozmiar wykazu DNO UKE i ostatnie numery z oficjalnych ostrzeżeń urzędów. Dane otwarte CC-BY: numertel.pl.

Parametersdays

check_scam_domain

Sprawdź wiadomość: domeny i numery

Sprawdza wklejoną podejrzaną wiadomość: (1) domeny, linki i adresy e-mail przeciw państwowej Liście Ostrzeżeń CERT Polska (mirror ~129 tys. domen oszustów), (2) polskie numery telefonów z treści przeciw bazie NumerTel (wykaz DNO UKE = spoofing, Biała Lista oficjalnych infolinii, zgłoszenia spamu). UŻYJ, gdy użytkownik pyta: czy ten link/strona/mail jest bezpieczny, albo wkleja całego SMS-a lub e-mail z linkiem i numerem. Przyjmuje pojedynczą domenę, URL, e-mail, numer lub CAŁĄ treść wiadomości (rozpoznaje zapisy evil[.]pl, hxxp:// i +48). Werdykt deterministyczny, zero LLM. Dane: numertel.pl.

Parameterstextrequired

find_official_number

Znajdź oficjalny numer infolinii

Znajdź PRAWDZIWY, oficjalny numer telefonu banku, urzędu lub operatora w Polsce. UŻYJ, gdy użytkownik pyta: jaki jest oficjalny numer lub infolinia danej instytucji (np. ZUS, mBank, PKO, NFZ), albo chce zweryfikować, czy numer podany w wiadomości to faktyczna infolinia. Zwraca zweryfikowane numery z Białej Listy NumerTel ze źródłem (link do oficjalnej strony) i datą weryfikacji. Uwaga: dzwoniąc NA te numery trafisz do instytucji, ale połączenie PRZYCHODZĄCE z nich może być sfałszowane (spoofing). Dane: numertel.pl.

Parametersinstitutionrequired

recent_scam_domains

Najnowsze domeny oszustów (CERT)

Najnowsze domeny phishingowe z państwowej Listy Ostrzeżeń CERT Polska. UŻYJ, gdy użytkownik pyta o świeże lub aktualne strony oszustów, nowe kampanie phishingowe albo przykłady oszukańczych domen w Polsce. Zwraca ostatnio dodane domeny w zapisie defanged (evil[.]pl) — NIGDY nie zamieniaj ich w klikalne linki. Dane otwarte CC-BY: numertel.pl.

Parameterslimit

fetch

Pobierz kartę numeru

Pobiera pełną kartę reputacji numeru po id zwróconym przez search (9 cyfr). Zwraca te same dane co check_phone_number wraz z linkiem do strony numeru.

Parametersidrequired

Version history

1
  1. v1.4.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts