yokozuna-mcp
Yokozuna MCP gives coding agents programmatic access to Sumo Logic logs for searching, triaging, monitoring, and schema analysis — without leaving the editor.
Core Search
Run searches (
sumo_run_search): Execute Sumo Logic queries in one call with support for relative or absolute time ranges, output verbosity levels (summary,compact,full,raw), field projection, deduplication, and JSON extraction.Bulk export (
sumo_export_results): Stream up to 100,000 results to an NDJSON file on disk.Low-level search job primitives: Manually create, poll status, page messages/records, and delete search jobs for fine-grained control.
Triage & Diagnostics
Error digest (
sumo_error_digest): Auto-detects severity signals, deduplicates errors by normalized signature, and returns top problems with counts, timestamps, and sample request IDs.Trend analysis (
sumo_trend): Bucket logs over time with timeslice sparklines, split by auto-detected severity or a custom dimension.Poll for new logs (
sumo_new_since): Stateless cursor-based polling for logs arriving by receipt time, ideal for continuous monitoring loops.
Schema & Discovery
Facet exploration (
sumo_facets): See log data distribution via ranked top-N counts across multiple dimensions (native Sumo fields or JSON paths).Deep schema learning (
sumo_describe_schema): Stratified-samples a scope to enumerate JSON keys with fill percentages and inferred types, and proposes paste-ready severity filter fragments.
Alerting & Monitoring
List monitors (
sumo_list_monitors): Discover Sumo Logic Monitors with name, folder, type, enabled status, current state, and notification destinations.List fired alerts (
sumo_list_alerts): Query fired-alert history from the System Event Index, correlating fire and resolve events with monitor join keys.
Configuration: Credentials and deployment region are set via environment variables (SUMO_ACCESS_ID, SUMO_ACCESS_KEY, SUMO_DEPLOYMENT).
Provides tools for searching, querying, and managing Sumo Logic logs via the Search Job API, enabling incident triage and log analysis directly from the editor.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yokozuna-mcpsearch for errors in production logs from the last hour"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Yokozuna MCP
Yokozuna MCP (Model Context Protocol) gives coding agents (Claude Code, Claude Desktop, …) programmatic access to Sumo Logic logs via the Search Job API — so issues in preview deployments and production can be found and triaged without leaving the editor.
Transport: stdio (local, per-developer; credentials via env vars)
Deployment default: EU (
api.eu.sumologic.com), configurableToken-economical by default: lean output with explicit levers (
detail,fields,dedupe), bulk data goes to files instead of your context windowZero-config & schema-learning: only
SUMO_ACCESS_ID+SUMO_ACCESS_KEYare required. Severity schemas vary per system — the triage tools auto-detect each scope's severity signal at call time and disclose exactly what they applied (predicate, provenance, matched-N-of-M);sumo_describe_schemalearns any scope's schema in depth and proposes paste-ready filters. No schema config exists, on purpose.
Installation
Requires Node.js >= 20 and a Sumo Logic Enterprise access ID/key pair (ideally a
read-only service account). The package is on npm — npx -y yokozuna-mcp fetches and
runs it, so registering it in your MCP client is the whole install.
Claude Code
claude mcp add yokozuna --env SUMO_ACCESS_ID=suXXXX --env SUMO_ACCESS_KEY=<key> --env SUMO_DEPLOYMENT=eu -- npx -y yokozuna-mcpAdd --scope user to make it available in every project. Verify with claude mcp list.
Codex
Add to ~/.codex/config.toml (or use
codex mcp add yokozuna --env SUMO_ACCESS_ID=suXXXX --env SUMO_ACCESS_KEY=<key> -- npx -y yokozuna-mcp):
[mcp_servers.yokozuna]
command = "npx"
args = ["-y", "yokozuna-mcp"]
[mcp_servers.yokozuna.env]
SUMO_ACCESS_ID = "suXXXX"
SUMO_ACCESS_KEY = "<key>"
SUMO_DEPLOYMENT = "eu"Other clients (Claude Desktop, .mcp.json, from-source) are covered in the
installation docs.
Related MCP server: Log Reader MCP
Environment variables
The server does not read a .env file by itself — pass variables via the MCP
client's env block (as above).
Var | Required | Default | Notes |
| yes | — | Access ID. |
| yes | — | Access key. Never logged or echoed. |
| no |
| One of |
| no | derived | Explicit API base URL override; takes precedence over |
| no |
| UI origin for "open in Sumo UI" deep links, e.g. |
All remaining variables (output tuning, export dir, keepalive, facet defaults) are in the configuration docs.
Documentation
Full documentation — the 14-tool reference, the querying & schema-learning workflow, monitoring, troubleshooting, and development — lives at https://yokozuna-mcp.readthedocs.io/.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- -license-quality-maintenanceAn MCP server that enables developers to summon AI development team agents directly from their IDE to help with tasks like PR reviews, security evaluation, and CI/CD deployment setup.Last updated
- Alicense-qualityCmaintenanceAn MCP server that provides AI assistants with direct access to application logs for on-demand searching, filtering, and analysis. It enables tools like Cursor to summarize log entries and identify errors within the development environment to streamline debugging.Last updated307MIT
- Alicense-qualityCmaintenanceAn MCP server that connects Claude (or any MCP compatible client) to your existing log infrastructure. Query, summarize, and trace logs in plain English across GCP Cloud Logging, AWS CloudWatch, Azure Log Analytics, Grafana Loki, and Elasticsearch without writing filter expressions or leaving your editor.Last updated373MIT
- FlicenseBqualityBmaintenanceMCP server that integrates with Sumo Logic's API to perform log searches, data discovery, metrics queries, and monitoring.Last updated1537
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Paid remote MCP for agent code search routing MCP, structured receipts, audit logs, and reviewer-rea
An MCP server that gives your AI access to the source code and docs of all public github repos
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mbe24/yokozuna-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server