`lookup_ip`

Pack: shodan-internetdb · Endpoint: https://gateway.pipeworx.io/shodan-internetdb/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/lookup_ip for the schema, then POST the same URL with its arguments for the data.

Look up an IP address in the Shodan InternetDB. Returns open ports, hostnames, known vulnerabilities (CVEs), CPEs (software identifiers), and tags. Free, no API key needed. Example: lookup_ip(“8.8.8.8”).

Parameters

Name	Type	Required	Description
`ip`	string	yes	IPv4 address to look up (e.g., “8.8.8.8”)

Example call

Arguments

{
  "ip": "8.8.8.8"
}

curl

curl -X POST https://gateway.pipeworx.io/shodan-internetdb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lookup_ip","arguments":{"ip":"8.8.8.8"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('lookup_ip', {
  "ip": "8.8.8.8"
});

More examples

{
  "ip": "1.1.1.1"
}

Response shape

Always returns: ip, found, ports, hostnames, vulns, cpes, tags

Field	Type	Description
`ip`	string	The IPv4 address that was looked up
`found`	boolean	Whether the IP address was found in Shodan InternetDB
`ports`	array	List of open ports found on the IP address
`hostnames`	array	List of hostnames associated with the IP address
`vulns`	array	List of known CVE vulnerabilities for the IP address
`cpes`	array	List of CPE software identifiers found on the IP address
`tags`	array	List of tags associated with the IP address

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IPv4 address that was looked up"
    },
    "found": {
      "type": "boolean",
      "description": "Whether the IP address was found in Shodan InternetDB"
    },
    "ports": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "List of open ports found on the IP address"
    },
    "hostnames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of hostnames associated with the IP address"
    },
    "vulns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of known CVE vulnerabilities for the IP address"
    },
    "cpes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of CPE software identifiers found on the IP address"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of tags associated with the IP address"
    }
  },
  "required": [
    "ip",
    "found",
    "ports",
    "hostnames",
    "vulns",
    "cpes",
    "tags"
  ]
}

Connect

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

{
  "mcpServers": {
    "shodan-internetdb": {
      "url": "https://gateway.pipeworx.io/shodan-internetdb/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

lookup_ip