
                  ███╗   ███╗ ██████╗██████╗
                  ████╗ ████║██╔════╝██╔══██╗
                  ██╔████╔██║██║     ██████╔╝
                  ██║╚██╔╝██║██║     ██╔═══╝
                  ██║ ╚═╝ ██║╚██████╗██║
                  ╚═╝     ╚═╝ ╚═════╝╚═╝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
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:

Try restarting your client
Disable and re-enable the Axiom MCP server
Check your authentication credentials
Try clearing and re-authenticating your client

Authentication Errors

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

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

Support

License

MIT License - see LICENSE file for details.

Axiom