​
Run the Meshagent-wrapped MCP Shodan Server as a cloud agent

Pre-requisites:

​
Environment Variables Required

  • SHODAN_API_KEY – Your Shodan API key (obtain from shodan.io)

​
Step-by-step Guide

  1. Install Meshagent CLI

    pip install "meshagent[all]"

  2. Authenticate with your Meshagent account

  3. Launch the MCP Shodan Agent in a Meshagent Room

    meshagent service test \
    --room=test \
    --role=agent \
    --image=meshagent/mcp-cyreslab-ai-shodan:latest \
    --env MESHAGENT_PORT=8001 \
    --env SHODAN_API_KEY=YOUR_SHODAN_API_KEY \
    --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
    --name=mcp-cyreslab-ai-shodan-service
    • This command runs the Cyreslab-AI MCP Shodan server as a Meshagent service inside a “test” room.
    • Note: Replace YOUR_SHODAN_API_KEY with your Shodan API key.
    • Rooms will auto-close if they go inactive.

  4. Join as a Chatbot with Toolkit Access

    meshagent chatbot join \
    --room=test \
    --agent-name=sample \
    --name=sample \
    --toolkit=mcp-cyreslab-ai-shodan
    • This launches a chatbot with access to the full cyreslab-ai-shodan toolset in the room.
    • You can connect multiple toolkits or agents in any room concurrently.
    • A clickable room link will be shown in the command output—use it to interact with the agent and tools live.

​
Tools Available

A suite of Shodan search and information tools accessible via this MCP server, documented below.

​
Tools Summary

ToolDescription
get_host_infoGet detailed information about a specific IP address
get_ssl_infoGet SSL certificate information for a domain
scan_network_rangeScan a network range (CIDR notation) for devices
search_iot_devicesSearch for specific types of IoT devices
search_shodanSearch Shodan’s database for devices and services

​
Tools Details

​
get_host_info

Get detailed information about a specific IP address

ParameterTypeDescription
ipstringIP address to look up
fieldsarray(optional) List of fields to include in the results (e.g., ['ip_str', 'ports', ...])
max_itemsnumber(optional) Maximum number of items in arrays (default: 5)

​
get_ssl_info

Get SSL certificate information for a domain

ParameterTypeDescription
domainstringDomain name to look up SSL certificates for

​
scan_network_range

Scan a network range (CIDR notation) for devices

ParameterTypeDescription
cidrstringNetwork range in CIDR notation (e.g., 192.168.1.0/24)
fieldsarray(optional) List of fields to include in the results (e.g., ['ip_str', 'ports', ...])
max_itemsnumber(optional) Maximum number of items in arrays (default: 5)

​
search_iot_devices

Search for specific types of IoT devices

ParameterTypeDescription
device_typestringType of IoT device (e.g., ‘webcam’, ‘router’, ‘smart tv’)
countrystring(optional) Optional country code to limit (e.g., ‘US’, ‘DE’)
max_itemsnumber(optional) Maximum items to include in results (default: 5)

​
search_shodan

Search Shodan’s database for devices and services

ParameterTypeDescription
querystringShodan search query (e.g., ‘apache country:US’)
facetsarray(optional) List of facets to include in the search results (e.g., ['country', 'org'])
fieldsarray(optional) List of fields to include in the results
max_itemsnumber(optional) Maximum number of items in arrays (default: 5)
pagenumber(optional) Page number for pagination (default: 1)
summarizeboolean(optional) Return summary of results instead of full data (default: false)

​
Meshagent & Resources

For more about the underlying MCP server project, visit Cyreslab-AI/shodan-mcp-server.

Deploy, prototype, and collaborate on advanced Shodan queries and automation—securely and instantly—with MCP + Meshagent!