Axiom MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'axiommcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Axiom MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'axiommcp_check_monitors',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "axiommcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Axiom MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="axiommcp_check_monitors",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update notifier, monitor, dashboard chart — Update an existing notifier’s configuration
• Search metrics — Search for metrics by name or partial name pattern
• Query metrics, dataset — Query OTel metrics from Axiom using MPL (Metrics Processing Language)
• List notifiers, metrics, metric tags — List all notifiers (notification channels such as email, Slack, PagerDuty) configured in the workspace
• Get saved queries, monitor history, metric tag values — List all saved APL queries in the Axiom workspace
• Dashboard export — Export a dashboard configuration as JSON for backup or sharing

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

axiommcp_check_monitors#List all monitors and their current status, showing which are firing or healthy.0 params▾

List all monitors and their current status, showing which are firing or healthy.

axiommcp_create_dashboard#Create a new dashboard in the Axiom workspace.2 params▾

Create a new dashboard in the Axiom workspace.

NameTypeRequiredDescription

namestringrequiredDashboard name.

descriptionstringoptionalDashboard description.

axiommcp_create_monitor#Create a new monitor (alert) that watches an APL query and fires when a threshold is crossed.4 params▾

Create a new monitor (alert) that watches an APL query and fires when a threshold is crossed.

NameTypeRequiredDescription

aplstringrequiredAPL query to evaluate.

namestringrequiredMonitor name.

descriptionstringoptionalMonitor description.

thresholdnumberoptionalThreshold value that triggers the alert.

axiommcp_create_notifier#Create a new notifier (notification channel) such as email, Slack webhook, or PagerDuty integration.2 params▾

Create a new notifier (notification channel) such as email, Slack webhook, or PagerDuty integration.

NameTypeRequiredDescription

namestringrequiredNotifier name.

typestringrequiredNotifier type (e.g. slack, email, pagerduty).

axiommcp_delete_dashboard#Delete a dashboard by ID.1 param▾

Delete a dashboard by ID.

NameTypeRequiredDescription

idstringrequiredThe dashboard ID to delete.

axiommcp_delete_monitor#Delete a monitor by ID.1 param▾

Delete a monitor by ID.

NameTypeRequiredDescription

idstringrequiredThe monitor ID to delete.

axiommcp_delete_notifier#Delete a notifier by ID.1 param▾

Delete a notifier by ID.

NameTypeRequiredDescription

idstringrequiredThe notifier ID to delete.

axiommcp_export_dashboard#Export a dashboard configuration as JSON for backup or sharing.1 param▾

Export a dashboard configuration as JSON for backup or sharing.

NameTypeRequiredDescription

idstringrequiredThe dashboard ID to export.

axiommcp_get_dashboard#Get details and configuration of a specific dashboard by ID.1 param▾

Get details and configuration of a specific dashboard by ID.

NameTypeRequiredDescription

idstringrequiredThe dashboard ID.

axiommcp_get_dataset_fields#List all fields in an events or traces dataset. Use this to understand the schema before writing APL queries. Do not use for otel-metrics-v1 datasets — use listMetrics() instead.1 param▾

List all fields in an events or traces dataset. Use this to understand the schema before writing APL queries. Do not use for otel-metrics-v1 datasets — use listMetrics() instead.

NameTypeRequiredDescription

datasetNamestringrequiredThe dataset name.

axiommcp_get_metric_tag_values#Get all values for a specific tag key on a given metric.3 params▾

Get all values for a specific tag key on a given metric.

NameTypeRequiredDescription

datasetNamestringrequiredThe name of the otel-metrics-v1 dataset.

metricNamestringrequiredThe metric name.

tagstringrequiredThe tag key to get values for.

axiommcp_get_monitor_history#Get the alert history for a specific monitor, including when it fired and resolved.1 param▾

Get the alert history for a specific monitor, including when it fired and resolved.

NameTypeRequiredDescription

idstringrequiredThe monitor ID.

axiommcp_get_saved_queries#List all saved APL queries in the Axiom workspace.0 params▾

List all saved APL queries in the Axiom workspace.

axiommcp_list_dashboards#List all dashboards in the Axiom workspace.0 params▾

