@nats-trail/mcp

@nats-trail/mcp

Read-only MCP tool contracts and stdio server for NATS Trail.

claude mcp add nats-trail -- npx -y @nats-trail/mcp

Twenty-five natstrail.* tools with explicit JSON input and output schemas, required result limits capped at 200, cursors, scan budgets with truncation warnings, per-tool timeouts, and structured error envelopes.

Start here when the topology is unknown:

• discover_subjects — which subjects carry traffic, and the payload shape inferred from real messages
• reconstruct_flow — the causal chain behind one request_id, ending at the step that failed
• get_health_summary — what is broken right now, ranked worst first
• enrich_incident — flat incident context for Sentry, Grafana or Datadog

The runtime cannot write. It receives an interface exposing only read functions, so publish, purge and delete are absent rather than disabled.

Set NATS_TRAIL_API to forward tool calls to a running bridge, and NATS_TRAIL_TOKEN when the bridge has bearer auth enabled.

License

Apache-2.0