How to connect Shodan to Claude

Connect Claude Web, Desktop and Cowork to Shodan MCP. Search shodan for exposed apache servers, inspect shodan host details for 8.8.8.8, and more using natural language, with authentication handled for you.

Shodan logoShodan
Api Key

Shodan is an Internet intelligence service for discovering exposed devices and services. It helps security teams search host data and monitor network exposure.

45 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Shodan account to Claude via Composio Connect, enabling it to search Shodan for exposed Apache servers, inspect Shodan host details for 8.8.8.8, monitor Shodan network exposure for your assets, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Shodan with

Connecting Shodan to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Shodan account

Back in Claude, ask it to connect to Shodan or give it any Shodan-related task.

For example, ask Claude to:

  • "Search Shodan for exposed Apache servers"
  • "Inspect Shodan host details for 8.8.8.8"
  • "Monitor Shodan network exposure for your assets"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Shodan account is ready to use.

What is the Shodan Claude Connector, and what's possible with it?

The Shodan MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Shodan account. It provides structured and secure access to Shodan's internet intelligence, host data, network monitoring, scans, and account tools, so your agent can search exposed services, inspect hosts, monitor IP ranges, and investigate domains on your behalf.

  • Internet exposure discovery: Have your agent search Shodan for hosts and services matching specific queries, count matching hosts, and review service observations for individual IP addresses.
  • Domain and DNS investigation: Direct your agent to find subdomains and DNS records, resolve hostnames to IP addresses, or look up hostnames associated with IP addresses.
  • Network exposure monitoring: Let the agent create and manage monitoring alerts for IP addresses or CIDR ranges, configure alert triggers, and connect notification services for matching events.
  • On-demand scanning: Instruct your agent to request scans for selected IP addresses or CIDR ranges, submit internet-wide scans for supported ports and protocols, and check scan status.
  • Shodan account and search guidance: Have your agent review plan usage, account profile details, available search filters and facets, crawled ports, scan protocols, saved queries, and supported notifier providers.

Troubleshooting

1. Why does Claude not use the Composio connector for Shodan?

The connector can show as connected, but Claude must use it in each Shodan conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Shodan again.

2. Why does Claude show an MCP server error before Shodan connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Shodan.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Shodan.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Shodan authorization link not work?

The Composio connector is one server. Your Shodan account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Shodan connection.
  • Composio creates a fresh Shodan authorization link.
  • Open that link in your browser and finish the Shodan sign-in.

4. Why do Shodan actions fail after they worked before?

The Shodan connection can expire or lose permission.

  • Ask Claude to inspect the Shodan connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Shodan account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Shodan.
  • If the action still fails with a permission error, check that the connected account has that permission in Shodan itself.

5. How do I switch to a different Shodan account?

Claude can manage the Shodan connection for you.

  • Ask Claude to disconnect or delete the current Shodan account.
  • Ask Claude to connect Shodan again.
  • Open the new Composio authorization link for Shodan.
  • Sign in with the other Shodan account in the browser.
  • After the account connects, ask Claude to retry the Shodan task.

6. Why is my Shodan connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Shodan connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Shodan tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Shodan.
TOOLS

Supported Tools

Every Shodan action and event your agent gets out of the box.

Add Alert Notifier

Attach an existing notifier to a paid Shodan network alert.

Add Organization Member

Add a Shodan user to the connected Enterprise organization and upgrade their account, granting organization access.

Count Hosts

Count hosts matching a Shodan search query and optionally return facet counts, without returning banners or consuming query credits for a plain count.

Create Network Alert

Create continuous Shodan monitoring for specified IP addresses or CIDR ranges.

Create Notifier

Create a reusable Shodan notification destination.

Delete Network Alert

Permanently delete a Shodan network alert and stop monitoring its configured IP addresses or CIDR ranges.

Delete Notifier

Permanently delete a Shodan notification service.

Disable Alert Trigger

Disable one or more trigger rules on a paid Shodan network alert.

Enable Alert Trigger

Enable one or more trigger rules on a paid Shodan network alert.

Get Account Profile

Return membership status, credits, display name, username, creation time, and additional profile fields for the owner of the connected Shodan API key.

Get API Plan Information

Return the connected API key's Shodan plan, query and scan credits, monitored-IP allowance, usage limits, and unlocked protocol features.

Get Domain Information

Return one page of subdomains and DNS records for a domain.

Get Execution Egress IP

Return the public source IP address Shodan observes for this API request.

Get Host Information

Return Shodan's current or historical service observations for one IP address.

Get Network Alert

Get one Shodan network alert, including its filters, triggers, and attached notifiers.

Get Notifier

Get one Shodan notification service and its provider-specific destination arguments.

Get Observed Request Headers

Return the HTTP request headers Shodan observes for this Composio API call.

Get Organization

Return the connected account's Shodan organization, administrators, members, member upgrade, authorized domains, and branding.

Get Scan Status

Return the submission or processing status of one Shodan on-demand scan.

Ignore Alert Service

Add one IP:port service to a Shodan network alert trigger's ignore list so matching events no longer notify.

List Alert Triggers

List trigger rules that can be enabled on Shodan network alerts.

List Crawled Ports

List TCP and UDP port numbers currently crawled by Shodan.

List Dataset Files

List downloadable file metadata for one Shodan bulk dataset.

List Datasets

List bulk Shodan datasets available to the connected account.

List Network Alerts

List network alerts on the connected account, optionally including expired alerts.

List Notifier Providers

List supported notification providers and the provider-specific argument names each requires.

List Notifiers

List notification services available on the connected account.

List Saved Queries

Return one page of community-saved Shodan search queries, with optional vote or timestamp ordering.

List Saved Query Tags

List the most popular tags used by community-saved Shodan queries.

List Scan Protocols

List protocol names and descriptions accepted by Shodan on-demand scan requests.

List Scans

Return one page of active and recent on-demand scans for the connected Shodan account.

List Search Facets

List facet names accepted by Shodan host search.

List Search Filters

List filter names accepted in Shodan host-search query syntax.

Remove Alert Notifier

Detach a notifier from a paid Shodan network alert so future matching events are no longer sent through it.

Remove Organization Member

Permanently remove a member from the connected Shodan Enterprise organization and downgrade their account.

Request Internet Scan

Submit an Internet-wide scan for one port and protocol, initiating external network traffic and consuming scan credits.

Request Scan

Submit an asynchronous Shodan scan for specified IP addresses or CIDR ranges.

Resolve Hostnames

Resolve one or more hostnames to IP addresses.

Reverse DNS Lookup

Look up hostnames for one or more IP addresses.

Search Hosts

Return one page of Shodan banners matching a query, with optional facets and field selection.

Search Saved Queries

Return one page of community-saved Shodan queries matching text.

Tokenize Search Query

Parse a Shodan search query into text, filters, attributes, and syntax errors without running the search.

Unignore Alert Service

Remove one IP:port service from a Shodan network alert trigger's ignore list so matching events can notify again.

Update Network Alert

Replace the complete IP and CIDR range list monitored by an existing Shodan network alert.

Update Notifier

Replace provider-specific arguments for an existing Shodan notifier.

FAQ

Frequently asked questions

Start with Shodan.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Shodan tool your agent needs.Free to start.

Start building