
# [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](https://mcp.axiom.co) instead.

---

## Overview
A [Model Context Protocol](https://modelcontextprotocol.io/) server implementation for [Axiom](https://axiom.co) that enables AI agents to query your data using Axiom Processing Language (APL).

## Status

Works with Claude desktop app. Implements six MCP [tools](https://modelcontextprotocol.io/docs/concepts/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](https://modelcontextprotocol.io/docs/concepts/resources) or [prompts](https://modelcontextprotocol.io/docs/concepts/prompts) yet.

## Installation

### Releases

Download the latest built binary from the [releases page](https://github.com/axiomhq/axiom-mcp/releases).

### Source

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

## Configuration

Configure using one of these methods:

### Config File Example (config.txt):
```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:
```bash
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:
```bash
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:
```bash
echo "token xaat-your-api-token" > config.txt
```

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

```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

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

Installation
