checkLABSCO SUMMARY
An address in a log becomes a judgement.
One tool, one question: is this address known for abuse, and how strong is the record behind that. The score arrives with the reports underneath it, so the answer can be argued with rather than only believed.
What it is
An MCP server over the AbuseIPDB API. Its check tool queries any IPv4 or IPv6 address for abuse reports and returns the confidence score with the report data behind it.
What you get
- Any IPv4 or IPv6 address queried for abuse reports
- An abuse confidence score from 0 to 100, based on report frequency and severity
- Report metadata and categories behind that score
- A configurable lookback window
- Concise or verbose output, whichever the answer needs
Requirements
An AbuseIPDB API key — the free tier is enough to start — plus Python 3.13 or higher and the uv package manager.
Setup effort
Build from source — git clone https://github.com/Salmanwz/mcp-abuseipdb.git
USE CASES
01
Triaging a suspicious address from a log
Pass the address and read the confidence score. A high score with recent reports settles the question in one call.
02
Deciding whether to block something at the firewall
Read the report categories, not just the score — what the address was reported for decides whether a block is proportionate.
03
Working out whether an address has a history or just a bad day
Widen the lookback window and see whether the reports cluster in one period or run continuously.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- Python 3.13 or later
- ABUSEIPDB_API_KEY in your environment
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
1. Clone the Repository
TERMINAL
git clone https://github.com/Salmanwz/mcp-abuseipdb.git
cd mcp-abuseipdb2. Install UV Package Manager
TERMINAL
curl -LsSf https://astral.sh/uv/install.sh | sh3. Install Dependencies
TERMINAL
uv add "mcp[cli]" httpxMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"abuseipdb": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_MCP_ABUSEIPDB>",
"run",
"abusedb.py"
],
"env": {
"ABUSEIPDB_API_KEY": "<YOUR_ABUSEIPDB_API_KEY>"
}
}
}
}Run standalone
RUN STANDALONE · TERMINAL
uv run abusedb.py
