What is Axiom?

Axiom is an MCP (Model Context Protocol) server implementation for Axiom that enables AI agents to query your data using Axiom Processing Language (APL). It allows natural language interactions with Axiom logs, traces, and event data.

How to use Axiom?

1. Installation: Download the binary from releases or install via Go.

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

2. **Configuration**: Set up via config file, command-line flags, or environment variables.
   Example config (`config.txt`):
   ```txt
   token xaat-your-token
   url https://api.axiom.co

3. Usage: Configure the Claude desktop app to use the MCP server by editing claude_desktop_config.json.

Key Features of Axiom?

• Natural language querying of Axiom logs/traces/events via APL
• MCP tool integration (queryApl and listDatasets)
• Multi-config support (file, CLI, env vars)
• Rate-limiting for queries/dataset requests

Use Cases of Axiom?

1. AI-Assisted Log Analysis: Chat with your logs and traces.
2. Event Data Exploration: Query datasets using natural language.
3. Automated Monitoring: Integrate with AI agents for real-time insights.

FAQ from Axiom?

• Is Axiom compatible with other apps?

  Currently works with Claude desktop; others may follow.

• What’s required for setup?

  An Axiom API token and URL (e.g., https://api.axiom.co).

• Does it support MCP resources/prompts?

  Not yet; only MCP tools (queryApl/listDatasets).

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

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

Configuration

Configure using one of these methods:

Config File Example (config.txt):

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

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

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

Usage

1. Create a config file:

echo "token xaat-your-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-token",
        "AXIOM_URL": "https://api.axiom.co",
        "AXIOM_ORG_ID": "your-org-id"
      }
    }
  }
}

License

MIT License - see LICENSE file