{
  "markdown": "# mcp-shodan\n\nMCP server exposing [Shodan](https://www.shodan.io/) API functionality via the Model Context Protocol.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-shodan.svg)](https://pypi.org/project/mcp-shodan/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-shodan.svg)](https://pypi.org/project/mcp-shodan/)\n[![Coverage](https://codecov.io/gh/daedalus/mcp-shodan/branch/main/graph/badge.svg)](https://codecov.io/gh/daedalus/mcp-shodan)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\n## Install\n\n```bash\npip install mcp-shodan\n```\n\n## Usage\n\n```bash\nexport SHODAN_API_KEY=your_api_key\nmcp-shodan\n```\n\nOr add to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"shodan\": {\n      \"command\": \"mcp-shodan\",\n      \"env\": {\n        \"SHODAN_API_KEY\": \"your_api_key\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Host Information\n- `shodan_host` - Get all available information on an IP address\n\n### Search\n- `shodan_search` - Search the Shodan database\n- `shodan_search_cursor` - Search and return an iterator\n- `shodan_count` - Get total number of search results\n- `shodan_search_tokens` - Get information about a search query\n\n### Alerts\n- `shodan_alerts` - List all active alerts\n- `shodan_create_alert` - Create a new alert\n- `shodan_delete_alert` - Delete an alert\n\n### Scanning\n- `shodan_scan` - Scan a network\n- `shodan_scan_internet` - Scan the internet on a port\n- `shodan_scan_status` - Get scan status\n\n### Saved Queries\n- `shodan_queries` - List shared search queries\n- `shodan_queries_search` - Search saved queries\n- `shodan_queries_tags` - Get popular query tags\n\n### Exploits\n- `shodan_exploits_search` - Search the Shodan Exploits archive\n- `shodan_exploits_count` - Get total exploit count\n\n### Utilities\n- `shodan_info` - Get API key information\n- `shodan_ports` - Get list of ports Shodan crawls\n- `shodan_protocols` - Get supported protocols\n- `shodan_services` - Get list of services\n\n## Example\n\n```python\n# Get information about a host\nshodan_host(\"1.1.1.1\")\n\n# Search for specific services\nshodan_search(\"apache\", limit=10)\n\n# Count results for a query\nshodan_count(\"nginx\")\n\n# Check your API plan\nshodan_info()\n```\n\nmcp-name: io.github.daedalus/mcp-shodan\n",
  "bytes": 2305,
  "sha": "f5899cb19adc631fc43b2510b44dc0915eee1f38aaee664fb4a1823a19e628a0",
  "repo_slug": "daedalus/mcp-shodan",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_shodan_a1235f7e/readme"
}