mcbirdcage
MCP server for controlling Winegard satellite dishes through conversational tools. Built on FastMCP, exposes 36 tools for dish positioning, signal analysis, firmware inspection, and satellite pass planning.
Install
# Add to Claude Code
claude mcp add mcbirdcage -- uvx mcbirdcage
# Or run standalone
uvx mcbirdcage
Demo Mode
No dish required. Set BIRDCAGE_DEMO=1 to get simulated responses for all tools:
BIRDCAGE_DEMO=1 uvx mcbirdcage
Tools
36 tools across six groups:
| Group | Count | Examples |
|---|---|---|
| Connection | 3 | connect, disconnect, status |
| Movement | 9 | get_position, move_to, home_motor, stow |
| Signal | 8 | get_rssi, enable_lna, az_sweep, get_lock_status |
| System | 11 | nvs_dump, get_firmware_id, set_pid_gains, get_a3981_diag |
| Satellite | 4 | search_satellites, get_passes, get_visible_targets |
| Console | 1 | send_raw_command (direct firmware access) |
Plus 5 resources (hardware specs, NVS reference, firmware docs) and 3 prompts.
Environment Variables
| Variable | Default | Description |
|---|---|---|
BIRDCAGE_DEMO |
0 |
Enable demo mode (no hardware) |
BIRDCAGE_PORT |
/dev/ttyUSB0 |
Serial port path |
BIRDCAGE_FIRMWARE |
hal205 |
Firmware variant (hal000, hal205, g2) |
BIRDCAGE_CRAFT_URL |
-- | Craft API URL for live satellite TLEs |
Documentation
Full tool reference and hardware setup: birdcage.warehack.ing
Credits
- Gabe Emerson (KL1FI / saveitforparts) -- original Winegard rotor scripts
- Chris Davidson (cdavidson0522) -- Carryout G2 sky scan and rotator control
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for mcbirdcage 2026.2.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcbirdcage-2026.2.18.tar.gz | 89.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcbirdcage-2026.2.18-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 105.9 kB
Release files / mcbirdcage-2026.2.18.tar.gz
| Download URL | mcbirdcage-2026.2.18.tar.gz |
|---|---|
| Size | 89.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ba9e6b25c4dd76bf7bf06656c93edf06981a3db4f04f461938702e78a1bd5cd
|
|
BLAKE2b-256 checksum How to use checksums |
7e080d6474554e0518b10559d05f364140e338c792a0df69e3b09ec54706bdb3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"EndeavourOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mcbirdcage-2026.2.18-py3-none-any.whl
| Download URL | mcbirdcage-2026.2.18-py3-none-any.whl |
|---|---|
| Size | 15.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fcfac2a9f18142917bc7b39dff1583e7dcca597378b3315489912f0f661409c7
|
|
BLAKE2b-256 checksum How to use checksums |
bbe76d534bde73943749158992bc545033c1b34e380af72f852c9a9d52e80d07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"EndeavourOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
