MCP Directory

How to add Axiom MCP Server (Official Remote) to Windsurf

Query Axiom logs and events with APL via Axiom's hosted remote MCP server. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Axiom MCP Server (Official Remote) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Axiom MCP Server (Official Remote)'s tools become available to Cascade.

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 Windsurf

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) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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