Shodan Connector for AI agents.
10 live capabilities
Map internet-connected devices and analyze open ports for cybersecurity research.
Waiting for input…
Why people use Shodan
Shodan for Cybersecurity Threat Intelligence
This Connector changes the flow. You just tell your agent what you're looking for, like find all hosts running a specific version in a certain country. It pulls the data, gives you the banners, and lets you move straight to analysis. You get a conversational way to query the entire internet's attack surface.
What Vinkius changes
You get a conversational interface for one of the most powerful cybersecurity search engines available.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding exposed databases
A researcher asks the agent to find all exposed databases in a specific region to check for open ports and banners.
- Real-world use case 02
Checking for banner leaks
A sysadmin asks the agent to check if their web host is showing a specific software version banner to the public.
- Real-world use case 03
Mapping IoT trends
An analyst asks for the distribution of smart cameras in a specific country to identify regional infrastructure trends.
Complete set · 10capabilities
The complete Shodan capability set.
These are the exact actions your AI can choose when you ask it to work with Shodan.
01—04
4 capabilities in this set.
Part of 10 available through Shodan.
- 01 Capability
Get account info
Check your remaining Shodan query credits and account status. This helps you stay on top of your usage limits.
- 02 Capability
Get api info
Monitor your current API plan limits and usage details. It ensures you don't run out of credits during a task.
- 03 Capability
Dns resolve
Turn hostnames into IP addresses quickly without leaving your chat. It's great for rapid lookups during research.
- 04 Capability
Get facets
Get available filters to build more specific and targeted search queries. This helps refine your search results.
05—07
3 capabilities in this set.
Part of 10 available through Shodan.
- 05 Capability
Get host info
See every open port, location, and banner for a specific IP address. This provides the most detailed host view.
- 06 Capability
Get host count
See how many devices match your search criteria before you run the query. This saves you from wasting credits.
- 07 Capability
Get my ip
Find your current external IP address for firewall and access control rules. It's useful for quick debugging.
08—10
3 capabilities in this set.
Part of 10 available through Shodan.
- 08 Capability
Get ports
See a list of all ports that Shodan is currently scanning. Use this as a reference for building search queries.
- 09 Capability
Reverse dns
Map IP addresses back to their hostnames in a single step. This is helpful for identifying unknown host origins.
- 10 Capability
Search hosts
Find internet-connected devices using filters like product, OS, or country. It handles complex queries with ease.
Set up in minutes
One URL. Then ask Shodan to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Shodan from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Shodan, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Shodan for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Shodan URL.
- Step 03
Save and start
Save the connection and enable Shodan in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"shodan": {
"url": "https://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Shodan
Open Agent mode in chat and ask: "Using Shodan, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"shodan": {
"url": "https://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Shodan
Ask Copilot: "Using Shodan, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"shodan": {
"url": "https://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Shodan
Open Cascade and ask: "Using Shodan, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"shodan": {
"url": "https://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Shodan
Ask Cline: "Using Shodan, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add shodan --transport http "https://edge.vinkius.com/vk_preview_v56kfVzaldu64N35xQgpbhSkfmWiw9wRo7KH9Xgc/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Shodan
Ask Claude: "Using Shodan, show me...". 10 tools are ready
Where the request belongs
Work Shodan can move forward.
This is for security pros who need to map attack surfaces fast and sysadmins who need to know what's actually exposed to the public internet without manual scanning.
Security Researcher
Finds exposed services and analyzes CVE vulnerabilities across different regions to build threat maps.
Sysadmin
Monitors their own organization's open ports and checks for misconfigurations to harden their perimeter.
IoT Analyst
Maps out the distribution of smart devices across the globe to identify infrastructure trends.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsNmap Online
Perform network discovery and security auditing via Nmap. track port scans, DNS lookups, and traceroutes directly from your AI agent.
Intruder
Automate vulnerability scanning and security monitoring via Intruder.io API.
UpGuard
Monitor your attack surface and assess vendor security risks with continuous scanning that identifies vulnerabilities before attackers do.
Censys
Search internet-connected hosts, SSL certificates and attack surface. discover exposed services and vulnerabilities.
Rapid7 InsightVM
Equip your AI to interact directly with Rapid7 InsightVM, extracting vulnerability assessments, scanning network assets, and launching immediate scans.
CrowdSec
Automate threat intelligence via CrowdSec. query local decisions, stream security updates, and check global IP reputation directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Shodan connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Shodan.
The practical details behind the request, access and result.
What is the Shodan MCP for?
The Shodan MCP lets you search for internet-connected devices, analyze open ports, and discover vulnerabilities using natural language.
Can I use Shodan MCP for security research?
Yes, it's a primary capability for security researchers to map attack surfaces, find exposed services, and analyze banners across the globe.
How do I check my Shodan credits with this?
You can simply ask your agent to check your account info, and it will pull your remaining query credits and plan details automatically.
Can it find specific devices like cameras?
Yes, you can search for specific products like smart cameras, web hosts, or any other internet-connected hardware.
Does Shodan MCP do DNS lookups?
Yes, it can resolve hostnames to IP addresses and perform reverse DNS lookups without you needing to leave your current chat.
Can I find my own public IP address?
Yes, the Connector can identify your current external IP address, which is very helpful for configuring firewall rules or debugging access.
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.
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.
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.
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'.
One connection away
Give your agent a direct line to Shodan.
Connect Shodan once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available