Content
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=<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.
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
firecrawl
Firecrawl MCP Server enables web scraping, crawling, and content extraction.
servers
Model Context Protocol Servers
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.