An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Shodan to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Map the global attack surface through natural conversation.

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

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through Shodan.

  1. 01

    Dns resolve

    Resolves hostnames to IP addresses. It handles comma-separated hostnames to map domains to their underlying IPs.

  2. 02

    Get account info

    Retrieves your Shodan account details. Use this to check your remaining query credits and current plan status.

  3. 03

    Get facets

    Provides available search facets for result aggregation. It helps your agent build better queries by identifying available filters like country, org, or port.

  4. 04

    Get host count

    Returns the total number of devices matching a specific filter. This lets your agent check the scale of a search before pulling full results.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through Shodan.

  1. 05

    Reverse dns

    Maps IP addresses back to hostnames. It supports multiple IPs at once for quick reverse lookups.

  2. 06

    Search hosts

    Searches the Shodan database for connected devices. You can filter by product, OS, port, country, or specific vulnerabilities.

  3. 07

    Get API info

    Checks your API plan details. This is how your agent monitors its own usage limits.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through Shodan.

  1. 08

    Get host info

    Provides a deep dive into a specific IP address. It returns open ports, service banners, location, and any known vulnerabilities.

  2. 09

    Get my ip

    Identifies your current external IP address. This is useful for verifying firewall rules or debugging connectivity.

  3. 10

    Get ports

    Lists the ports that Shodan actively scans. Use this to understand which services are being monitored across the internet.

Real work

What teams actually run

01

Attack Surface Auditing

Ask your agent to find all devices in your organization that are running outdated software versions.

02

IoT Trend Analysis

Have your agent count how many specific smart devices are active in a certain country.

03

IP Intelligence

Quickly pull the location and service details for an unknown IP address during an incident.

04

DNS Investigation

Use the agent to resolve hostnames and perform reverse DNS lookups as part of a network audit.

Automate a task

Put Shodan to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Shodan works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Shodan to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

967ms average. Fast in production.

Shodan is checked daily against the live service.

Daily averagePeak 1278ms
Oct 3Today
Fastest day
693ms
Slowest day
1278ms
14-day trend
Slowing+26%

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

Guided setup for Claude? Set up Shodan in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Shodan owners hand off.

This MCP is built for professionals who need to interact with global network data without manual querying.

  • 01

    Security Researchers

    They use the agent to find exposed services and analyze attack surfaces.

  • 02

    Sysadmins

    They use it to monitor their own organization's exposed services and check for misconfigurations.

  • 03

    IoT Analysts

    They use the agent to map the distribution and trends of internet-connected devices.

FAQ

Questions Shodan owners ask.

  • 01

    Do I need a Shodan account?

    Yes, you need a Shodan API key. You can get one by registering at shodan.io.

  • 02

    Which AI clients can I use with this MCP?

    You can use this with any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 03

    How does Vinkius handle my Shodan credentials?

    Vinkius hosts the MCP and manages your credentials securely so you only have to connect once.

  • 04

    Can I search for specific vulnerabilities?

    Yes, you can ask your agent to find hosts matching specific CVEs or vulnerability identifiers.

  • 05

    Can I see how many credits I have left?

    Yes, you can ask your agent to check your account info to see your remaining usage limits.

  • 06

    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.

  • 07

    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.

  • 08

    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.

  • 09

    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

Connect Shodan to Claude, Cursor, ChatGPT & more