# ipdata MCP by usefulapi

> ipdata MCP by usefulapi is an MCP server. Look up location, network, company and threat data for IP addresses and ASNs in ipdata. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/ipdata/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ipdata
- **MCP Registry name:** io.usefulapi/ipdata
- **Listing updated:** 2026-11-13

## About

Look up location, network, company and threat data for IP addresses and ASNs in ipdata.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ipdata https://ipdata.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ipdata.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ipdata": {
      "url": "https://ipdata.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ipdata": {
      "type": "http",
      "url": "https://ipdata.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ipdata": {
      "serverUrl": "https://ipdata.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ipdata": {
      "type": "http",
      "url": "https://ipdata.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `ipdata_lookup_ip`: Geolocation and network data for one IP address: city, region, country, continent, coordinates, postal code, time zone, currency, languages, mobile carrier, ASN, plus company and threat data where the key's plan includes them. Pass `fields` to get only some of it. The reply also carries `count`, the requests this key made in the last 24 hours. GET /{ip}. Uses 1 request of the key's daily ipdata qu
- `ipdata_get_threat`: Threat profile of one IP address: is_tor, is_proxy, is_anonymous, is_datacenter, is_known_attacker, is_known_abuser, is_threat, is_bogon, is_icloud_relay and the blocklists it appears on. Business and Enterprise plans also get is_vpn and reputation scores (vpn, proxy, threat and trust, 0-100). GET /{ip}/threat. Uses 1 request of the key's daily ipdata quota and is never retried.
- `ipdata_get_asn_for_ip`: The autonomous system that announces one IP address: AS number, organisation name, domain, network route and usage type (hosting, isp, edu, gov, mil, business). GET /{ip}/asn. Uses 1 request of the key's daily ipdata quota and is never retried.
- `ipdata_get_company`: The end-user organisation that a network is assigned to: name, domain, network prefix and usage type. Needs the ipdata Startup plan or higher. GET /{ip}/company. Uses 1 request of the key's daily ipdata quota and is never retried.
- `ipdata_lookup_asn`: Details of one autonomous system: organisation, domain, usage type, IPv4 and IPv6 prefixes, number of IPs, registry, country, allocation date, status, and upstream, downstream and peer AS numbers. GET /AS{number}. Uses 1 request of the key's daily ipdata quota and is never retried.
- `ipdata_bulk_lookup`: Look up up to 100 IP addresses in one call (paid ipdata plans only). Duplicates are removed first. Replies are a list in the same order, one entry per address. Each address uses 1 request of the daily quota (100 addresses = 100 requests). Use `fields` to keep the reply small. POST /bulk. The call is never retried.

## FAQ

### How do I add ipdata MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http ipdata https://ipdata.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/ipdata-mcp-by-usefulapi
