Skip to content
MCP server

Ipquery

MCP server for IP geolocation, ISP/ASN lookup and VPN/proxy risk scoring

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Ipquery

Ipquery is a freemium MCP server for security. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/ipquery/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ipquery": {
      "url": "https://gateway.pipeworx.io/ipquery/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous tier at 50 calls/day; free account at 200 calls/day; paid credits and subscriptions beyond that.

Prices change. Check pipeworx.io before you buy.

Ipquery 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.

How AIPoweredBot checks servers