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

Works with Claude desktop app. Implements six MCP tools:

• queryApl: Execute APL queries against Axiom datasets
• listDatasets: List available Axiom datasets
• getDatasetSchema: Get dataset schema
• getSavedQueries: Retrieve saved/starred APL queries
• getMonitors: List monitoring configurations
• getMonitorsHistory: Get monitor execution history

Note: All tools require an API token for authentication. Use your API token as the token parameter.

No support for MCP resources or prompts yet.

Download the latest built binary from the releases page.

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

Configure using one of these methods:

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

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

export AXIOM_TOKEN=xaat-your-api-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

1. Create a config file:

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

2. Configure the Claude app to use the MCP server:

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

{
  "mcpServers": {
    "axiom": {
      "command": "/path/to/your/axiom-mcp-binary",
      "args" : ["--config", "/path/to/your/config.txt"],
      "env": { // Alternatively, you can set the environment variables here
        "AXIOM_TOKEN": "xaat-your-api-token",
        "AXIOM_URL": "https://api.axiom.co",
        "AXIOM_ORG_ID": "your-org-id"
      }
    }
  }
}

MIT License - see LICENSE file