{
  "markdown": "# mcp-server-ktozvonil\n\nMCP (Model Context Protocol) server for **[ktozvonil.net](https://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.\n\nThis 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.\n\n## Tools\n\n| Tool | Description | Auth |\n|------|-------------|------|\n| `lookup_phone` | Community verdict, rating, spam level, operator, region, tags and recent reviews for a number | none |\n| `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 |\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add ktozvonil -- npx -y mcp-server-ktozvonil\n```\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"ktozvonil\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-ktozvonil\"]\n    }\n  }\n}\n```\n\n### Cursor / Windsurf / other MCP clients\n\nAny client that speaks stdio MCP works the same way: command `npx`, args `-y mcp-server-ktozvonil`.\n\n### Remote (no install)\n\nMCP clients that support remote servers can skip this package entirely and connect straight to:\n\n```\nhttps://ktozvonil.net/mcp\n```\n\n## Configuration\n\n| Env var | Meaning |\n|---------|---------|\n| `KTOZVONIL_MCP_URL` | Override the endpoint URL (default `https://ktozvonil.net/mcp`) |\n| `KTOZVONIL_TOKEN` | OAuth bearer token — only needed for `post_comment`. Discovery: [`/.well-known/oauth-protected-resource`](https://ktozvonil.net/.well-known/oauth-protected-resource) |\n\n## Example\n\n> **User:** Кто звонил с +38 050 110 89 01?\n>\n> **Assistant:** *(calls `lookup_phone`)* This number has a \"spam\" community verdict on ktozvonil.net: 78 reports, mostly \"intrusive advertising\"…\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test\n```\n\n## Related\n\n- [ktozvonil.net](https://ktozvonil.net) — the service itself (uk/ru/en + 5 more languages)\n- [`ua-phone`](https://github.com/ktozvonil/ua-phone) — Ukrainian phone number parsing/formatting library\n- API docs: [ktozvonil.net/.well-known/api-catalog](https://ktozvonil.net/.well-known/api-catalog)\n\n## License\n\nMIT © [ktozvonil.net](https://ktozvonil.net)\n",
  "bytes": 2408,
  "sha": "f03c782b8c1ffd96f0302f38747963e7af6b6910d716e8070af471def90cc9e4",
  "repo_slug": "ktozvonil/mcp-server-ktozvonil",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ktozvonil_phone_lookup_a83c58b2/readme"
}