Skip to main content
Glama
kismet-wireless-mcp

kismet-wireless-mcp

by A-G-U-P-T-A

kismetwireless-mcp

Kismet Wireless MCP server — status, datasources, devices, and alerts for AI agents.

Modeled after wireshark-mcp: FastMCP stdio, fail-closed preflight, modular tools/prompts/resources, no simulated data.

Version 1.0.0 — GET-only (readonly REST). No datasource start/stop.

Quick start

1. Docker lab (API without RF adapter)

cd kismetwireless-mcp\docker
docker compose up -d

2. Install MCP package

cd kismetwireless-mcp
python -m venv .venv
.\.venv\Scripts\activate
python -m pip install -e .

3. Doctor + setup

$env:KISMET_URL = "http://127.0.0.1:2501"
$env:KISMET_USER = "kismet"
$env:KISMET_PASSWORD = "kismet"
python -m kismet_mcp doctor
python -m kismet_mcp setup

4. Run (hosts spawn this)

python -m kismet_mcp

Related MCP server: Iris

Cookbook workflows (preferred)

Tool

Purpose

list_workflows

Catalog of predefined recipes

workflow_capture_health

Datasources / GPS / sensor readiness

workflow_rf_landscape

APs + Wi-Fi + BT/BTLE survey

workflow_wids_triage

Attack-class alerts vs SYSTEM noise

workflow_rogue_ap_hunt

Duplicate SSIDs / evil-twin signals

workflow_device_hunt

MAC / SSID / name search

Suggested order: health → landscape → WIDS triage → rogue hunt.

Atomic tools

Tool

Purpose

check_environment

Reachability / auth report

kismet_user_status

Unauthenticated process status

kismet_system_status

Version, device count, memory

kismet_timestamp

Server timestamp

list_datasources

Capture sources

list_recent_devices

Devices in last N seconds

get_device

One device by key

list_alerts

Alert backlog

list_alert_definitions

Alert type catalog

Layout

kismetwireless-mcp/
  docker/                 # compose lab
  docs/                   # Setup, Clients, Security
  examples/               # mcpServers snippet
  src/kismet_mcp/
    __main__.py           # run | setup | doctor
    server.py             # FastMCP
    client.py             # GET-only httpx
    config.py / security.py / preflight.py
    tools/                # environment, system, datasources, devices, alerts
    prompts.py / resources.py
  tests/

Docs

Phase 1 Docker smoke (local)

Endpoint

Result

GET /system/user_status.json

200

GET /system/status.json (kismet:kismet)

200

datasources / devices

200 [] without RF (expected)

alerts

200

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server that allows AI assistants to query and monitor KVM Fleet devices, audit logs, and console sessions through the official REST API.
      5
      8 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      This MCP server enables AI agents to read MQTT and Sparkplug B data via tools like list_topics, get_latest, and read_all, providing read-only access to latest sensor values.
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that enables AI assistants to search files, list directories, retrieve system info, and get file metadata on the local file system.
      4
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server for Cisco Meraki Dashboard, enabling LLMs to discover devices, check health, troubleshoot, and generate reports via natural language.
      MIT