How to connect Shodan with ChatGPT

Connect ChatGPT 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

How to connect Shodan MCP with ChatGPT

ChatGPT can take action across your apps and files, stay with a project for hours, and turn a goal into finished materials like sheets, slides, and docs, not just answers.

In this guide, I will explain the easiest and most secure way to connect your Shodan account to ChatGPT via Composio Connect, so it can search exposed hosts, inspect service data, monitor network exposure, and review collection feeds through natural language commands without ever putting your account credentials at risk.

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

Also integrate Shodan with

Why use Composio over default connectors?

  • Apps with read and write access. Default connectors mostly can read your data. Composio's Shodan integration lets ChatGPT take actions like creating drafts, sending updates, labeling records, and more.
  • 1,700+ SaaS toolkits out of the box. Composio gives you instant access to a vast catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
  • Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand.
  • Cross-app automation. Chain actions across multiple apps in a single run - fetch a thread, summarize it in Notion, and post highlights to Slack without leaving the conversation.

Prerequisites

Note: Composio connects through OAuth. You will be asked to sign in and approve specific permissions. Review the permission screen carefully if you are using a work account.

Step-by-step: Connect Shodan to ChatGPT

1. Install the Composio plugin

Click the button. ChatGPT opens the Composio plugin page. Click Install plugin.

Install in ChatGPT

Composio plugin page in ChatGPT with the Install plugin button

You can also find it inside ChatGPT: go to Settings, open Plugins, search the marketplace for Composio, and click Install plugin.

2. Authenticate

After you install, ChatGPT asks you to authenticate with Composio. Log in and click Allow access to authorize ChatGPT to use your Composio account.

Composio login and Allow access screen for ChatGPT

3. Start using Composio

That is it. Composio tools are now available in ChatGPT. Type @Composio followed by your request, for example @Composio find unread Shodan messages and summarize them, and it will run the actions you authorize. On first use it asks you to authorize Shodan.

Option 2: Add Composio as an MCP server

If you cannot use the plugin marketplace, add Composio as a custom MCP server instead.

1. Open the MCP settings

In ChatGPT, go to Settings and open the Plugins section. Inside the Plugins page, click the MCP tab.

ChatGPT settings showing the Plugins page with the MCP tab selected

2. Add the server

Click Add server. In the Name field enter Composio, for Type select Streamable HTTP, and in the URL field paste the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
ChatGPT Add server dialog with the name Composio, type Streamable HTTP, and the Composio MCP URL

Then click Save. The Composio server now appears in your MCP plugins list.

ChatGPT Plugins page showing the Composio MCP server added to the list

3. Authenticate

Click Authenticate on the Composio entry, log in via Composio, and click Allow access. Composio tools are then available in ChatGPT the same way as with the plugin.

What you can do after connecting Shodan

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

Security + privacy notes (important)

  • Use least-privilege access: Only grant permissions you actually need.
  • Review OAuth permissions before approving: Make sure requested scopes match what you expect Composio and ChatGPT to do.
  • Keep write actions human-reviewed: For actions like sending messages, creating labels, or editing drafts, keep manual confirmation enabled.
  • Be careful with sensitive data: Avoid using this setup with highly sensitive information unless allowed by your personal, company, or client policies.
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