Axiom MCP server
Axiom's official remote MCP server lets agents query logs, traces, and metrics with APL and manage datasets, monitors, and dashboards over OAuth.
The Axiom MCP server is Axiom's official integration that connects an AI client to your observability data so it can both query and navigate it. Its core is APL: agents run Axiom Processing Language queries against datasets to investigate logs, traces, and events, and run metric queries with MPL. Around that it exposes discovery and management — list datasets and inspect a dataset's schema, search metrics and list metric tags and tag values, retrieve saved APL queries, and read monitor configurations and their execution history. It can also work with dashboards end to end: list, get, create, update, export, and delete dashboards, and patch a single chart. That makes it a strong fit for an agent triaging an incident from raw events all the way to the dashboard that visualizes them.
The canonical deployment is the hosted remote endpoint at https://mcp.axiom.co/mcp over Streamable HTTP (an SSE endpoint is also available). It uses OAuth so credential isolation is handled automatically. For clients without browser-based OAuth you can authenticate with a personal access token via the Authorization: Bearer header and pass your organization with x-axiom-org-id or the ?org-id= URL parameter. Clients without native remote support can bridge with npx -y mcp-remote https://mcp.axiom.co/mcp.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"axiom": {
"type": "http",
"url": "https://mcp.axiom.co/mcp"
}
}
}claude mcp add --transport http axiom https://mcp.axiom.co/mcpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| queryApl | Executes an APL (Axiom Processing Language) query against Axiom datasets. |
| queryMetrics | Executes an MPL metric query against Axiom. |
| listDatasets | Lists the available Axiom datasets. |
| getDatasetSchema | Gets the schema of a dataset. |
| getSavedQueries | Retrieves saved (starred) APL queries. |
| getMonitors | Lists monitor configurations. |
| getMonitorsHistory | Gets the execution history of monitors. |
| listMetrics | Lists metric names. |
| searchMetrics | Searches metrics by tag value. |
| listMetricTags | Lists filterable tags for metrics. |
| getMetricTagValues | Gets the tag values available for filtering metrics. |
| listDashboards | Lists dashboards. |
| getDashboard | Gets a dashboard's details. |
| createDashboard | Creates a dashboard from JSON. |
| updateDashboard | Updates a dashboard by UID. |
| updateDashboardChart | Patches a single chart within a dashboard. |
| exportDashboard | Exports a dashboard as JSON. |
| deleteDashboard | Deletes a dashboard by UID. |
Required configuration
- AXIOM_TOKENOptional
Axiom personal access token, passed as a bearer token in the Authorization header when not using interactive OAuth.
- AXIOM_ORG_IDOptional
Axiom organization ID, sent as the x-axiom-org-id header or the org-id URL parameter for token-based auth.
What you can do with it
Investigate an incident from raw events
The agent lists datasets, inspects a schema, and writes an APL query to slice the logs and traces around an incident, then reuses a saved query or checks a monitor's history to see when the signal first fired.
Build and update the dashboard that explains it
After finding the signal, the agent creates or updates a dashboard and patches a single chart so the view that explains the issue is captured and shareable — all without leaving the editor.
FAQ
- Is it free?
- The MCP server is free to connect and works within your existing Axiom plan; usage counts against your account's query and ingest limits. Axiom offers a free tier, so you can try it without a paid plan.
- Does it support remote/OAuth?
- Yes. The canonical deployment is the remote endpoint at https://mcp.axiom.co/mcp using OAuth. For clients without browser-based OAuth, you can authenticate with a personal access token via the Authorization header and pass your org via x-axiom-org-id or ?org-id=.
- What is the standalone GitHub repo?
- Axiom's earlier standalone Go server (axiomhq/mcp-server-axiom) is archived. The maintained, canonical surface is the hosted remote server at https://mcp.axiom.co, which exposes the current, broader tool set including metrics and dashboards.