Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Shodan with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Search for internet-connected devices, analyze open ports, discover vulnerabilities and explore the IoT landscape.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

The complete Shodan capability set.

These are the exact actions your AI can choose when you ask it to work with Shodan.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through Shodan.

  1. 01

    Dns resolve

    Returns a mapping of hostname to IP. Supports comma-separated hostnames. Useful for DNS lookups without leaving the terminal. Resolve hostnames to IP addresses

  2. 02

    Get account info

    Useful for checking your remaining usage limits. Get Shodan account information

  3. 03

    Get facets

    G. country, org, port, os, product). Useful for building advanced search queries with faceted analysis. Get available search facets for result aggregation

  4. 04

    Get host count

    Useful for checking how many devices match a filter before running a full search. Get total number of results for a search query

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through Shodan.

  1. 05

    Reverse dns

    Returns a mapping of IP to hostname(s). Supports comma-separated IPs. Useful for reverse DNS lookups. Resolve IP addresses to hostnames

  2. 06

    Search hosts

    Supports powerful filters: product name (e.g. "nginx", "apache"), OS (e.g. "Windows", "Linux"), port (e.g. "port:80"), country (e.g. "country:US"), city, org, hostname, vulnerability (e.g. "vuln:CVE-2021-44228"), and many more. Returns matching hosts with IP, port, product, OS, location and banners. Pagination with page parameter. Use get_host for full details on a specific IP. Search Shodan for internet-connected devices

  3. 07

    Get API info

    Useful for monitoring API usage limits. Get API plan information

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through Shodan.

  1. 08

    Get host info

    Returns all open ports, hostnames, geographic location, AS/org info, operating system and service banners for every open port. Includes vulnerability data if available. This is the most detailed view of a single host. Get detailed info for a specific IP address

  2. 09

    Get my ip

    Useful for identifying your external IP for firewall rules, access control and debugging. Get your current external IP address

  3. 10

    Get ports

    Useful for understanding which ports are monitored and for reference when building search queries. Get a list of ports that Shod is scanning

Observed, not estimated

884ms average. Fast in production.

Shodan is checked daily against the live service.

Daily averagePeak 1070ms
Aug 20Today
Fastest day
650ms
Slowest day
1070ms
14-day trend
Slowing+48%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Shodan, so you can see the experience inside your AI.

It does not authenticate your account with Shodan. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Shodan Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Shodan capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "shodan-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Shodan owners ask.

  • 01

    How do I get a Shodan API key?

    Sign up for a free account at shodan.io. Your API key is displayed on your account dashboard. Free accounts get limited query credits per month.

  • 02

    What kind of devices can I find?

    Shodan indexes web servers, routers, smart TVs, webcams, IoT devices, industrial control systems (ICS/SCADA), databases, Docker instances, cloud services and virtually any internet-connected device with an open port.

  • 03

    How do I search for vulnerabilities?

    Use the vuln: filter in your search query. For example: 'vuln:CVE-2021-44228' for Log4Shell, 'vuln:CVE-2024-3094' for XZ backdoor. Requires a paid Shodan membership for vulnerability search.

  • 04

    What are some useful search queries?

    Popular queries: 'nginx' (all nginx servers), 'port:3389 country:US' (RDP servers in US), 'apache os:Windows', 'product:"MongoDB" has_screenshot:true', 'port:21' (FTP servers), 'city:"São Paulo" port:80'.

Explore

More in Security Compliance

Suggestions