Axiom

mcp-server-axiom

A Model Context Protocol server implementation for Axiom that enables AI agents to query your data using Axiom Processing Language (APL).

Status

Works with Claude desktop app. Implements two MCP tools:

queryApl: Execute APL queries against Axiom datasets
listDatasets: List available Axiom datasets

No support for MCP resources or prompts yet.

Installation

Releases

Download the latest built binary from the releases page.

Source

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

Configuration

Configure using one of these methods:

Config File Example (config.txt):

1token xaat-your-token
2url https://api.axiom.co
3query-rate 1
4query-burst 1
5datasets-rate 1
6datasets-burst 1

Command Line Flags:

1axiom-mcp \
2  -token xaat-your-token \
3  -url https://api.axiom.co \
4  -query-rate 1 \
5  -query-burst 1 \
6  -datasets-rate 1 \
7  -datasets-burst 1

Environment Variables:

1export AXIOM_TOKEN=xaat-your-token
2export AXIOM_URL=https://api.axiom.co
3export AXIOM_ORG_ID=your-org-id
4export AXIOM_QUERY_RATE=1
5export AXIOM_QUERY_BURST=1
6export AXIOM_DATASETS_RATE=1
7export AXIOM_DATASETS_BURST=1

Usage

Create a config file:

1echo "token xaat-your-token" > config.txt

Configure the Claude app to use the MCP server:

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

1{
2  "mcpServers": {
3    "axiom": {
4      "command": "/path/to/your/axiom-mcp-binary",
5      "args" : ["--config", "/path/to/your/config.txt"],
6      "env": { // Alternatively, you can set the environment variables here
7        "AXIOM_TOKEN": "xaat-your-token",
8        "AXIOM_URL": "https://api.axiom.co",
9        "AXIOM_ORG_ID": "your-org-id"
10      }
11    }
12  }
13}

License

MIT License - see LICENSE file

Contents