observer-launch-mcp

Ask Claude questions about your Observe data -- recent errors, common failures, log volume by pod -- without writing OPAL by hand. This is an MCP server that gives Claude direct, live access to your Observe tenant.

Setup (2 steps)

1. Run the setup wizard. It asks for your Observe credentials and dataset aliases, then registers itself with Claude Code automatically:

npx @aryanbansal-launch/observer-launch-mcp init

You'll be asked for:

• Observe customer ID -- a number, found in your Observe URL.

• Observe API key -- create one at Manage account → My API tokens. (Not an ingest/datastream token -- those look similar but don't work here.)

• Cluster -- e.g. eu-1. Leave blank if you're on the default US tenant.

• Dataset aliases (optional) -- friendly names for datasets you'll ask about often, e.g. launch-management → 41249178. Find the ID in the Observe UI: open a dataset, it's in the URL. You can skip this and use raw dataset IDs instead, or add aliases later.

2. Restart Claude Code (or start a new session) so it picks up the new server. Confirm it worked:

Is the Observe connection working?

That's it -- the other tools below are now available in chat.

claude mcp add observe -s user \
  -e OBSERVE_CUSTOMER_ID=<your id> \
  -e OBSERVE_API_KEY=<your token> \
  -e OBSERVE_CLUSTER=eu-1 \
  -e OBSERVE_DATASETS='{"launch-management":"41249178"}' \
  -- node <path to installed server.js>

Run npx @aryanbansal-launch/observer-launch-mcp init once first if you just want that absolute path -- it prints the exact command it would run, right before running it. Use a direct node <path> command, not npx <package> as the final entry -- Claude Code spawns registered servers with a bare environment (no PATH), and npx's own shebang needs PATH to find node, so npx-as-command silently shows "Failed to connect." The wizard already avoids this for you.

Related MCP server: Fathom AI MCP Server

What you can ask

Once it's set up, just talk to Claude naturally:

• "Is the Observe connection working?"

• "What service/dataset aliases do I have configured?"

• "Show me recent errors from launch-management in the last hour"

• "What's our most common error in launch-nginx this week?"

• "Which pods are logging the most in launch-management-bg right now?"

• "How much stderr output is launch-nginx producing in the last 6 hours?"

• "Count log lines per pod in launch-telemetry over the last hour"

• "Pull the last 20 raw log lines from launch-logs-bg-exporter"

For anything not covered by a specific question shape, just describe what you want -- Claude will write the OPAL pipeline for you using the general query tool.

Tools reference

get_error_summary and get_log_stats aggregate server-side, so they stay fast regardless of the time window. get_service_errors and run_opal_query will add a warning if you query a 6h+ window without aggregating, since raw row dumps over a wide window risk Observe's 100k row cap.

Configuration reference

Dataset IDs are tenant-specific and intentionally not bundled with this package. Without any configured, alias lookups fall through and you can still pass raw numeric dataset IDs directly to any tool.

Troubleshooting

• Health check fails → your API key is probably an ingest/datastream token, not one from Manage account → My API tokens. Regenerate it.

• claude mcp list shows "Failed to connect" on a manually-registered entry → check the command is node <path>, not npx <package> (see the callout above).

• A tool returns "Unknown service/dataset" → run list_known_services to see what's configured, or pass a raw numeric dataset ID instead.

• get_service_errors/get_error_summary return nothing useful → these assume your logs have a JSON log column shaped like {"level":"error","message":"...","context":"..."}. If your schema differs, adjust the pipeline in src/run-server.ts.

Contributing

npm install
npm run build   # tsc, then chmod +x on the bin entry
npm publish      # only if you intend to ship a new version

Copy the get_error_summary/get_log_stats pattern in src/run-server.ts for other recurring OPAL queries (e.g. cost-by-service, latency percentiles) -- give the tool a descriptive name/description so Claude picks it over run_opal_query when appropriate.