io.github.ktozvonil/phone-lookup MCP Server

This MCP server provides a community phone-number reputation lookup. It returns a community verdict, spam rating, operator, region, tags, and recent reviews for a queried phone number. The documentation indicates it targets Ukraine and “beyond,” and is implemented as a thin stdio bridge to a native MCP endpoint at https://ktozvonil.net/mcp.

🛠️ Key Features

Community verdict for phone-number reports
Spam rating
Operator and region details
Tags and recent reviews
Tools discovered at startup to avoid staleness

🚀 Use Cases

Answer questions like “who called me from 050 110 89 01?”
Evaluate whether an incoming number is associated with spam or specific operators

⚡ Developer Benefits

Thin stdio bridge to the site’s native MCP endpoint (https://ktozvonil.net/mcp)
Tool discovery at startup so tool definitions stay current

⚠️ Limitations

Phone lookups are described as a community reputation service; exact coverage and output fields beyond the excerpt aren’t specified

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