Back to MCP Servers

Axiom

Query and analyze Axiom logs, traces, and event data using natural language with APL (Axiom Processing Language)

observabilityaxiomlogsmonitoringcommunity
By Axiom
6113Updated 5 months agoGoMIT

Installation

npx @axiomhq/mcp-server

Configuration

{
  "mcpServers": {
    "axiom": {
      "command": "npx",
      "args": ["-y", "@axiomhq/mcp-server"],
      "env": {
        "AXIOM_TOKEN": "your-axiom-api-token",
        "AXIOM_ORG_ID": "your-org-id"
      }
    }
  }
}

How to use

  1. Run the installation command above (if needed)
  2. Open your Claude Code settings file (~/.claude/settings.json)
  3. Add the configuration to the mcpServers section
  4. Restart Claude Code to apply changes

[DEPRECATED] mcp-server-axiom


⚠️ DEPRECATION NOTICE

This repository is deprecated and no longer maintained.
Please use the official Axiom MCP Server at https://mcp.axiom.co instead.


Overview

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 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.

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-api-token
url https://api.axiom.co
query-rate 1
query-burst 1
datasets-rate 1
datasets-burst 1
monitors-rate 1
monitors-burst 1

Command Line Flags:

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

Environment Variables:

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

Usage

  1. Create a config file:
echo "token xaat-your-api-token" > config.txt
  1. 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"
      }
    }
  }
}

License

MIT License - see LICENSE file

View source on GitHub