`check_ip`

Pack: abuseipdb · Endpoint: https://gateway.pipeworx.io/abuseipdb/mcp

Check an IP address against the AbuseIPDB database. Returns abuse confidence score (0-100), ISP, usage type, country, number of reports, and last reported date. Example: check_ip(“8.8.8.8”).

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	AbuseIPDB API key
`ip`	string	yes	IPv4 or IPv6 address to check (e.g., “118.25.6.39”)

Example call

Arguments

{
  "_apiKey": "your-abuseipdb-api-key",
  "ip": "118.25.6.39"
}

curl

curl -X POST https://gateway.pipeworx.io/abuseipdb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_ip","arguments":{"_apiKey":"your-abuseipdb-api-key","ip":"118.25.6.39"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('check_ip', {
  "_apiKey": "your-abuseipdb-api-key",
  "ip": "118.25.6.39"
});

More examples

{
  "_apiKey": "your-abuseipdb-api-key",
  "ip": "8.8.8.8"
}

Response shape

Always returns: ip, is_public, abuse_confidence_score, country_code, isp, usage_type, domain, total_reports, last_reported_at

Field	Type	Description
`ip`	string	The IP address checked
`is_public`	boolean	Whether the IP is public
`abuse_confidence_score`	number	Abuse confidence score from 0-100
`country_code`	string	Country code of the IP
`isp`	string	Internet Service Provider name
`usage_type`	string	Type of IP usage (e.g., Commercial, Residential)
`domain`	string	Associated domain name
`total_reports`	number	Total number of abuse reports for this IP
`last_reported_at`	string \| null	ISO timestamp of last abuse report, or null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address checked"
    },
    "is_public": {
      "type": "boolean",
      "description": "Whether the IP is public"
    },
    "abuse_confidence_score": {
      "type": "number",
      "description": "Abuse confidence score from 0-100"
    },
    "country_code": {
      "type": "string",
      "description": "Country code of the IP"
    },
    "isp": {
      "type": "string",
      "description": "Internet Service Provider name"
    },
    "usage_type": {
      "type": "string",
      "description": "Type of IP usage (e.g., Commercial, Residential)"
    },
    "domain": {
      "type": "string",
      "description": "Associated domain name"
    },
    "total_reports": {
      "type": "number",
      "description": "Total number of abuse reports for this IP"
    },
    "last_reported_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of last abuse report, or null"
    }
  },
  "required": [
    "ip",
    "is_public",
    "abuse_confidence_score",
    "country_code",
    "isp",
    "usage_type",
    "domain",
    "total_reports",
    "last_reported_at"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "abuseipdb": {
      "url": "https://gateway.pipeworx.io/abuseipdb/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

check_ip