MCP server for operator control of an Isthmus instance: a bridge between MeshCore, Meshtastic, Reticulum (LXMF), Nostr, and ACP agents. Enables inspection of health, management of groups/members, message injection, tunnel/relay configuration, and policy control.
Isthmus provides 30 tools with consistent naming (verb_noun pattern) and descriptions. All tools have input schemas with type definitions. However, descriptions are often terse (10-50 chars), parameter descriptions are sparse or missing, and output schemas are undocumented. Error handling guidance is absent. The server follows basic structure but lacks LLM-optimization depth expected of production tools.
Announce announceable proxy legs for a group
Attach an identity (meshcore, reticulum, nostr, or agent) to a group
BLE sidecar, adapter discovering/paired devices, and remembered companions
Start a MeshCore or Meshtastic BLE companion
Create a bridge group
Add a Nostr relay (ws:// or wss://)
Add an island tunnel peer
Output schemas undocumented. No tool specifies what fields are returned, forcing LLMs to guess response structure and plan downstream calls blindly.
Descriptions are terse (10-50 chars). Rubric baseline is 194 chars. LLMs cannot determine when to select tools or what they return without fuller context.
Parameter descriptions missing or minimal. E.g., 'network' in attach_member lacks guidance on valid values; 'value' in set_policy lacks format hints (JSON vs plain).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | <=2025-11-25 | v2 |
Detach an attached member from a group
Stop a BLE companion and forget it across restarts
Recent gateway forward log (no message bodies)
ACP agent command, working directory, and connection status
Get one group by UUID or display name
Read policy settings and gateway direction keys
Governor drop summary and stats
Network adapter health (MeshCore, Meshtastic, Reticulum, Nostr, ACP agent)
Inject a message into a group (fans out to members and radio channels)
Recent heard identities (MeshCore adverts, RNS announces, NodeInfo)
List registration and bridge groups with members and radio channels
Heard Public channel text and group messages for groups with retention on
MeshCore and Meshtastic companion health
List configured Nostr relays
Ops timeline (sighting, governor, gateway)
List island tunnel peers
Mint an Isthmus-owned proxy (reticulum, nostr, or meshcore) on a group
Revoke a group
Scan for MeshCore and Meshtastic Bluetooth radios
Set the ACP agent command (Cursor, Hermes, Gemini, OpenCode, …) and reconnect
Keep this group's message bodies on Messages after forwarding (off by default)
Write a policy key (registration_open, budgets, gateway directions, …)
Enable or pause a tunnel peer
No error handling guidance. Tools lack recovery hints (e.g., 'If group not found, call list_groups() first'). Agents cannot self-correct on failures.
Destructive tools (revoke_group, disconnect_bluetooth) lack confirmation or dry-run support. Agents can irreversibly delete without safeguards.