`lookup_ip`

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

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