import Prerequisites from "/snippets/minimal-prerequisites.mdx" import ReplaceToken from "/snippets/replace-token.mdx" import PrerequisiteToken from "/snippets/prerequisite-token.mdx" import ReplaceOrgId from "/snippets/replace-org-id.mdx"

Axiom MCP Server is a Model Context Protocol server implementation that enables AI agents to query your data using Axiom Processing Language (APL).

For guidance on when to use Axiom MCP Server and Axiom Skills, see AI agents.

Current capabilities

Supported MCP tools

Axiom MCP Server supports the following MCP tools:

  • createDashboard: Create a dashboard from a JSON document
  • deleteDashboard: Delete a dashboard by UID
  • exportDashboard: Export a dashboard as JSON
  • getDashboard: Get dashboard details
  • getDatasetSchema: Get dataset schema
  • getMetricTagValues: Get values for a specific tag in a dataset
  • getMonitors: List monitoring configurations
  • getMonitorsHistory: Get monitor execution history
  • getSavedQueries: Retrieve saved APL queries
  • listDashboards: List dashboards
  • listDatasets: List available Axiom datasets
  • listMetricTags: List tags available for filtering in a dataset
  • listMetrics: List available metric names in a dataset
  • queryApl: Execute APL queries against Axiom datasets
  • queryMetrics: Execute MPL queries against Axiom datasets
  • searchMetrics: Search for metrics matching a known tag value
  • updateDashboard: Update a dashboard by UID

Supported MCP prompts

Axiom MCP Server supports the following MCP prompts:

  • correlate-events-across-datasets: Find patterns and correlations between events across multiple datasets
  • data-quality-investigation: Investigate data quality issues including missing data, inconsistencies, and collection problems
  • detect-anomalies-in-events: Generic anomaly detection using statistical analysis and pattern recognition across any dataset
  • establish-performance-baseline: Establish performance baselines for a dataset to enable effective monitoring and anomaly detection
  • explore-unknown-dataset: Exploration of an unknown dataset to understand its structure, content, and potential use cases
  • monitor-health-analysis: Comprehensive analysis of monitor health, alert patterns, and effectiveness

Axiom plans to support MCP resources in the future.

Axiom MCP Server works with all AI agents that support MCP.

Query results routing

The Axiom-hosted MCP Server is located in the US. When you query your data using the Axiom MCP Server using a remote MCP connection, query results are routed through US infrastructure.

Setup

Claude

If you’re on the Pro, Team, or Enterprise plan:

  1. Add Axiom to the list of remote MCP servers:
    • If you’re on the Pro plan, follow the Claude documentation to add Axiom to the list of remote MCP servers using the URL https://mcp.axiom.co/mcp.
    • If you’re on the Team or Enterprise plan, ask your organization admin to follow the Claude documentation to add Axiom to the list of remote MCP servers using the URL https://mcp.axiom.co/mcp.
  2. In Claude.ai or Claude Desktop, go to Settings > Connectors.
  3. Find Axiom in the list.
  4. Click Connect.
  5. Authenticate the request in your browser.

In Claude Code, follow the Claude Code documentation to add Axiom to the list of remote MCP servers using the URL https://mcp.axiom.co/mcp.

If you’re on the Free plan:

  1. Install Claude Desktop.

  2. In Claude Desktop, go to Settings > Developers, and then click Edit Config.

  3. Add the following to claude_desktop_config.json:

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

  4. Restart Claude Desktop.

  5. Authenticate the request in your browser.

Cursor

  1. Install Cursor.
  2. Install Axiom MCP Server.
  3. Authenticate the request in your browser.

Other clients

If your agent supports connecting to remote MCP servers directly:

  1. In your AI agent, add a remote MCP connection with the following details:

    • Name: Axiom
    • Server URL: https://mcp.axiom.co/mcp

    For AI agents that require server-sent events (SSE), use the server URL https://mcp.axiom.co/sse.

  2. Authenticate the request in your browser. You can later revoke access on the Profile page of the Axiom Console.

If your agent doesn’t support connecting to remote MCP servers directly, use the mcp-remote library:

  1. Add the mcp-remote library to the configuration file of your AI agent. For example:

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

  2. Restart your AI agent.

  3. Authenticate the request in your browser. You can later revoke access on the Profile page of the Axiom Console.

Header-based authentication

If your AI agent doesn’t support browser-based OAuth authentication (for example, Agent Builder from OpenAI), authenticate by passing headers directly:

  1. Create a personal access token.

  2. Determine organization ID.

  3. Configure your AI agent to use the server URL https://mcp.axiom.co/mcp.

  4. Configure your AI agent to send the following headers with each request to the server URL:

    • Authorization: Bearer PERSONAL_ACCESS_TOKEN
    • x-axiom-org-id: ORGANIZATION_ID
    Replace `PERSONAL_ACCESS_TOKEN` with the personal access token you have generated.

    If your AI agent only supports setting the Authorization header, pass the organization ID as a URL parameter: https://mcp.axiom.co/mcp?org-id=ORGANIZATION_ID

