starlink-blade-mcp

Local-first Starlink dish monitoring and control via the Model Context Protocol.

Talks directly to your dish over the local gRPC interface (192.168.100.1:9200) — no cloud API, no enterprise credentials, no internet dependency. Built on starlink-grpc-core, the same library that powers the Home Assistant Starlink integration.

Why this MCP?

Related MCP server: MCP Server for Coroot

Tools

Read (no authentication required)

Write (gated)

Write operations require dual gating:

1. STARLINK_WRITE_ENABLED=true environment variable

2. confirm=true parameter on each call

Quick Start

# Install
uv pip install starlink-blade-mcp

# Run (dish must be reachable at 192.168.100.1)
starlink-blade-mcp

# Or with uv
uvx starlink-blade-mcp

Claude Code

{
  "mcpServers": {
    "starlink": {
      "command": "uvx",
      "args": ["starlink-blade-mcp"],
      "env": {
        "STARLINK_WRITE_ENABLED": "false"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "starlink": {
      "command": "uvx",
      "args": ["starlink-blade-mcp"],
      "env": {
        "STARLINK_DISH_ADDRESS": "192.168.100.1:9200",
        "STARLINK_WRITE_ENABLED": "false"
      }
    }
  }
}

Configuration

Network Requirements

The Starlink dish exposes an unauthenticated gRPC server at 192.168.100.1:9200 on the local network. Requirements:

• Device running the MCP must be on the Starlink LAN (or have a route to 192.168.100.1)

• No credentials or API keys needed

• GPS location requires opt-in: Starlink app > Settings > Advanced > Debug Data

• The dish's 192.168.100.1 address is not configurable

Starlink router (default)

Works out of the box. The dish, router, and your devices are all on the same network.

Third-party router in bypass mode (UniFi, pfSense, etc.)

In bypass mode, the Starlink router hands its CGNAT WAN IP to your router's WAN interface. The dish management interface (192.168.100.1) sits on a separate /24 subnet on the WAN side — your router won't know how to reach it without a static route.

Static route configuration (UniFi example):

UniFi Network > Settings > Routing > Static Routes:

Some router firmware also requires a secondary IP on the WAN interface in the 192.168.100.0/24 range (e.g. 192.168.100.2/24) for traffic to egress on that subnet. This depends on whether your firmware handles interface-scoped routes correctly — UniFi has been inconsistent here across versions.

Once the route is in place, both 192.168.100.1:9200 (gRPC) and 192.168.100.1:80 (Starlink web UI) become reachable from your LAN.

Remote / headless sites

Run the MCP server on any host that can reach 192.168.100.1 — a local machine, a container on a NAS, or any device on the Starlink-connected network.

Security Model

• No credentials stored or transmitted — the dish gRPC endpoint is unauthenticated by design

• LAN-only access — the gRPC interface is not exposed to the internet

• Write operations double-gated — environment variable + per-call confirmation

• No telemetry or phone-home — all data stays local between the MCP server and the dish

• No cloud API dependency — works during internet outages (ideal for monitoring them)

Token Efficiency

The starlink_history tool returns statistical summaries (min/avg/max per metric) rather than raw per-second samples. A 900-second window produces ~8 lines of output vs ~5,400 lines of raw data.

History Summary (last 60 samples, 1s intervals)

metric          min      avg      max   unit
--------------------------------------------
ping_drop     0.0000   0.0021   0.0150
latency         22.1     34.5     89.2     ms
down             0.5     45.2    120.3   Mbps
up               0.1      8.4     25.1   Mbps
power           48.2     52.1     58.9      W
snr              7.8      9.2     10.1     dB

Development

git clone https://github.com/groupthink-dev/starlink-blade-mcp
cd starlink-blade-mcp

# Install with dev dependencies
make install-dev

# Run quality checks
make check

# Run tests (mocked — no dish required)
make test

# Run e2e tests (requires live dish on LAN)
make test-e2e

# Run with coverage
make test-cov

Sidereal Marketplace

This MCP is available as a certified plugin in the Sidereal Marketplace. Install directly from Settings > MCPs in the Sidereal app.

The plugin manifest provides:

• Credential-free setup (auto-discovers dish on LAN)

• Write operation toggle in Settings UI

• Connection test validation

• Custom dish address for non-standard networks

Roadmap

• Power save / sleep schedule control (read + set via dish_power_save proto)

• Hardware self-test results (extended diagnostics from proto)

• Webhook triggers for alert state changes (Sidereal event dispatch)

• Firmware update tracking and notification

• Multi-dish support (mesh network with multiple terminals)

• Obstruction map visualization (SVG/image generation)

License

MIT