# Log10x MCP

> Log10x MCP is an open-source MCP server for analytics and data. Rank log message types by volume and cost, then cut or offload the noisy ones. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://doc.log10x.com/apps/mcp/
- **Repository:** https://github.com/log-10x/log10x-mcp
- **MCP Registry name:** io.github.log-10x/log10x-mcp
- **Categories:** analytics and data, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

The idea behind it is that most log volume is the same line repeating with only a timestamp or request ID changing, so the platform groups lines into message types and ranks those by volume and cost. Names come from symbols compiled out of your own code, which means the same line gets the same name on every node. The assistant can then answer questions such as why a service's log cost jumped this week, backed by per-pattern metrics.

Beyond reporting, the tools can act: sample, drop, compact, tier down or offload a chosen message type, and fetch offloaded events back from your own S3 bucket on demand. Policies ship as a pull request to merge, and a ConfigMap is written only by a separate, explicit call. A no-install savings estimate can be run from a local log file or an existing log platform, and install guidance covers serverless estates running on Lambda.

The server is MIT licensed. Without a LOG10X_API_KEY it starts read-only against a public demo dataset; an account key unlocks the account-scoped tools.

## Features

- **Pattern ranking:** Collapses repeating log lines into message types ranked by volume and cost.
- **Spike investigation:** Gives a timeline, correlated patterns and temporal evidence with confidence shown.
- **Mitigation actions:** Samples, drops, compacts, tiers down or offloads a chosen message type.
- **Savings estimates:** Projects and reports savings with per-pattern math, even from a local log file.
- **Event retrieval:** Fetches offloaded events back from your own S3 on demand.
- **Demo mode:** Boots read-only against a public dataset when no API key is set.

## Good for

- Find which services drive a log cost spike
- Decide whether muting DEBUG health-check logs is safe
- Estimate savings on existing logs before deploying anything
- Retrieve last quarter's auth errors that were offloaded
- Plan an install for a Lambda-only estate

## Install

### Claude Code (Terminal)

```sh
claude mcp add log10x-mcp --env LOG10X_API_KEY='<LOG10X_API_KEY>' -- npx -y log10x-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "log10x-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "log10x-mcp"
      ],
      "env": {
        "LOG10X_API_KEY": "<LOG10X_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "log10x-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "log10x-mcp"
      ],
      "env": {
        "LOG10X_API_KEY": "<LOG10X_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "log10x-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "log10x-mcp"
      ],
      "env": {
        "LOG10X_API_KEY": "<LOG10X_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "log10x-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "log10x-mcp"
      ],
      "env": {
        "LOG10X_API_KEY": "<LOG10X_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "log10x-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "log10x-mcp"
      ],
      "env": {
        "LOG10X_API_KEY": "<LOG10X_API_KEY>"
      }
    }
  }
}
```

## Tools

- `log10x_start`: Guided menu that routes to the next step.
- `log10x_top_patterns`: Top log message types by volume and cost.
- `log10x_investigate`: Single-call investigation of a spike.
- `log10x_savings`: Projected and realized savings.
- `log10x_estimate_savings`: Estimates potential savings.
- `log10x_pattern_mitigate`: Sample, drop, compact, tier down or offload a message type.
- `log10x_pattern_examples`: Examples of a message type.
- `log10x_pattern_trend`: Trend of a message type.
- `log10x_retriever_query`: Fetch offloaded events from your S3.
- `log10x_advise_install`: Install plan for your stack.
- `log10x_poc_from_local`: Savings report from a local log file.
- `log10x_services`: Services driving volume and cost.
- `log10x_whats_changing`: What moved week over week.

## FAQ

### Can I try it without an account?

Yes. Without an API key it boots read-only against a public demo dataset.

### What licence is the server under?

MIT; the account-scoped tools need a Log10x product licence key.

### How is the platform priced?

The pricing page says it is node-based, per infrastructure node rather than data volume; amounts are not given there.

### Does it change my config on its own?

No. Policies come as a pull request to merge, and ConfigMap writes need a second explicit call.

### Is Log10x MCP free?

Yes. Log10x MCP is open source, so you can use and self-host it for free.

### How do I add Log10x MCP to Claude Code?

Run this command in your terminal: claude mcp add log10x-mcp --env LOG10X_API_KEY='<LOG10X_API_KEY>' -- npx -y log10x-mcp

### What are the best alternatives to Log10x MCP?

The closest alternatives to Log10x MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/log10x-mcp
