Documentation

Axiom connector

The Axiom connector talks to your Axiom organisation with an API token and exposes five live MCP tools (datasets, APL query, monitors, and axiom_diagnose). It is tools-only — there is no Index / Add button and no RAG crawler. Logs you can query in Axiom do not land in the knowledge index. Event data changes too quickly for a daily crawl.

Generally available on Team+ (wave 2). Free workspaces can see the tile but cannot create the connector until they upgrade.

Connect

  1. In Axiom, create an Advanced API token (Settings → API Tokens). Grant at least query and dataset read on the datasets the agent should see. Prefer API tokens over personal access tokens.
  2. In the OrgMCP admin console, open Connectors → Add → Axiom.
  3. Paste the token (xaat-…). Leave Org ID blank for API tokens.
  4. Personal access tokens also need the org ID: Settings → General, or the path segment in https://app.axiom.co/<orgId>/…. Axiom returns 403 when that header is missing.
  5. Leave Host blank for Axiom Cloud (https://api.axiom.co). Origin only if you override it.
  6. Click Test connection. Green means the token can see at least one dataset. A valid token with zero datasets, or a 403, fails.

What Test connection proves

Not just "the token authenticates". OrgMCP lists datasets. Zero datasets is a red test — use axiom_diagnose (or the admin diagnostics panel) for host, org id, and the visible-dataset count. Axiom returns 403 for both a bad token and a personal token missing the org ID.

MCP tools

  • axiom_list_datasets / axiom_list_monitors — one page each; pass nextPageToken back as pageToken.
  • axiom_get_dataset — metadata for one dataset by id or name.
  • axiom_query — run APL. Results are capped (default 25 rows, max 100) and flagged truncated when more matched. Prefer a dataset-scoped query with a time window. Do not dump PII.
  • axiom_diagnose — auth mode, host, org id, visible dataset count + sample.

What does not get indexed

  • Nothing — this connector has no RAG ingest and no source_type. Use the live axiom_* tools (or another connector) for searchable knowledge.

Canonical matrix: docs/ARCH-connector-capabilities.md. Team+ plan (wave 2). See also Sentry for the parallel tools-only observability connector.