InstallationDownload the Latest Release
- Visit the releases page for the latest built binary.
Install from Source
- Run the following command:
go install github.com/axiomhq/axiom-mcp@latest
Configuration
Using a Config File
- Create a
config.txt file with the following content:
token xaat-your-token
url https://api.axiom.co
query-rate 1
query-burst 1
datasets-rate 1
datasets-burst 1
Using Command Line Flags
- Execute the
axiom-mcp with the following flags:
axiom-mcp
-token xaat-your-token
-url https://api.axiom.co
-query-rate 1
-query-burst 1
-datasets-rate 1
-datasets-burst 1
Using Environment Variables
- Set the following 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
- Run the following command to create a
config.txt:
echo "token xaat-your-token" > config.txt
Configure the Claude App
- Edit the
claude_desktop_config.json file located at ~/Library/Application Support/Claude/:
{
"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
- The software is licensed under the MIT License. See the LICENSE file for details.
go install github.com/axiomhq/axiom-mcp@latest
config.txt file with the following content:
token xaat-your-token
url https://api.axiom.co
query-rate 1
query-burst 1
datasets-rate 1
datasets-burst 1
axiom-mcp with the following flags:
axiom-mcp
-token xaat-your-token
-url https://api.axiom.co
-query-rate 1
-query-burst 1
-datasets-rate 1
-datasets-burst 1
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
config.txt:
echo "token xaat-your-token" > config.txt
claude_desktop_config.json file located at ~/Library/Application Support/Claude/:
{
"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"
}
}
}
}