
Axiom MCP Server (Official Remote)
OfficialQuery Axiom logs and events with APL via Axiom's hosted remote MCP server.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y mcp-remote https://mcp.axiom.co/mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"axiom-mcp-server-official-remote": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.axiom.co/mcp"
]
}
}
}Before you start
- An Axiom account with at least one dataset
- For the hosted remote server: an MCP client that supports OAuth (you sign in through the browser, no token to copy)
- For the self-hosted Go binary: an Axiom API token (format xaat-...), created in the Axiom console under Settings → API tokens, set via AXIOM_TOKEN
- Go (only if installing the legacy binary via `go install github.com/axiomhq/axiom-mcp@latest`)
About Axiom MCP Server (Official Remote)
The Axiom MCP server lets AI agents query your Axiom datasets using APL (Axiom Processing Language), Axiom's query language for logs, traces, and events. Agents can list datasets, inspect schemas, run APL queries, and read saved queries and monitors, making it useful for log investigation and observability workflows driven by natural language.
Axiom now recommends its hosted remote MCP server at https://mcp.axiom.co, which uses OAuth so you authenticate in the browser rather than managing tokens by hand. The original open-source axiomhq/axiom-mcp Go implementation has been archived/deprecated in favor of this hosted server.
The self-hosted Go version exposed six tools and authenticated with an Axiom API token (format xaat-...) over stdio. The hosted version provides the same core querying capability with managed OAuth auth, so most users should connect to the remote endpoint instead of running a binary locally.
Tools & capabilities (6)
queryAplRun an APL (Axiom Processing Language) query against your datasets and return results
listDatasetsList the datasets available in your Axiom account
getDatasetSchemaReturn the field/schema information for a given dataset
getSavedQueriesList saved/starred APL queries
getMonitorsList configured monitors
getMonitorsHistoryReturn the firing/run history for monitors
When to use it
- Use it when you want to investigate logs or traces by asking questions in natural language and letting the agent write APL
- Use it when you need to discover what datasets and fields exist before querying
- Use it when you want to reuse saved queries during an incident investigation
- Use it when you want to check monitor status and history while debugging an alert
- Use it when you want to pull event/log data into an AI workflow for summarization or root-cause analysis
Quick setup
- 1Point your MCP client at the hosted remote server `https://mcp.axiom.co` (recommended)
- 2Complete the OAuth sign-in flow in your browser when the client connects
- 3Or, for self-hosting, install the Go binary and set AXIOM_TOKEN (and AXIOM_URL for non-default regions) before launching it over stdio
- 4Restart your MCP client to load the server
- 5Verify by asking the agent to list your datasets, then run a simple APL query
Security notes
The hosted server uses browser OAuth so no static token is stored locally, but it can read all event/log data in datasets the authorized user can access. The standalone Go binary path (mcp-server-axiom) is archived/deprecated and should not be used for new setups.
Axiom MCP Server (Official Remote) FAQ
Should I use the remote server or the GitHub repo?
Use the hosted remote server at https://mcp.axiom.co. The axiomhq/axiom-mcp Go repo is archived/deprecated; the remote server is the supported path and uses OAuth instead of manual tokens.
What query language does it use?
APL (Axiom Processing Language), Axiom's own query language for logs, traces, and events. The queryApl tool runs your APL and returns results.
How do I authenticate?
The hosted server uses OAuth, so you sign in via the browser. The legacy self-hosted binary used an Axiom API token of the form xaat-... passed via AXIOM_TOKEN.
Can it write data or create monitors?
No. The exposed tools are read/query oriented: running APL, listing datasets and schemas, and reading saved queries and monitors. It does not ingest data or create resources.
Does it support EU regions?
Yes. The hosted endpoint handles region routing, and the self-hosted binary supports AXIOM_URL to point at the correct API base for your region.
Alternatives to Axiom MCP Server (Official Remote)
Official Elastic server: list indices, read mappings, and search with Query DSL.
Official PostHog server: product analytics, feature flags, experiments, error tracking and SQL.
Run PromQL queries and analyze Prometheus metrics from any MCP client.
Compare Axiom MCP Server (Official Remote) with: