mcp-server-ktozvonil

MCP serverDev tools

phone-lookup connects your AI to ktozvonil.net, a who-called database, so it can check any phone number before you answer or call back. Your AI can tell you whether the community considers the number spam, how it is rated, which operator it belongs to, and what reviewers have said about it.

Then ask your AI: use the lookup phone tool from mcp-server-ktozvonil

Details

Available today. Use it as a step in a pipeline you build, or from your connected AI.

Add phone-lookup, then give your AI a number you want checked and ask it to look it up on ktozvonil.net.

What your AI can do with it

  • Check who called from an unknown phone number
  • Get the community verdict on whether a number is spam
  • See a number's spam rating
  • Identify the operator behind a number
  • Read reviews other people left about a number

Install mcp-server-ktozvonil

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user mcp-server-ktozvonil 'https://ktozvonil.net/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://ktozvonil.net/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=mcp-server-ktozvonil&config=eyJ1cmwiOiJodHRwczovL2t0b3p2b25pbC5uZXQvbWNwIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://ktozvonil.net/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add mcp-server-ktozvonil --url 'https://ktozvonil.net/mcp'

    Run it once, then sign in with codex mcp login mcp-server-ktozvonil if the server asks for an account.

From the project's README

As published by ktozvonil/mcp-server-ktozvonil in README.md.

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

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

Claude Desktop

{
  "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

npm install
npm run build
npm test

Related

License

MIT © ktozvonil.net

Tools it offers (2)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • lookup_phone
  • post_comment

Signals

Last commit
Aug 2026
Weekly downloads
47
Advanced
Delivery
phone-lookup MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-ktozvonil-phone-lookup
Source
github.com/ktozvonil/mcp-server-ktozvonil
Hosted endpoint
https://ktozvonil.net/mcp