Axiom MCP Server
What is Axiom MCP Server
The mcp-server-axiom is a server implementation of the Model Context Protocol designed specifically for Axiom, allowing AI agents to perform queries on datasets using the Axiom Processing Language (APL). It facilitates interaction between AI applications and data stored in Axiom, enabling efficient query execution.
Use cases
The implementation can be used in various scenarios including data analysis, automated reporting, and AI-driven insights where querying large datasets is required. It is especially useful for users who need to interact with Axiom datasets from AI applications like the Claude desktop app.
How to use
To use the mcp-server-axiom, you must first configure it either via a configuration file, command line flags, or environment variables with your Axiom credentials and settings. After setup, you need to make sure the Claude application is configured to connect to the mcp-server-axiom, specifying the path to the binary and any required arguments.
Key features
Key features include execution of APL queries against Axiom datasets and listing available datasets. The server supports set query rates and burst limits for controlling the query load, ensuring efficient use of resources.
Where to use
This implementation is intended for use in environments where data integration and interaction with Axiom datasets are necessary, particularly in AI applications that require real-time querying capabilities. It is compatible with the Claude desktop app, making it suitable for AI-driven data analytics.
Overview
What is Axiom MCP Server
The mcp-server-axiom is a server implementation of the Model Context Protocol designed specifically for Axiom, allowing AI agents to perform queries on datasets using the Axiom Processing Language (APL). It facilitates interaction between AI applications and data stored in Axiom, enabling efficient query execution.
Use cases
The implementation can be used in various scenarios including data analysis, automated reporting, and AI-driven insights where querying large datasets is required. It is especially useful for users who need to interact with Axiom datasets from AI applications like the Claude desktop app.
How to use
To use the mcp-server-axiom, you must first configure it either via a configuration file, command line flags, or environment variables with your Axiom credentials and settings. After setup, you need to make sure the Claude application is configured to connect to the mcp-server-axiom, specifying the path to the binary and any required arguments.
Key features
Key features include execution of APL queries against Axiom datasets and listing available datasets. The server supports set query rates and burst limits for controlling the query load, ensuring efficient use of resources.
Where to use
This implementation is intended for use in environments where data integration and interaction with Axiom datasets are necessary, particularly in AI applications that require real-time querying capabilities. It is compatible with the Claude desktop app, making it suitable for AI-driven data analytics.
Content
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
License
MIT License - see LICENSE file