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:
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-token",
"AXIOM_URL": "https://api.axiom.co",
"AXIOM_ORG_ID": "your-org-id"
}
}
}
}
License
MIT License - see LICENSE file