📌Overview

Purpose: To provide a server implementation of the Model Context Protocol that allows AI agents to execute data queries using Axiom Processing Language within the Axiom environment.

Overview: The mcp-server-axiom serves as a bridge between AI agents and Axiom's datasets, enabling efficient querying and interaction through a simple, configurable setup. Currently, it supports crucial functionalities but does not yet include resources or prompts.

Key Features:

APL Query Execution: Allows users to execute Axiom Processing Language (APL) queries against Axiom datasets, facilitating dynamic data retrieval and analysis.
Dataset Listing: Provides the capability to list all available datasets within the Axiom framework, helping users identify and utilize the data they can query effectively.

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

Create a config file:

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

Configure the Claude app to use the MCP server:

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

License

MIT License - see LICENSE file