MCP server for AllStar Link — wraps ASL3-API REST endpoints as MCP tools for AI agent control of amateur radio nodes
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"allstar-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# allstar-mcp MCP server for [AllStar Link](https://allstarlink.org) node control. Wraps [ASL3-API](https://github.com/KJ5IRQ/asl3-api) REST endpoints as MCP tools, giving AI agents (Claude, GPT-4, any MCP-compatible client) structured, intent-aware access to AllStar Link node monitoring and control. The first MCP server for AllStar Link in existence. ## Architecture ``` Claude / AI Agent | allstar-mcp (FastMCP, Python) | ASL3-API (REST + SSE, port 8073) | AMI / Asterisk / app_rpt ``` The MCP server is a translation layer only. It never touches AMI directly — all operations go through ASL3-API REST endpoints. ## Requirements - ASL3-API v1.4+ running on your AllStar node (see [ASL3-API](https://github.com/KJ5IRQ/asl3-api)) - Python 3.11+ or `uv` ## Quick Start ```bash ALLSTAR_API_KEY=yourkey ALLSTAR_API_URL=http://your-node:8073 uvx allstar-mcp ``` ## Claude Desktop Configuration Add to `claude_desktop_config.json`: ```json { "mcpServers": { "allstar": { "command": "uvx", "args": ["allstar-mcp"], "env": { "ALLSTAR_API_KEY": "your-api-key-here", "ALLSTAR_API_URL": "http://your-node-ip:8073" } } } } ``` ## Environment Variables | Variable | Required | Default | Description | |----------|----------|---------|-------------| | `ALLSTAR_API_KEY` | Yes | — | ASL3-API authentication key | | `ALLSTAR_API_URL` | No | `http://localhost:8073` | Base URL of your ASL3-API instance | ## Tool Surface ### Read-only (no risk) | Tool | Description | |------|-------------| | `health_check` | API reachable, auth works, AMI connected, node/version | | `get_node_status` | Uptime, keyup count, TX time, DTMF stats | | `get_connected_nodes` | Who is linked and where (with callsign/location) | | `get_live_variables` | Live RX/TX keyed state, link counts, autopatch status | | `get_capabilities` | What this node supports — for agent auto-config | | `lookup_node` | Callsign, location from 40k-node AllS…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.