# Ipquery

> Ipquery is a freemium MCP server for security. MCP server for IP geolocation, ISP/ASN lookup and VPN/proxy risk scoring. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/ipquery
- **Repository:** https://github.com/pipeworx-io/mcp-ipquery
- **MCP Registry name:** io.github.pipeworx-io/ipquery
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

The README describes two tools: one returns full intelligence for an IPv4 or IPv6 address, covering location fields, ISP and ASN ownership, and flags for VPN, proxy, Tor, datacenter or mobile networks. The second focuses on fraud and security, returning a 0-100 risk score and a one-line assessment of whether an address looks like an anonymizer, bot host or clean residential connection.

The server is a hosted endpoint on the Pipeworx gateway, reached over streamable HTTP or through a local npm stdio bridge. Both tools are listed as keyless. Calls without an API key are capped at 50 per day, and a free Pipeworx account raises that to 200.

The README notes that the endpoint also exposes shared gateway meta-tools such as ask_pipeworx alongside the two IP tools. It is suited to developers and agent builders who need IP checks for fraud screening, login risk or traffic analysis inside an MCP client.

## Features

- **IP geolocation details:** Returns country, city, region, postal code, coordinates and timezone for an IPv4 or IPv6 address.
- **ISP and ASN ownership:** Reports the ISP, ASN, organisation and network range tied to an IP address.
- **Anonymizer detection:** Flags whether an address is a VPN, proxy, Tor exit, datacenter or mobile network.
- **Risk scoring:** Gives a 0-100 risk score with a one-line assessment of the address.
- **Keyless use:** Both tools work without an API key, subject to the daily anonymous call cap.

## Good for

- Screen signups or logins for traffic from VPNs, proxies or Tor exits
- Check whether a visitor IP belongs to a datacenter or a residential connection
- Enrich server logs with country, city and ISP details for an IP
- Let an AI agent answer questions about the ownership of a given IP address

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ipquery https://gateway.pipeworx.io/ipquery/mcp
```

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

```sh
https://gateway.pipeworx.io/ipquery/mcp
```

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

```json
{
  "mcpServers": {
    "ipquery": {
      "url": "https://gateway.pipeworx.io/ipquery/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "ipquery": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/ipquery/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ipquery": {
      "serverUrl": "https://gateway.pipeworx.io/ipquery/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ipquery": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/ipquery/mcp"
    }
  }
}
```

## Tools

- `lookup_ip`: Full IP intelligence for an IPv4 or IPv6 address, including geolocation, ISP/ASN and risk flags.
- `check_risk`: Fraud and security view of an IP with a 0-100 risk score and one-line assessment.

## FAQ

### Does the server need an API key?

The README says both IP tools are keyless. Without a Pipeworx API key, calls are anonymous and capped at 50 per day; a free account raises the cap to 200 per day.

### Which IP versions are supported?

The listing says the tools accept any IPv4 or IPv6 address.

### What does the risk check return?

The check_risk tool returns VPN, proxy, Tor, datacenter or mobile flags, a 0-100 risk score and a one-line assessment.

### Can I run it locally?

Yes. The npm package @pipeworx/mcp-ipquery runs as a local stdio bridge, but the README says it still requires network access to the Pipeworx gateway.

### Is Ipquery free?

Ipquery has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Ipquery to Claude Code?

Run this command in your terminal: claude mcp add --transport http ipquery https://gateway.pipeworx.io/ipquery/mcp

### What are the best alternatives to Ipquery?

The closest alternatives to Ipquery are IPGeolocation.io MCP Server, IPDetective MCP by usefulapi, ipapi.is MCP by usefulapi, My IP Help and IPinfo.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [IPGeolocation.io MCP Server](https://ai-powered.com/mcp/ipgeolocation-io-mcp-server): IPGeolocation.io MCP Server is a freemium MCP server for developer tools.
- [IPDetective MCP by usefulapi](https://ai-powered.com/mcp/ipdetective-mcp-by-usefulapi): IPDetective MCP by usefulapi is a freemium MCP server for security.
- [ipapi.is MCP by usefulapi](https://ai-powered.com/mcp/ipapi-is-mcp-by-usefulapi): ipapi.is MCP by usefulapi is a freemium MCP server for security.
- [My IP Help](https://ai-powered.com/mcp/my-ip-help): My IP Help is a freemium MCP server for security.
- [IPinfo](https://ai-powered.com/mcp/ipinfo): IPinfo is a freemium MCP server for security.
- [InternetData](https://ai-powered.com/mcp/internetdata): InternetData is a freemium MCP server for analytics and data.
- [Isc Sans](https://ai-powered.com/mcp/isc-sans): Isc Sans is a freemium MCP server for security.
- [Maskbreak](https://ai-powered.com/mcp/maskbreak): Maskbreak is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/ipquery
