Phone Lookup

io.github.ktozvonilPublished by GitHub account ktozvonilv1.0.2Updated Oct 24, 2026

Who-called phone lookups: community verdict, spam rating, operator and reviews (ktozvonil.net).

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingCommunication & Collaboration

Overview

AI-generated overview

Looks up phone numbers on ktozvonil.net for community verdicts, spam ratings, operator, region and reviews, and can post AI-labelled reviews with OAuth.

What you can do
Look up a phone number for its community verdict, rating, spam level, operator, region, tags and recent reviews, with no authentication needed for lookups. Post a review for a number on behalf of an authenticated user, requiring an OAuth access token with the write scope. Reviews posted this way are labelled AI-agent-generated, shown in a separate section, and do not affect the community rating or verdict.
When to use it
Useful when an assistant needs to answer questions like who called from a given number, or check whether a number is reported as spam, especially for Ukrainian numbers. Add it if you also want the assistant to submit reviews to the service under your account.
Requirements
Runs as a remote endpoint at ktozvonil.net/mcp, or locally via npx with the npm package mcp-server-ktozvonil over stdio. Node.js is needed for the local option. Posting reviews needs an OAuth bearer token with the write scope, supplied through the KTOZVONIL_TOKEN environment variable; the endpoint can be overridden with KTOZVONIL_MCP_URL. Network access to ktozvonil.net is required.
Before you install
Lookups send the queried phone numbers to the third-party service ktozvonil.net. Posting reviews writes data to that service on behalf of your account and requires an OAuth token with write scope, so treat KTOZVONIL_TOKEN as a secret. Posted reviews are marked as AI-agent-generated and shown separately, and do not change the community rating.

Installation

In SourceWeft

  1. Open Phone Lookup 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/io.github.ktozvonil%2Fphone-lookup/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": {
    "phone-lookup": {
      "type": "http",
      "url": "https://ktozvonil.net/mcp"
    }
  }
}

README

mcp-server-ktozvonil

MCP (Model Context Protocol) server for ktozvonil.net — a community phone-number reputation service for Ukraine and beyond. Ask your AI assistant "who called me from 050 110 89 01?" and it will answer with the community verdict, spam rating, operator, region, tags and recent reviews.

This package is a thin stdio bridge to the site's native MCP endpoint (https://ktozvonil.net/mcp). Tools are discovered at startup, so the package never goes stale.

Tools

ToolDescriptionAuth
lookup_phoneCommunity verdict, rating, spam level, operator, region, tags and recent reviews for a numbernone
post_commentPost a review on behalf of an authenticated user (labelled as AI-agent-generated, shown separately, does not affect the community rating)OAuth bearer

Install

Claude Code

bash
claude mcp add ktozvonil -- npx -y mcp-server-ktozvonil

Claude Desktop

json
{  "mcpServers": {    "ktozvonil": {      "command": "npx",      "args": ["-y", "mcp-server-ktozvonil"]    }  }}

Cursor / Windsurf / other MCP clients

Any client that speaks stdio MCP works the same way: command npx, args -y mcp-server-ktozvonil.

Remote (no install)

MCP clients that support remote servers can skip this package entirely and connect straight to:

https://ktozvonil.net/mcp

Configuration

Env varMeaning
KTOZVONIL_MCP_URLOverride the endpoint URL (default https://ktozvonil.net/mcp)
KTOZVONIL_TOKENOAuth bearer token — only needed for post_comment. Discovery: /.well-known/oauth-protected-resource

Example

User: Кто звонил с +38 050 110 89 01?

Assistant: (calls lookup_phone) This number has a "spam" community verdict on ktozvonil.net: 78 reports, mostly "intrusive advertising"…

Development

bash
npm installnpm run buildnpm test

Related

License

MIT © ktozvonil.net

Source: README.md at commit b682a64

Tools

2

lookup_phone

Look up a phone number on ktozvonil.net: community verdict, rating, spam level, operator, region, tags and recent reviews.

Parametersnumberrequired

post_comment

Post a phone-number review on behalf of the authenticated user. Requires an OAuth access token with the "write" scope (discover via /.well-known/oauth-protected-resource). The review is labelled AI-agent-generated, shown in a separate section, and does NOT affect the community rating or verdict.

Parameterstextrequirednumberrequiredratingrequired

Version history

1
  1. v1.0.2LatestSep 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