Axiom

What is the project about?

Axiom MCP Server is a server that implements the Model Context Protocol (MCP) for Axiom. It allows AI agents to connect to Axiom and query logs, traces, and other event data using the Axiom Processing Language (APL).

How to use the project?

To use the server, you need to install the binary and configure it with your Axiom API token and URL. Once configured, you can connect it to a supported AI agent, such as the Claude desktop app, to start querying your data with natural language.

Key features of the project

• queryApl: An MCP tool to execute APL queries against your Axiom datasets.
• listDatasets: An MCP tool to list all available datasets in your Axiom instance.

Use cases of the project

• Enable AI agents to perform monitoring and observability tasks by querying log data.
• Allow for natural language analysis of traces and other event data for debugging and incident response.

FAQ from the project

The README for this project does not contain a specific FAQ section.

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