MCP Server Axiom

🚀 mcp-server-axiom

A Model Context Protocol server implemented for Axiom, enabling AI agents to query your data via Axiom Processing Language (APL).

🚀 Quick Start

This server is compatible with the Claude desktop application and implements two tools of MCP:

• queryApl: Execute APL queries on Axiom datasets.
• listDatasets: List available Axiom datasets.

Currently, the resource or prompt features of MCP are not supported.

📦 Installation

Release Version

Download the latest pre-built binary from the Releases page.

Source Code

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

⚙️ Configuration

You can configure the server using any of the following methods:

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

Basic Usage

1. Create a configuration file:

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

2. Configure the Claude application to use the MCP server:

Edit the ~/Library/Application\ Support/Claude/claude_desktop_config.json file and add the following content:

{
  "mcpServers": {
    "axiom": {
      "command": "/path/to/your/axiom-mcp-binary",
      "args" : ["--config", "/path/to/your/config.txt"],
      "env": { // Or set environment variables here
        "AXIOM_TOKEN": "xaat-your-token",
        "AXIOM_URL": "https://api.axiom.co",
        "AXIOM_ORG_ID": "your-org-id"
      }
    }
  }
}

📄 License

This project is under the MIT License - see the LICENSE file for details.