# mcp-server-axiom

> MCP Server

This repository provides a Model Context Protocol server for Axiom, enabling AI agents like Claude to query your Axiom data using Axiom Processing Language. It supports querying and listing Axiom datasets.

## Overview

- **Category:** Developer Tools
- **Language:** Go
- **Stars:** 60
- **Forks:** 2
- **Owner:** axiomhq
- **GitHub:** https://github.com/axiomhq/mcp-server-axiom
- **Created:** 2024-12-05T13:06:26+00:00
- **Updated:** 2025-03-28T15:29:46+00:00
- **Source:** https://model-context-protocol.com/servers/axiom-model-context-protocol-server

## Setup

## Setup

1.  **Releases:** Download the latest built binary from the [releases page](https://github.com/axiomhq/axiom-mcp/releases).
2.  **Source:** `go install github.com/axiomhq/axiom-mcp@latest`
3.  **Configuration:** Configure using a config file, command-line flags, or environment variables.
4.  **Config File Example (config.txt):** Create a config file with `token`, `url`, `query-rate`, `query-burst`, `datasets-rate`, and `datasets-burst`.
5.  **Command Line Flags:** Use flags like `-token`, `-url`, `-query-rate`, `-query-burst`, `-datasets-rate`, and `-datasets-burst` when running `axiom-mcp`.
6.  **Environment Variables:** Set environment variables like `AXIOM_TOKEN`, `AXIOM_URL`, `AXIOM_ORG_ID`, `AXIOM_QUERY_RATE`, `AXIOM_QUERY_BURST`, `AXIOM_DATASETS_RATE`, and `AXIOM_DATASETS_BURST`.
7.  **Create a config file:** `echo "token xaat-your-token" > config.txt`
8.  **Configure the Claude app:** Edit the `claude_desktop_config.json` file to include the MCP server configuration with the command to run the `axiom-mcp-binary` and its arguments, or set environment variables within the Claude app configuration.

## Tools

## Available Tools

1.  queryApl (Execute APL queries against Axiom datasets)
2.  listDatasets (List available Axiom datasets)