co.axiom/mcp

List datasets, schemas, run APL queries, and use prompts for exploration, anomalies, and monitoring.

★ 11MITother

Install

Config snippet generator goes here (5 client tabs)

README

```

                  ███╗   ███╗ ██████╗██████╗
                  ████╗ ████║██╔════╝██╔══██╗
                  ██╔████╔██║██║     ██████╔╝
                  ██║╚██╔╝██║██║     ██╔═══╝
                  ██║ ╚═╝ ██║╚██████╗██║
                  ╚═╝     ╚═╝ ╚═════╝╚═╝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Model Context Protocol Server ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Axiom, Inc.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

# axiom-mcp
The Axiom MCP Server connects AI assistants to your Axiom observability data using the Model Context Protocol (MCP). This repository contains:

- A Cloudflare Workers app that hosts the MCP server (`apps/mcp`).
- A TypeScript package with core MCP utilities and tools (`packages/mcp`).

For installation, setup, supported tools, authentication, and client-specific instructions (Claude, Cursor, VS Code, etc.), please see the official documentation:

https://axiom.co/docs/console/intelligence/mcp-server#axiom-mcp-server

Issues and contributions are welcome. See AGENTS.md for contributor guidelines.
  - CSV formatting for tabular data instead of verbose JSON
  - Automatic `maxBinAutoGroups` for time-series aggregations
  - Intelligent result shaping that prioritizes important fields
  - Adaptive truncation based on data volume

## Runtime URL Parameters

When connecting to the hosted server endpoints (`/sse` or `/mcp`), you can pass runtime tuning parameters via query string:

- `max-age`: Integer. Caps total table cells rendered by tools. Example: `?max-age=500`.
- `with-otel`: Boolean (`1`/`true`). Enables OpenTelemetry tool family if your org has OTel integrations. Example: `?with-otel=1`.

Example connection URL (MCP Inspector):

```
http://localhost:8788/sse?org-id=<ORG_ID>&max-age=500&with-otel=1
```


## Troubleshooting

### Connection Issues

Remote MCP connections are still early. If you experience issues:
1. Try restarting your client
2. Disable and re-enable the Axiom MCP server
3. Check your authentication credentials
4. Try clearing and re-authenticating your client

### Authentication Errors

- **OAuth**: Ensure you're logged into Axiom in your browser

OR
- **Personal Token**: Verify your token starts with `xapt-` and hasn't expired
- **Organization ID**: Must match the organization that issued the token

## Support

- [Documentation](https://axiom.co/docs)
- [GitHub Issues](https://github.com/axiomhq/mcp/issues)
- [Community Discord](https://axiom.co/discord)

## License

MIT License - see [LICENSE](LICENSE) file for details.