mcp-server-axiom

# [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