MCP Directory

How to add Axiom MCP Server (Official Remote) to Claude Desktop

Query Axiom logs and events with APL via Axiom's hosted remote MCP server. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 130★ · stdio · oauth · official

Claude Desktop config for Axiom MCP Server (Official Remote)

npx -y mcp-remote https://mcp.axiom.co/mcp
{
  "mcpServers": {
    "axiom-mcp-server-official-remote": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.axiom.co/mcp"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Axiom MCP Server (Official Remote) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Axiom MCP Server (Official Remote)'s tools appear under the 🔌 tools menu.

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`)

What Axiom MCP Server (Official Remote) can do in Claude Desktop

queryApl

Run an APL (Axiom Processing Language) query against your datasets and return results

listDatasets

List the datasets available in your Axiom account

getDatasetSchema

Return the field/schema information for a given dataset

getSavedQueries

List saved/starred APL queries

getMonitors

List configured monitors

getMonitorsHistory

Return the firing/run history for monitors

Security

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) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Axiom MCP Server (Official Remote) config there under the "mcpServers" key and restart the client.

Is Axiom MCP Server (Official Remote) safe to use with Claude Desktop?

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.

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.

View repo Full Axiom MCP Server (Official Remote) page