io.github.ktozvonil/phone-lookup MCP Server

This MCP server provides “who-called” phone lookup functionality backed by community information. It describes callers via a community verdict, a spam rating, the phone operator, and related reviews. The referenced source for this data is ktozvonil.net.

🛠️ Key Features

Community verdict for phone numbers
Spam rating
Phone operator identification
Community reviews
Data source: ktozvonil.net

🚀 Use Cases

Checking the reputation of an unknown caller
Determining whether a phone number is likely spam
Reviewing operator and community feedback before answering

⚡ Developer Benefits

Structured lookup outputs aligned to verdict, spam rating, operator, and reviews
Clear data provenance via ktozvonil.net

⚠️ Limitations

Description provides no details on tooling, supported query formats, authentication, or response schema beyond the listed fields.

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.

Tool

Description

Auth

lookup_phone

Community verdict, rating, spam level, operator, region, tags and recent reviews for a number

none

post_comment

Post 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:

code

https://ktozvonil.net/mcp

Env var

Meaning

KTOZVONIL_MCP_URL

Override the endpoint URL (default https://ktozvonil.net/mcp)

KTOZVONIL_TOKEN

OAuth bearer token — only needed for post_comment. Discovery: /.well-known/oauth-protected-resource

io.github.ktozvonil/phone-lookup