{
 "kind": "mcp",
 "slug": "sh-superlog-superlog",
 "path": "mcp/servers/sh-superlog-superlog/",
 "name": "Superlog",
 "maker": "superloglabs",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Cloud and DevOps",
   "mcp/cloud/"
  ]
 ],
 "lead": "ask your coding assistant why production broke.",
 "chips": [
  {
   "label": "Cloud and DevOps",
   "path": "mcp/cloud/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http superlog https://api.superlog.sh/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/superloglabs/superlog"
  },
  {
   "label": "Website",
   "href": "https://superlog.sh"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "\"url\": \"https://api.superlog.sh/mcp\"",
   "note": "The server code lives in the vendor's own repository (superloglabs/superlog, apps/api/src/mcp), and the registry entry sh.superlog/superlog points at api.superlog.sh, the vendor's domain.",
   "src": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/server.json"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "1 secret needed",
   "status": "info",
   "sub": "none with the browser sign-in (OAuth); a Superlog personal a",
   "quote": "\"url\": \"https://api.superlog.sh/mcp\"",
   "note": "The configs come from the install panel in Superlog's own web app code; the README itself has no MCP setup.",
   "src": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/apps/web/src/onboarding/McpInstallDialog.tsx"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "Endpoint: https://api.superlog.sh/mcp. Checked: yes: an unauthenticated HEAD to https://api.superlog.sh/mcp answered HTTP 401 on 2026-11-10 (host up, sign-in required).",
   "src": "https://api.superlog.sh/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "Apache-2.0 license",
   "quote": "Superlog is licensed under the [Apache License 2.0](./LICENSE.md).",
   "note": "The community edition may be used, changed and run in commercial settings under Apache-2.0.",
   "src": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/README.md"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Superlog does",
   "parts": [
    {
     "t": "prose",
     "text": "Superlog collects the logs, traces and metrics your app sends while it runs and groups errors into incidents. Its MCP server lets a coding assistant such as Claude Code, Codex or Cursor search that data and explain an incident. With write access it can also add alerts and dashboards for you."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Find the cause of an error",
       "text": "Ask your assistant what failed in the last hour. It searches the logs and request traces of your app instead of you pasting logs into the chat.",
       "idea": false
      },
      {
       "title": "Explain an incident from its link",
       "text": "Paste the link of an incident from Superlog and the assistant reads it, with what the investigation agent found.",
       "idea": false
      },
      {
       "title": "Turn a fix into an alert",
       "text": "After a bug is fixed, the assistant adds an alert so the same failure warns you next time. It can try the alert on current data before saving it.",
       "idea": false
      },
      {
       "title": "Quiet noisy errors",
       "text": "When the same harmless error keeps opening incidents, the assistant changes the filter that decides what counts as an issue. It shows the effect on the last day first.",
       "idea": false
      },
      {
       "title": "A dashboard for one service",
       "text": "Ask for a dashboard of errors and slow requests for one part of your app. The assistant creates it and adds charts and tables.",
       "idea": false
      },
      {
       "title": "Teach the investigator about your system",
       "text": "Write down how your system is built and what you learned from past bugs. Superlog's own investigation agent reads it on every later run.",
       "idea": false
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Superlog popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "1,487",
       "l": "GitHub stars, superloglabs/superlog"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (48)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "list_agent_mcp_servers",
       "text": "Lists extra MCP servers given to the investigation agent; secrets hidden"
      },
      {
       "name": "add_agent_mcp_server",
       "text": "Adds an outside MCP server for the investigation agent, admins only (WRITE, NETWORK)"
      },
      {
       "name": "update_agent_mcp_server",
       "text": "Changes such a server, admins only (WRITE)"
      },
      {
       "name": "remove_agent_mcp_server",
       "text": "Removes such a server, admins only (DELETE)"
      },
      {
       "name": "start_agent_mcp_oauth",
       "text": "Starts a sign-in to such a server, admins only (NETWORK)"
      },
      {
       "name": "connect_agent_mcp_client_credentials",
       "text": "Connects such a server with a client ID and secret, admins only (NETWORK)"
      },
      {
       "name": "disconnect_agent_mcp_oauth",
       "text": "Erases stored sign-in tokens and turns such a server off, admins only (DELETE)"
      },
      {
       "name": "test_agent_mcp_server",
       "text": "Connects to such a server and lists its tools, admins only (NETWORK)"
      },
      {
       "name": "get_issue_filter",
       "text": "Reads the rules that decide which errors become issues"
      },
      {
       "name": "update_issue_filter",
       "text": "Changes those rules to quiet noise (WRITE)"
      },
      {
       "name": "preview_issue_filter",
       "text": "Shows what a new filter would keep over the last 24 hours, without saving"
      },
      {
       "name": "get_project_context",
       "text": "Reads the written description of your system that the investigation agent uses"
      },
      {
       "name": "set_project_context",
       "text": "Replaces that description as a whole (WRITE)"
      },
      {
       "name": "list_agent_memories",
       "text": "Lists what the investigation agent has learned"
      },
      {
       "name": "create_agent_memory",
       "text": "Saves a new learning for future investigations (WRITE)"
      },
      {
       "name": "update_agent_memory",
       "text": "Changes or archives a learning (WRITE)"
      },
      {
       "name": "delete_agent_memory",
       "text": "Deletes a learning for good (DELETE)"
      },
      {
       "name": "list_alerts",
       "text": "Lists the project's alerts"
      },
      {
       "name": "get_alert",
       "text": "Reads one alert and its 50 latest firings"
      },
      {
       "name": "create_alert",
       "text": "Creates an alert (WRITE)"
      },
      {
       "name": "update_alert",
       "text": "Changes an alert (WRITE)"
      },
      {
       "name": "delete_alert",
       "text": "Deletes an alert (DELETE)"
      },
      {
       "name": "preview_alert",
       "text": "Tries a draft alert on current data without saving"
      },
      {
       "name": "test_alert",
       "text": "Re-checks a saved alert on current data"
      },
      {
       "name": "get_home",
       "text": "Reads the shared project home page"
      },
      {
       "name": "set_home_builtin",
       "text": "Shows or hides a built-in home widget (WRITE)"
      },
      {
       "name": "add_home_widget",
       "text": "Adds a chart, table or text widget to the home page (WRITE)"
      },
      {
       "name": "add_home_link",
       "text": "Adds a link card to the home page (WRITE)"
      },
      {
       "name": "update_home_layout",
       "text": "Moves or resizes items on the home page (WRITE)"
      },
      {
       "name": "remove_home_item",
       "text": "Removes an item from the home page (DELETE)"
      },
      {
       "name": "list_dashboards",
       "text": "Lists dashboards"
      },
      {
       "name": "get_dashboard",
       "text": "Reads one dashboard with its widgets"
      },
      {
       "name": "create_dashboard",
       "text": "Creates a dashboard (WRITE)"
      },
      {
       "name": "update_dashboard",
       "text": "Renames a dashboard (WRITE)"
      },
      {
       "name": "set_dashboard_variables",
       "text": "Replaces a dashboard's dropdown variables (WRITE)"
      },
      {
       "name": "delete_dashboard",
       "text": "Deletes a dashboard and all its widgets (DELETE)"
      },
      {
       "name": "add_dashboard_widget",
       "text": "Adds a widget to a dashboard (WRITE)"
      },
      {
       "name": "update_dashboard_widget",
       "text": "Changes a dashboard widget (WRITE)"
      },
      {
       "name": "delete_dashboard_widget",
       "text": "Removes a widget from a dashboard (DELETE)"
      },
      {
       "name": "get_incident",
       "text": "Reads one incident with everything needed to explain it"
      },
      {
       "name": "search_incidents",
       "text": "Searches grouped incidents and the agent's findings"
      },
      {
       "name": "query_logs",
       "text": "Searches your app's logs in a time window, with filters"
      },
      {
       "name": "query_traces",
       "text": "Searches request traces (spans), with filters such as status code or route"
      },
      {
       "name": "query_metrics",
       "text": "Reads recent metric points"
      },
      {
       "name": "list_services",
       "text": "Lists the services that sent data in a time window"
      },
      {
       "name": "list_projects",
       "text": "Lists every project you can access"
      },
      {
       "name": "get_active_project",
       "text": "Shows which project the tools use by default"
      },
      {
       "name": "set_active_project",
       "text": "Switches the default project for this connection"
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "log lines, traces, metrics and incident details the tools return (may include user ids, emails or request data your app logged)",
       "sub": "To your coding assistant and the company running its model; on every query tool call. Opt out: use a read-only or narrower token; keep personal data out of your logs."
      },
      {
       "l": "Sends",
       "v": "an analytics event per tool call (user, org, project, tool name, success, time taken, error text)",
       "sub": "To Superlog's product analytics (PostHog), when its token is set on the server; every tool call. Opt out: self-host without a PostHog token."
      },
      {
       "l": "Sends",
       "v": "requests from Superlog to outside MCP servers an admin adds for the investigation agent",
       "sub": "To those servers; add_agent_mcp_server, test_agent_mcp_server, start_agent_mcp_oauth, and later investigations. Opt out: do not add outside servers."
      }
     ]
    },
    {
     "t": "prose",
     "text": "The community edition is open source under the Apache-2.0 license and free to run yourself, also in paid products. The hosted Superlog Cloud has a free tier and paid plans."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The community edition may be used, changed and run in commercial settings under Apache-2.0.",
       "quote": "Superlog is licensed under the [Apache License 2.0](./LICENSE.md).",
       "src": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/README.md"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "Copies must carry the Apache-2.0 license and keep its notices.",
       "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
       "src": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/LICENSE.md"
      },
      {
       "l": "ai-training",
       "v": "No",
       "status": "no",
       "sub": "Superlog says it does not train foundation models on customer content, and neither may its subprocessors.",
       "quote": "We do not use Customer Content to train foundation models, and our subprocessors are not permitted to either.",
       "src": "https://superlog.sh/privacy"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "1.0.0 in the registry, updated Jul 21, 2026"
      },
      {
       "l": "Last release",
       "v": "no GitHub releases published; last commit 2026-11-03 at the pinned sha"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: an unauthenticated HEAD to https://api.superlog.sh/mcp answered HTTP 401 on 2026-11-10 (host up, sign-in required)",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Superlog",
       "me": true,
       "facts": [
        "1,487 stars",
        "Remote"
       ]
      },
      {
       "name": "io-github-grafana-mcp-grafana",
       "why": "Pick it if your telemetry already lives in Grafana",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "Netdata",
       "why": "Pick it if you need live server and machine health, not app-level traces",
       "path": "mcp/servers/io-github-netdata-mcp-server/",
       "facts": [
        "81.5K stars",
        "Remote"
       ]
      },
      {
       "name": "mcp",
       "why": "Pick it if the app runs on Cloudflare and you need its own logs and settings",
       "path": "mcp/servers/com-cloudflare-mcp-mcp/",
       "facts": [
        "4,474 stars",
        "Remote"
       ]
      }
     ],
     "more": "All cloud and devops servers",
     "more_path": "mcp/cloud/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Connect the Superlog MCP server (claude mcp add --transport http superlog https://api.superlog.sh/mcp), then search the last hour of error logs and traces for the checkout service and explain the most frequent error; do not change alerts or filters without asking me."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http superlog https://api.superlog.sh/mcp"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"superlog\": {\n      \"url\": \"https://api.superlog.sh/mcp\"\n    }\n  }\n}\n"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"superlog\": {\n      \"url\": \"https://api.superlog.sh/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "The configs come from the install panel in Superlog's own web app code; the README itself has no MCP setup."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "create_alert with aggregation 'avg' on logs, or a metric alert without metric_name",
       "fix": "count for logs and traces; sum or avg plus metric_name for source metric",
       "why": "The tool rejects other combinations."
      },
      {
       "dont": "update_issue_filter straight away",
       "fix": "get_issue_filter, then preview_issue_filter, then update_issue_filter",
       "why": "Each bucket you send replaces the old one, and the server's own guidance says to preview first."
      },
      {
       "dont": "set_project_context with only the new sentence",
       "fix": "read get_project_context, edit the returned text, send the whole text back (8000 characters at most)",
       "why": "The tool replaces the whole field, so a partial text erases the rest."
      },
      {
       "dont": "filtering failed requests by the span's status (OK or ERROR) to find HTTP 500s",
       "fix": "span_attrs [{key:\"http.response.status_code\", value:\"500\"}] on query_traces",
       "why": "HTTP status, route and method sit in span attributes, not in the span status."
      },
      {
       "dont": "delete_agent_memory to retire an outdated note",
       "fix": "update_agent_memory with status 'archived'",
       "why": "Delete is permanent; archiving can be undone."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Does my assistant need a key?",
       "a": "No for Claude Code, Codex and Cursor, which sign in through the browser. A personal access token is the option for tools without that sign-in.",
       "evidence": {
        "url": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/apps/web/src/onboarding/McpInstallDialog.tsx",
        "quote": "Prefer a static token over the OAuth flow? Generate a personal access token under"
       }
      },
      {
       "q": "Can I run it on my own servers?",
       "a": "Yes. The community edition runs locally with Docker, Node.js 20+ and pnpm 9+, with its API on port 4100.",
       "evidence": {
        "url": "https://github.com/superloglabs/superlog/blob/78123eebd23d41c54bd09c70a563ba311d7546e6/README.md",
        "quote": "API: `http://localhost:4100`"
       }
      },
      {
       "q": "Do I have to drop Sentry or Datadog?",
       "a": "No. Superlog connects to the tools you already use and adds their context.",
       "evidence": {
        "url": "https://superlog.sh/",
        "quote": "Connect the tools you already use, including Sentry, Datadog, Grafana, and your cloud provider."
       }
      },
      {
       "q": "Is my data used to train AI models?",
       "a": "The privacy policy says Superlog does not use customer content to train foundation models, and its subprocessors may not either.",
       "evidence": {
        "url": "https://superlog.sh/privacy",
        "quote": "We do not use Customer Content to train foundation models, and our subprocessors are not permitted to either."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "sh.superlog/superlog"
  ],
  [
   "Category",
   "Cloud and DevOps"
  ],
  [
   "Version",
   "1.0.0"
  ],
  [
   "Remote endpoint",
   "https://api.superlog.sh/mcp"
  ],
  [
   "License",
   "Apache-2.0"
  ],
  [
   "GitHub",
   "superloglabs/superlog"
  ],
  [
   "In the registry since",
   "Jul 21, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "Superlog only knows what your app sends it. Set up sending logs and traces first, or the assistant finds nothing.",
  "A connection with write access can create, change and delete alerts, dashboards and the shared home page. A read-only connection gets only the reading tools.",
  "The server tells connected assistants to save what they learn as memories for Superlog's own investigation agent, so expect it to write notes into your project."
 ],
 "checked_line": "Read by AgentGid from 16 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/superloglabs.png"
}