# Axiomhq Mcp

> List datasets, schemas, run APL queries, and use prompts for exploration, anomalies, and monitoring.

- **Type:** MCP server
- **Install:** `agentstack add mcp-axiomhq-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [axiomhq](https://agentstack.voostack.com/s/axiomhq)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [axiomhq](https://github.com/axiomhq)
- **Source:** https://github.com/axiomhq/mcp

## Install

```sh
agentstack add mcp-axiomhq-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

```

                  ███╗   ███╗ ██████╗██████╗
                  ████╗ ████║██╔════╝██╔══██╗
                  ██╔████╔██║██║     ██████╔╝
                  ██║╚██╔╝██║██║     ██╔═══╝
                  ██║ ╚═╝ ██║╚██████╗██║
                  ╚═╝     ╚═╝ ╚═════╝╚═╝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Model Context Protocol Server ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Axiom, Inc.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

# axiom-mcp
The Axiom MCP Server connects AI assistants to your Axiom observability data using the Model Context Protocol (MCP). This repository contains:

- A Cloudflare Workers app that hosts the MCP server (`apps/mcp`).
- A TypeScript package with core MCP utilities and tools (`packages/mcp`).

For installation, setup, supported tools, authentication, and client-specific instructions (Claude, Cursor, VS Code, etc.), please see the official documentation:

https://axiom.co/docs/console/intelligence/mcp-server#axiom-mcp-server

Issues and contributions are welcome. See AGENTS.md for contributor guidelines.
  - CSV formatting for tabular data instead of verbose JSON
  - Automatic `maxBinAutoGroups` for time-series aggregations
  - Intelligent result shaping that prioritizes important fields
  - Adaptive truncation based on data volume

## Runtime URL Parameters

When connecting to the hosted server endpoints (`/sse` or `/mcp`), you can pass runtime tuning parameters via query string:

- `max-age`: Integer. Caps total table cells rendered by tools. Example: `?max-age=500`.
- `with-otel`: Boolean (`1`/`true`). Enables OpenTelemetry tool family if your org has OTel integrations. Example: `?with-otel=1`.

Example connection URL (MCP Inspector):

```
http://localhost:8788/sse?org-id=&max-age=500&with-otel=1
```

## Troubleshooting

### Connection Issues

Remote MCP connections are still early. If you experience issues:
1. Try restarting your client
2. Disable and re-enable the Axiom MCP server
3. Check your authentication credentials
4. Try clearing and re-authenticating your client

### Authentication Errors

- **OAuth**: Ensure you're logged into Axiom in your browser

OR
- **Personal Token**: Verify your token starts with `xapt-` and hasn't expired
- **Organization ID**: Must match the organization that issued the token

## Support

- [Documentation](https://axiom.co/docs)
- [GitHub Issues](https://github.com/axiomhq/mcp/issues)
- [Community Discord](https://axiom.co/discord)

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [axiomhq](https://github.com/axiomhq)
- **Source:** [axiomhq/mcp](https://github.com/axiomhq/mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-axiomhq-mcp
- Seller: https://agentstack.voostack.com/s/axiomhq
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.