Axiom Query MCP Server

Overview

Axiom Query is a Model Context Protocol (MCP) server that connects AI assistants to your Axiom data. It enables you to query and analyze data stored in Axiom using APL (Axiom Processing Language) directly from within AI assistants like Claude.

Installation

You can install Axiom Query in one of the following ways:

Option 1: Download pre-built binary

Download the latest binary from the releases page.

Option 2: Install from source

go install github.com/axiomhq/axiom-mcp@latest

Configuration

Axiom Query requires authentication to access your Axiom data. You can configure it using one of these methods:

Method 1: Configuration File

Create a configuration file (e.g., config.txt) with the following content:

token xaat-your-token
url https://api.axiom.co
query-rate 1
query-burst 1
datasets-rate 1
datasets-burst 1

Method 2: Command Line Flags

axiom-mcp \
  -token xaat-your-token \
  -url https://api.axiom.co \
  -query-rate 1 \
  -query-burst 1 \
  -datasets-rate 1 \
  -datasets-burst 1

Method 3: Environment Variables

export AXIOM_TOKEN=xaat-your-token
export AXIOM_URL=https://api.axiom.co
export AXIOM_ORG_ID=your-org-id
export AXIOM_QUERY_RATE=1
export AXIOM_QUERY_BURST=1
export AXIOM_DATASETS_RATE=1
export AXIOM_DATASETS_BURST=1

Setting Up with Claude

To use Axiom Query with Claude:

1. Create a configuration file as described above.

2. Configure the Claude app to use the MCP server by editing the Claude desktop configuration file:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "axiom": {
      "command": "/path/to/your/axiom-mcp-binary",
      "args": ["--config", "/path/to/your/config.txt"]
    }
  }
}

Alternatively, you can set environment variables directly in the configuration:

{
  "mcpServers": {
    "axiom": {
      "command": "/path/to/your/axiom-mcp-binary",
      "env": {
        "AXIOM_TOKEN": "xaat-your-token",
        "AXIOM_URL": "https://api.axiom.co",
        "AXIOM_ORG_ID": "your-org-id"
      }
    }
  }
}

3. Restart Claude to apply the changes.

Usage

Once configured, you can use the following tools in your AI assistant:

• queryApl: Execute APL queries against your Axiom datasets
• listDatasets: List all available Axiom datasets

Example usage in Claude:

• "Show me a list of my Axiom datasets"
• "Query my 'production-logs' dataset for errors in the last 24 hours"
• "Run an APL query to find the top 10 users by request count"

Rate Limiting

The server includes rate limiting to prevent excessive API usage. You can configure the rate limits using the parameters described in the configuration section:

• query-rate and query-burst: Control the rate of APL queries
• datasets-rate and datasets-burst: Control the rate of dataset listing operations