The setup explained above uses a remote MCP connection and is the recommended approach for most use cases. Alternatively, deploy Axiom MCP Server locally on your machine for more control.

Local setup

With the local setup:

  • You run Axiom MCP Server yourself.
  • You authenticate using an API token instead of OAuth 2.0.
  • You can’t use the MCP prompts mentioned in Current capabilities.

Install

Run the following to install the latest built binary from GitHub:

go install github.com/axiomhq/axiom-mcp@latest
Axiom MCP Server is an open-source project and welcomes your contributions. For more information, see the [GitHub repository](https://github.com/axiomhq/mcp-server-axiom).

Create API token

Configure

Configure your AI agent to use the MCP Server in one of the following ways:

Config file

  1. Create a config file where you specify the authentication and configuration details. For example:

    token API_TOKEN
url https://api.axiom.co
query-rate 1
query-burst 1
datasets-rate 1
datasets-burst 1
monitors-rate 1
monitors-burst 1

    Optionally, configure the rate and the burst limits at the query, dataset, and monitor levels. The rate limit is the maximum number of requests that your AI agent can make per second. The burst limit is the maximum number of requests that your AI agent can make in a short period (burst) before the rate limit applies to further requests.

  2. In the settings of your AI agent, reference the binary file of Axiom MCP Server and the config file you have previously created.

    For example, if you use the Claude desktop app, add axiom to the mcpServers section of the Claude configuration file. The default path is ~/Library/Application Support/Claude/claude_desktop_config.json on MacOS and %APPDATA%\Claude\claude_desktop_config.json on Windows.

    {
  "mcpServers": {
    "axiom": {
      "command": "PATH_AXIOM_MCP_BINARY",
      "args": [
        "--config",
        "PATH_AXIOM_MCP_CONFIG"
      ]
    }
  }
}
    Replace `PATH_AXIOM_MCP_BINARY` with the path the binary file of Axiom MCP Server.

    Replace PATH_AXIOM_MCP_CONFIG with the path the config file you have previously created.

Environment variables

In the settings of your AI agent, use environment variables to specify the authentication details and the binary file of Axiom MCP Server.

For example, if you use the Claude desktop app, add axiom to the mcpServers section of the Claude configuration file. The default path is ~/Library/Application Support/Claude/claude_desktop_config.json on MacOS and %APPDATA%\Claude\claude_desktop_config.json on Windows.

{
  "mcpServers": {
    "axiom": {
      "command": "PATH_AXIOM_MCP_BINARY",
      "env": {
        "AXIOM_TOKEN": "API_TOKEN",
        "AXIOM_URL": "https://api.axiom.co",
        "AXIOM_QUERY_RATE": "1",
        "AXIOM_QUERY_BURST": "1",
        "AXIOM_DATASETS_RATE": "1",
        "AXIOM_DATASETS_BURST": "1",
        "AXIOM_MONITORS_RATE": "1",
        "AXIOM_MONITORS_BURST": "1"
      }
    }
  }
}
Replace `PATH_AXIOM_MCP_BINARY` with the path the binary file of Axiom MCP Server.

Optionally, configure the rate and the burst limits at the query, dataset, and monitor levels. The rate limit is the maximum number of requests that your AI agent can make per second. The burst limit is the maximum number of requests that your AI agent can make in a short period (burst) before the rate limit applies to further requests.

Token hygiene

The remote MCP Server uses OAuth for authentication which handles credential isolation automatically. Agents never see your tokens. You can revoke access at any time.

For the local setup or when using Axiom Skills, you configure API tokens directly. For detailed guidance on secure token configuration, see Token hygiene for AI agents.

Use MCP Server

After setting up the Axiom MCP Server, you can:

  • Ask your own questions about your event data. For example:

    • “List datasets.”
    • “Get the data schema for the dataset logs.”
    • “Get the most common status codes in the last 30 minutes in the dataset logs.”

  • Use the prebuilt prompts. For example, in Claude, click + > Add from Axiom to access them.

To answer your questions, your AI client can use the supported MCP tools.

Revoke access

Using the procedure above, you authorized your AI client to access your event data in Axiom.

To revoke access:

  1. In Axiom, go to Settings > Profile.
  2. In the Sessions section, find the session where you authorized your AI client, and then click Delete on the right.

If you connected to Axiom MCP Server using the mcp-remote library, clear the .mcp-auth folder. This is where Axiom MCP Server stores credential information. On a Mac, the default path is ~/.mcp-auth.

Good afternoon

I'm here to help you with the docs.

⌘I
AIBased on your contextⓘ