List all dashboards in the Axiom workspace.

axiommcp_list_datasets#List all available datasets. The "kind" column determines which tools to use next: - events / otel.traces / other: use queryDataset() (APL) and getDatasetFields() - otel-metrics-v1: start with listMetrics() to inspect metric definitions and choose query strategy, then use queryMetrics(), searchMetrics(), listMetricTags(), and getMetricTagValues() — do NOT use queryDataset() or getDatasetFields() for these0 params▾

List all available datasets. The "kind" column determines which tools to use next: - events / otel.traces / other: use queryDataset() (APL) and getDatasetFields() - otel-metrics-v1: start with listMetrics() to inspect metric definitions and choose query strategy, then use queryMetrics(), searchMetrics(), listMetricTags(), and getMetricTagValues() — do NOT use queryDataset() or getDatasetFields() for these

axiommcp_list_metric_tags#List all tag keys available for a specific metric.2 params▾

List all tag keys available for a specific metric.

NameTypeRequiredDescription

datasetNamestringrequiredThe name of the otel-metrics-v1 dataset.

metricNamestringrequiredThe metric name.

axiommcp_list_metrics#List all metrics available in the otel-metrics-v1 dataset, including their names and types.1 param▾

List all metrics available in the otel-metrics-v1 dataset, including their names and types.

NameTypeRequiredDescription

datasetNamestringrequiredThe name of the otel-metrics-v1 dataset to list metrics from.

axiommcp_list_notifiers#List all notifiers (notification channels such as email, Slack, PagerDuty) configured in the workspace.0 params▾

List all notifiers (notification channels such as email, Slack, PagerDuty) configured in the workspace.

axiommcp_query_dataset#Query Axiom datasets using Axiom Processing Language (APL). Use for events, otel.traces, and other non-metrics datasets. Returns query results including matching events.3 params▾

Query Axiom datasets using Axiom Processing Language (APL). Use for events, otel.traces, and other non-metrics datasets. Returns query results including matching events.

NameTypeRequiredDescription

aplstringrequiredThe APL query to execute.

endTimestringoptionalEnd time for the query (ISO 8601 or 'now').

startTimestringoptionalStart time for the query (ISO 8601 or relative like '-1h').

axiommcp_query_metrics#Query OTel metrics from Axiom using MPL (Metrics Processing Language). Use for otel-metrics-v1 datasets.2 params▾

Query OTel metrics from Axiom using MPL (Metrics Processing Language). Use for otel-metrics-v1 datasets.

NameTypeRequiredDescription

datasetNamestringrequiredThe name of the otel-metrics-v1 dataset to query.

mplstringrequiredMPL (Metrics Processing Language) query expression to execute against the dataset.

axiommcp_search_metrics#Search for metrics by name or partial name pattern.2 params▾

Search for metrics by name or partial name pattern.

NameTypeRequiredDescription

datasetNamestringrequiredThe name of the otel-metrics-v1 dataset to search within.

valuestringrequiredSearch string to match metric names (partial match supported).

axiommcp_update_dashboard#Update an existing dashboard's metadata or configuration.3 params▾

Update an existing dashboard's metadata or configuration.

NameTypeRequiredDescription

idstringrequiredThe dashboard ID.

descriptionstringoptionalNew dashboard description.

namestringoptionalNew dashboard name.

axiommcp_update_dashboard_chart#Update a specific chart within a dashboard.3 params▾

Update a specific chart within a dashboard.

NameTypeRequiredDescription

chartIdstringrequiredThe chart ID to update.

dashboardIdstringrequiredThe dashboard ID.

querystringoptionalAPL query for the chart.

axiommcp_update_monitor#Update an existing monitor's configuration, query, or threshold.4 params▾

Update an existing monitor's configuration, query, or threshold.

NameTypeRequiredDescription

idstringrequiredThe monitor ID.

aplstringoptionalNew APL query.

namestringoptionalNew monitor name.

thresholdnumberoptionalNew threshold value.

axiommcp_update_notifier#Update an existing notifier's configuration.2 params▾

Update an existing notifier's configuration.

NameTypeRequiredDescription

idstringrequiredThe notifier ID.

namestringoptionalNew notifier name.