{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_aq2pgcm3vgk4","handle":"mcp-server-abuseipdb","url":"https://wellknown.network/agents/mcp-server-abuseipdb","links":{"self":"https://wellknown.network/agents/mcp-server-abuseipdb/record.json","html":"https://wellknown.network/agents/mcp-server-abuseipdb","markdown":"https://wellknown.network/agents/mcp-server-abuseipdb/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-abuseipdb","status":"https://wellknown.network/api/v1/agents/mcp-server-abuseipdb/status","claim":"https://wellknown.network/agents/mcp-server-abuseipdb/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-abuseipdb/claim.json","badge":"https://wellknown.network/agents/mcp-server-abuseipdb/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-abuseipdb/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-abuseipdb/tools"},"ard":{"identifier":"urn:air::server:mcp-server-abuseipdb","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-abuseipdb","summary":"Official AbuseIPDB MCP server — check IP reputation from MCP clients","description":"# AbuseIPDB MCP\n\n<!-- mcp-name: io.github.abuseipdb/abuseipdb-mcp -->\n\nAbuseIPDB MCP is a small Model Context Protocol server for checking IP\nreputation from MCP clients such as Claude, Cursor, VS Code, Codex, and others.\nIt talks to the AbuseIPDB API v2 over HTTPS and exposes the results as MCP\ntools over stdio.\n\nCurrent server status: beta, stdio, read-only. Published on PyPI as\n[`mcp-server-abuseipdb`](https://pypi.org/project/mcp-server-abuseipdb/) and in\nthe [MCP Registry](https://registry.modelcontextprotocol.io) as\n`io.github.abuseipdb/abuseipdb-mcp`. A published Docker image is planned; see\n[Coming next](#coming-next).\n\n## What it does\n\n- Checks one public IPv4 or IPv6 address with `check_ip`.\n- Checks a batch of public IPs with `bulk_check` (cap configurable, default 100).\n- Returns AbuseIPDB confidence score, report count, country, ISP, usage type,\n  domain, last report time, risk tier, and a short plain-English summary.\n- Rejects hostnames, URLs, CIDR ranges, and private/reserved addresses by\n  default.\n- Returns structured errors for bad input, auth failures, timeouts, rate limits,\n  and AbuseIPDB API errors.\n- Publishes MCP tool annotations for read-only, idempotent, open-world calls.\n\nIt does not submit reports or fetch blacklists yet.\n\n## Requirements\n\n- Python 3.11+\n- [uv](https://docs.astral.sh/uv/)\n- An AbuseIPDB API key\n\n## Install\n\nThe distribution on PyPI is `mcp-server-abuseipdb`. It installs two equivalent\ncommands, `mcp-server-abuseipdb` and `abuseipdb-mcp` — use either. Most users do\nnot need to install anything ahead of time: `uvx` fetches and runs it on demand,\nwhich is the form every client example below uses.\n\nRun it once by hand to confirm your key works:\n\n```bash\nABUSEIPDB_API_KEY=your_key_here uvx mcp-server-abuseipdb\n```\n\nTo keep a persistent install on `PATH` instead:\n\n```bash\nuv tool install mcp-server-abuseipdb\n```\n\nThe server uses MCP stdio. It waits for JSON-RPC on stdin and looks idle when\nstarted from a terminal; that is expe…","publisher":{"name":"AbuseIPDB","url":null},"homepage":"https://github.com/AbuseIPDB/abuseipdb-mcp#readme","repository":"https://github.com/AbuseIPDB/abuseipdb-mcp#readme","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp","abuseipdb","security","threat-intelligence","ip-reputation"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-abuseipdb","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-server-abuseipdb","registry":"pypi","observedAt":"2026-10-28T13:24:43.287Z","publishedAt":"2026-08-03T00:23:30.400975Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-abuseipdb","url":"https://pypi.org/project/mcp-server-abuseipdb/","firstSeenAt":"2026-09-10T03:19:51.808Z","fetchedAt":"2026-10-28T13:22:56.209Z","normalizedAt":"2026-10-28T13:22:56.209Z"}]},"firstSeenAt":"2026-09-10T03:19:51.808Z","updatedAt":"2026-10-28T13:24:43.287Z"}