Name: phone lookup
Author: ktozvonil

phone lookup 能做什么？

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

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

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 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`

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

ktozvonil.net — the service itself (uk/ru/en + 5 more languages)
ua-phone — Ukrainian phone number parsing/formatting library
API docs: ktozvonil.net/.well-known/api-catalog

License

MIT © ktozvonil.net

安装

把 phone lookup 添加到你的客户端。选择你正在使用的那个。

{
  "servers": {
    "mcp-server-ktozvonil": {
      "type": "http",
      "url": "https://ktozvonil.net/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

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

codex mcp add mcp-server-ktozvonil -- npx -y mcp-server-ktozvonil

amp mcp add mcp-server-ktozvonil -- npx -y mcp-server-ktozvonil

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

Add to `claude_desktop_config.json`, then restart Claude Desktop.

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

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

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

Add to `~/.codeium/windsurf/mcp_config.json`.

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

Add to `cline_mcp_settings.json` via the MCP Servers panel.

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

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "mcp-server-ktozvonil": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-ktozvonil"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "mcp-server-ktozvonil": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-server-ktozvonil"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y mcp-server-ktozvonil

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

2 个工具

phone lookup 向已连接的智能体提供 2 个工具。

lookup_phone: Community verdict, rating, spam level, operator, region, tags and recent reviews for a number
post_comment: Post a review on behalf of an authenticated user (labelled as AI-agent-generated, shown separately, does not affect the community rating)

评分

76 / 100

良好

文档22/25
维护19/25
可信度16/20
能力4/15
安装体验15/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 26 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
2 tool(s) documented
Provides prompt templates
Provides resources
18 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

查看完整评分标准 →

版本历史

版本	发布于
1.0.2最新	2026年8月5日