# osintverse-community/abuseipdb

Checks an IP address in AbuseIPDB: abuse confidence score, reports and what for, ISP, usage type, Tor, country

## Install and run

```sh
ot install osintverse-community/abuseipdb
ot run osintverse-community/abuseipdb ip:8.8.8.8
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/abuseipdb","inputs":{"ip":"8.8.8.8"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `ip` | ip | yes |  |  |
| `days` | integer | no | `90` | Count only reports from this many days back (1 to 365) |

## Outputs

Finds: ip, organization, domain, location.

- `ip`: The address with its abuse confidence score, report counts, categories and latest reports
- `organization`: The network operator (ISP)
- `domain`: The operator's domain and the address's reverse DNS names

## What a run does

- Does not contact the target.
- Does not collect personal data.
- Needs an account (it logs in, or uses an account or API key of yours).
- Does not notify the target.
- Usually takes about 2 seconds.
- Connects to api.abuseipdb.com.

An agent needs the person's consent before running this tool, because it uses the person's own account or API key. See https://otinstaller.com/docs/agents#consent.

## API keys

- `ABUSEIPDB_API_KEY` (required, free tier): Your AbuseIPDB API key; the free plan allows 1,000 checks a day, for non-commercial use Get one at https://www.abuseipdb.com/account/api

Store a key with `ot keys set NAME`; it stays in the OS keychain.

## Trust

- Latest version: 0.1.0
- Signed: yes
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/abuseipdb

## Links

- Web page: https://otinstaller.com/osintverse-community/abuseipdb
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/abuseipdb
- README: https://github.com/osintverse-community/abuseipdb#readme
- Security details: https://otinstaller.com/osintverse-community/abuseipdb/security
- Report a problem: https://otinstaller.com/osintverse-community/abuseipdb/report