MCP Homescan Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHODAN_API_KEY | No | Optional Shodan API key for vulnerability lookups | |
| HOMESCAN_SUBNET | No | Network subnet to scan (e.g., 192.168.1) | 192.168.1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| homescan_discoverA | Discover all devices on the local network using ARP table. Returns IP, MAC address, and manufacturer for each device found. |
| homescan_deviceC | Get detailed information about a specific device by IP address |
| homescan_mac_lookupB | Look up the manufacturer of a device from its MAC address |
| homescan_reportB | Generate a comprehensive network discovery report in markdown format, including device summary, categories, and security flags |
| homescan_exportA | Export discovered devices to Obsidian inventory format. Returns an array of files that can be saved to your vault. |
| homescan_diffB | Compare current network scan to the last scan and show new/removed devices |
| homescan_flaggedA | List devices flagged for security review (unknown manufacturers, Chinese IoT devices, randomized MACs) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: device lookup, diff comparison, network discovery, export, flagged device listing, MAC lookup, and report generation. The descriptions make it easy for an agent to select the right tool for each specific task without confusion.
All tools follow a consistent 'homescan_' prefix with descriptive suffixes (e.g., device, diff, discover), using snake_case uniformly. This predictable pattern enhances readability and makes the tool set easy to navigate.
With 7 tools, the server is well-scoped for network scanning and security analysis. Each tool serves a unique function in the discovery, analysis, and reporting workflow, with no redundancy or missing elements for its domain.
The tool set provides complete coverage for network scanning tasks: discovery (homescan_discover), detailed inspection (homescan_device, homescan_mac_lookup), comparison (homescan_diff), security analysis (homescan_flagged), and output (homescan_export, homescan_report). No obvious gaps exist for the server's purpose.