Axiom
# Instructions 1. Query Axiom datasets using Axiom Processing Language (APL). The query must be a valid APL query string. 2. ALWAYS get the schema of the dataset before running queries rather than gue
What is Axiom?
Axiom is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to # instructions 1. query axiom datasets using axiom processing language (apl). the query must be a valid apl query string. 2. always get the schema of the dataset before running queries rather than gue
# Instructions 1. Query Axiom datasets using Axiom Processing Language (APL). The query must be a valid APL query string. 2. ALWAYS get the schema of the dataset before running queries rather than gue
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- queryApl
- listDatasets
- getDatasetInfoAndSchema
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-server-axiomManual Installation
npx -y mcp-server-axiomConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Axiom
The Axiom MCP Server connects AI assistants to Axiom, a cloud-native log analytics and observability platform, enabling natural-language queries over your datasets using Axiom Processing Language (APL). It exposes tools to list available datasets, inspect dataset schemas, retrieve saved queries, check monitoring configurations, and execute APL queries directly, so developers can ask questions like 'How many 5xx errors occurred in the last hour?' without leaving their AI chat interface. Engineering and DevOps teams use it to accelerate incident investigation and log analysis by combining AI reasoning with Axiom's high-performance query engine.
Prerequisites
- An Axiom account with at least one dataset containing data (axiom.co)
- An Axiom API token with query permissions (created in Axiom settings)
- Go 1.21+ installed if building from source, or use the pre-built binary from GitHub releases
- An MCP-compatible client such as Claude Desktop
Obtain an Axiom API token
Log into your Axiom account, navigate to Settings > API Tokens, and create a new token with at minimum Query and Datasets:Read permissions. Copy the token (it starts with xaat-).
Install the axiom-mcp binary
Download the pre-built binary from the GitHub releases page, or build from source using go install. Note: this is the legacy local server; for production use Axiom recommends their hosted server at mcp.axiom.co.
go install github.com/axiomhq/axiom-mcp@latestCreate a configuration file
Create a config.txt file with your API token and the Axiom API URL. The config file is the simplest way to pass credentials to the binary.
echo "token xaat-your-api-token" > config.txt
echo "url https://api.axiom.co" >> config.txtConfigure your MCP client
Add the axiom-mcp binary to your Claude Desktop config, pointing to your config file. Alternatively, pass credentials as environment variables.
Verify with a dataset listing
Start Claude Desktop and ask the assistant to list your Axiom datasets to confirm the connection is working before running queries.
Axiom Examples
Client configuration
Add this block to claude_desktop_config.json. Replace the binary path with the actual location of your axiom-mcp binary and update the config file path.
{
"mcpServers": {
"axiom": {
"command": "/path/to/axiom-mcp",
"args": ["--config", "/path/to/config.txt"],
"env": {
"AXIOM_TOKEN": "xaat-your-api-token",
"AXIOM_URL": "https://api.axiom.co"
}
}
}
}Prompts to try
Example natural-language prompts that leverage the queryApl, listDatasets, getDatasetSchema, and monitoring tools:
- "List all my Axiom datasets and their schemas"
- "Show me all HTTP 500 errors from the api-logs dataset in the last 2 hours"
- "What are the top 10 endpoints by request count over the last 24 hours?"
- "Get the schema for my web-traffic dataset before I write a query"
- "List all my saved APL queries and run the one called 'error-rate-by-service'"
- "Check which monitors are currently in a firing state"Troubleshooting Axiom
Authentication failed or 401 errors on all tool calls
Verify that your AXIOM_TOKEN starts with 'xaat-' and has Query permissions. Check the token in Axiom Settings > API Tokens. Ensure the token is not set as an org-level token instead of a personal access token if your account requires it.
APL query returns an error about unknown fields
Always use the getDatasetSchema tool before writing queries to see the actual field names in your dataset. Field names are case-sensitive in APL and vary by ingestion source.
axiom-mcp binary not found or permission denied
If installed via go install, ensure $GOPATH/bin is on your PATH. Use the absolute path to the binary in the claude_desktop_config.json command field. On macOS/Linux, run 'chmod +x /path/to/axiom-mcp' if the binary lacks execute permission.
Frequently Asked Questions about Axiom
What is Axiom?
Axiom is a Model Context Protocol (MCP) server that # instructions 1. query axiom datasets using axiom processing language (apl). the query must be a valid apl query string. 2. always get the schema of the dataset before running queries rather than gue It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Axiom?
Install via npm with the command: npx -y mcp-server-axiom. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Axiom?
Axiom works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Axiom free to use?
Yes, Axiom is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Axiom Alternatives — Similar Analytics Servers
Looking for alternatives to Axiom? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Axiom in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Axiom?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.