super-log
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SUPER_LOG_URL | No | The URL of the super-log hub that the MCP server connects to, e.g. http://127.0.0.1:7333. Defaults to the loopback hub. | http://127.0.0.1:7333 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hub_statusA | Check whether the super-log hub is running and how much traffic it has seen. Call this first when logs seem missing - it distinguishes "the bench is down" from "the app logged nothing". |
| agent_reportA | Put yourself on the bench's AGENTS blotter: say who you are, which LLM you run on, what you are doing, and how often to expect you. For a long job (an 8-hour build, an overnight proof search), call this on a schedule - every interval_s, default 900 (15 minutes) - AND on events: milestones, errors (level WARN/ERROR), and done. The blotter shows your last status and greys you when you miss your own promised cadence, so a silent agent LOOKS silent. This is the single deliberate write this otherwise read-only server performs, and it can only land on agent.* status topics. |
| list_webhooksA | List the alarm gateway's routes: the production alarm door and every provisioned webhook endpoint (capture / relay / forward) with its PUBLIC URL, health light, ping latency and kind. Use this to find the URL to hand a webhook sender (Stripe, GitHub, a partner) - deliveries then arrive as wh. events (tail_logs with topic wh.; fields carry the signature verdict, relay status and up to 32KB of body). Ask stream_guide about "wh" for how to read them. |
| list_streamsA | Summarise which log streams (topics) are active and their level mix. Cheap orientation - call this before tail_logs so you know what topics exist and where the errors are, instead of guessing topic names. |
| tail_logsA | Read recent log events, newest last. ALWAYS narrow with topic and/or level - the firehose can be thousands of events per second. Returns a cursor; pass it back as |
| search_logsA | Find events matching text across the recent window - use when you know what the message says (an exception, an order id, a URL) but not which stream it is in. |
| search_historyA | Search the on-disk journal: hours or days of history, not the few minutes the hub keeps in memory. This is the tool for "what happened at 3am" or anything older than the live ring - tail_logs and search_logs cannot see that far back. Needs superlog-journal to have been running at the time. |
| wait_forA | Block until a matching event appears, then return it. This is the one to use after you trigger something: start the action, then wait for its log line or error rather than sleeping and hoping. Returns promptly on the first match. |
| stream_guideA | Detailed documentation for a bench capability, before working with an unfamiliar topic: what its events and metrics mean, how to read them, and the gotchas (what a stall escalation is, why power says not root, why a diff can be silent). No arguments lists everything; name one entry or a playbook for the detail. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| triage | Something is wrong on the bench |
| logs-behind-a-commit | 'Why did that break?' usually means 'what did the bench see around that commit?' 1) Once, per repo: superlog git install-hooks - now every commit stamps a git |
| follow-a-trace | One action, every tier: take the trace id from any event (request line, build start, file save) and query /recent?trace= via search_logs |
| silent-stream | A stream that STOPPED is the failure most tools miss - a quiet server and a dead server look identical |
| nothing-is-arriving | A producer swears it is logging but no events show up |
| power-incident | The machine is hot/loud/slow: tail_logs topic=power |
| watch-a-download | A big fetch (Hugging Face model, dataset): dl |
| fix-session-went-quiet | Fills stopped, or an order bounced |
| drone-postflight | Something went wrong on the flight |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools have clearly distinct purposes: listing, tailing, searching live vs. searching history, blocking, and status are all separable. The only mild ambiguity is between search_logs and search_history, whose names and descriptions are close enough that an agent might need to read carefully to pick the right one.
There is a recognizable pattern with list_webhooks/list_streams and search_logs/search_history, but other names break it: stream_guide, hub_status, agent_report, and wait_for use different structures. The mix is readable and not chaotic, but it lacks the uniform verb_noun style of the best server sets.
Nine tools is well-scoped for a logging and monitoring server. Each tool covers a distinct operation without padding or duplication, and the count feels right for the domain.
The surface covers the full read/monitoring lifecycle: orientation, live tailing, text search, historical search, blocking waits, webhook discovery, hub health, and a deliberate status heartbeat write. Since the server is intentionally otherwise read-only, there are no obvious dead ends or missing core operations.