MCP server

Shodan

io.github.pipeworx-io/shodan

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Shodan MCP — wraps the full Shodan REST API (api.shodan.io)

Website Source

At a glance

Type

MCP server

Publisher

pipeworx.io (verified by the MCP Registry)

Status

Working at last check

Tools

45

Token cost

About 27,056 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.shodan]
url = "https://gateway.pipeworx.io/shodan/mcp"

Gemini CLI

{"mcpServers":{"shodan":{"httpUrl":"https://gateway.pipeworx.io/shodan/mcp"}}}

Cursor

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

VS Code

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

Antigravity

agy mcp add shodan https://gateway.pipeworx.io/shodan/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"shodan","server_url":"https://gateway.pipeworx.io/shodan/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"shodan","server_url":"https://gateway.pipeworx.io/shodan/mcp"}

Tools

• shodan_host ~225 tokens
  What's exposed on IP <ip> — open ports, services, and CVEs. Returns the full Shodan host profile: ports, hostnames, org/ISP, geolocation, OS, known vulnerabilities, and a per-service banner sample. Example: shodan_host({ ip: "8.8.8.8", _apiKey: "your-key" })
• shodan_host_count ~264 tokens
  Count hosts matching <query> with facet breakdown (free — this endpoint does not consume query credits). Returns the total match count plus optional facet aggregations (e.g. top countries, orgs, ports). Example: shodan_host_count({ query: "apache", facets: "country:10", _apiKey: "your-key" })
• shodan_host_search ~264 tokens
  Search Shodan for hosts matching <query> using Shodan search syntax (e.g. "apache country:US", "port:22 org:\"Google\""). Returns matching hosts with IP, port, org, hostnames, product, and location. Example: shodan_host_search({ query: "apache country:US", _apiKey: "your-key" })

Browse

• GitHub tools
• GitHub and code hosting
• APIs and testing

Related MCP servers

• Shodan Internetdb
  Shodan InternetDB MCP — wraps Shodan InternetDB (internetdb.shodan.io)
• EchelonGraph CVE & Exposure
  CVE, KEV, EPSS, SBOM and advisory lookups; per-CVE exposure from Shodan data (© Shodan). Keyless.
• Asana
  Asana MCP — wraps the Asana REST API (OAuth)
• Pipedrive
  Pipedrive MCP Pack — wraps the Pipedrive REST API v1
• ContrastAPI
  55 tools, 7 Resources, Sigma rules, email SPF/DMARC, MITRE, CVE/KEV, risk_score. No key.
• Confluence
  Confluence MCP — wraps the Confluence Cloud REST API v2 (OAuth)
• SiteCheck Web Intel
  129 pay-per-call agent tools: security, threat intelligence, web search and SEO data tools. x402
• Airtable
  Airtable MCP Pack — wraps the Airtable REST API v0

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.pipeworx-io/shodan.svg)](https://aptlynx.net/servers/io.github.pipeworx-io/shodan)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents