Example prompts for Axiom

Paste any of these into Agent Studio after connecting Axiom.

List all datasets in my Axiom organization and their schemas

Run an APL query to find error rates in the past hour grouped by service

Detect anomalies in request latency over the last 24 hours

Show me the top 10 error messages from production logs this week

Excerpted from the project's README — boilerplate sections (license, changelog, contributing) omitted for clarity.


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

Axiom MCP server — FAQ

Common questions about connecting and running Axiom.

What authentication methods does the Axiom MCP server support?

The server supports OAuth (browser-based login) and personal tokens (starting with `xapt-`). Your organization ID must match the one that issued your token. See the official documentation for setup instructions.

How do I connect the Axiom MCP server to Claude or Cursor?

The README directs you to https://axiom.co/docs/console/intelligence/mcp-server for client-specific installation and configuration instructions for Claude, Cursor, VS Code, and other clients.

What is APL and can I write custom queries?

APL is Axiom Processing Language. The README does not document APL syntax or query examples, but the server allows you to run APL queries against your datasets. Refer to Axiom's documentation for APL query syntax.

Can I control query result size and format?

Yes. Use runtime URL parameters like `max-age` (caps total table cells) and `with-otel=1` (enables OpenTelemetry tools). Results are formatted as CSV for tabular data with intelligent field prioritization and adaptive truncation.

What should I do if I get connection or authentication errors?

Try restarting your client, disabling and re-enabling the Axiom MCP server, and verifying your credentials. For personal tokens, ensure they start with `xapt-` and haven't expired. Check GitHub Issues or the Community Discord for additional support.