Axiom Model Context Protocol Server

What is Axiom Model Context Protocol Server about?

Provides a Model Context Protocol (MCP) server implementation that connects AI agents (e.g., Claude) to Axiom's data platform, allowing execution of APL queries, dataset discovery, schema retrieval, saved query access, and monitor management.

How to use Axiom Model Context Protocol Server?

Installation – Download the pre‑built binary from the GitHub releases page or install from source with go install github.com/axiomhq/axiom-mcp@latest.
Configuration – Supply credentials and rate‑limit settings via a config file, command‑line flags, or environment variables (e.g., AXIOM_TOKEN, AXIOM_URL).
Integration – Point your AI‑agent client (Claude desktop) to the binary, passing the config file or environment variables as shown in the README.

Key Features

queryApl – Execute arbitrary APL queries against Axiom datasets.
listDatasets – Retrieve a list of all datasets accessible to the token.
getDatasetSchema – Fetch schema details for a specific dataset.
getSavedQueries – List saved or starred APL queries.
getMonitors – Enumerate monitoring configurations.
getMonitorsHistory – Access execution history for monitors.
Supports per‑tool rate limiting (query‑rate, datasets‑rate, monitors‑rate) and burst control.

Use Cases

Empowering AI assistants to perform real‑time analytics on log/event data stored in Axiom.
Automating dashboard generation or alerting logic via AI‑driven queries.
Providing AI agents with programmatic access to data schemas for dynamic query construction.
Integrating monitoring history into conversational AI for incident investigation.

FAQ

Q: Which authentication method is required? A: A valid Axiom API token must be supplied via the token parameter, config file, flag, or AXIOM_TOKEN environment variable.

Q: Can this server handle MCP resources or prompts? A: Currently only the six listed tools are supported; resources and prompts are not yet implemented.

Q: How are rate limits configured? A: Use the *-rate and *-burst options for queries, datasets, and monitors, either in the config file, flags, or corresponding environment variables.

Q: Is there a Docker image available? A: The README does not mention a Docker image; the recommended approach is to use the binary directly.

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

Create a config file:

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

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

Axiom Model Context Protocol Server