Metric Sensei API/MCP Gateway

You're reading the docs for v15, an older version that is still live. The current version is v16: read its docs.

Two APIs, one way of working

Metric Sensei has two public APIs. They do different jobs, but they are laid out the same way and take the same token, so what you learn on one works on the other.

	Admin API	API/MCP Gateway this guide
Use it to	Manage your account: clients, people and their access, data sources and connections, website tracking, services and billing. Everything the admin page does.	Use a client's data: run reports and tools on Google Analytics, Ads, Shopify, Meta and the other connected sources, from your scripts and from AI apps.
Address	`https://api.metricsensei.com`	`https://gateway.api.metricsensei.com`
REST	`https://api.metricsensei.com/clients` and so on	`https://gateway.api.metricsensei.com/tools` and so on
AI apps (MCP)	`https://api.metricsensei.com/mcp`	`https://gateway.api.metricsensei.com/mcp`
Guide	/docs	/docs
OpenAPI	/openapi.json	`https://gateway.api.metricsensei.com/openapi.json`
Versions	/versions	/versions

Connect an AI app: /mcp and sign in

AI apps such as Claude and ChatGPT connect to /mcp on either API and sign in with your Metric Sensei account: no token to copy. On the Admin API you choose read only or read and change; on the gateway you pick the client. The app then acts as you, with your own access. A sign-in for one API never works on the other, so connect each one the app should use. Sign apps out in the admin page.

One token for both

Create a personal API token in the admin page (it starts with msat_) and send it as Authorization: Bearer <token>. It acts as you, with your own role, on both APIs. A token names a person, not a client, so on the gateway also say which client you mean with the Metric-Sensei-Client: <client ID> header. A read-only token can read on both and change nothing.

export MS_TOKEN=msat_...

# Admin API: the clients you manage
curl -s https://api.metricsensei.com/clients -H "Authorization: Bearer $MS_TOKEN"

# API/MCP Gateway: the tools you can run for the client acme
curl -s https://gateway.api.metricsensei.com/tools -H "Authorization: Bearer $MS_TOKEN" -H "Metric-Sensei-Client: acme"

The gateway also takes a gateway API key (mcpgw_), which belongs to one client and needs no header.

The same on both

REST lives at the root of the address, AI apps connect at /mcp, and this guide is at /docs.
Without a version you get the latest. Put /v<N> first in the path, or send Metric-Sensei-Version: <N>, to stay on one version; /versions lists them.
Answers are JSON. Errors have an error code and a plain message.

Getting started

The API/MCP Gateway runs reports and tools on a client's connected data sources: Google Analytics, Google Ads, Shopify, Meta and 31 sources in all, plus Metric Sensei's own Analytics, SEO, Website Optimizer, Network Monitoring, Attribution and Offline Conversions. There are 722 tools, and every one is available two ways: to AI apps at https://gateway.api.metricsensei.com/mcp, and as plain JSON for scripts.

Call	What you get
`GET /connections`	The connections you can use, with your access to each
`GET /tools`	The tools you can run, with the fields each one takes
`POST /tools/{tool}`	Runs a tool. The body is the tool's fields; the answer is `{"result": ...}`
`GET /openapi.json`	An OpenAPI 3.1 document of the tools you can run

curl -s https://gateway.api.metricsensei.com/tools/ga4_run_report \
  -H "Authorization: Bearer $MS_TOKEN" -H "Metric-Sensei-Client: acme" -H "content-type: application/json" \
  -d '{"metrics": ["sessions"], "dimensions": ["date"]}'

The Reference below lists every tool. Which ones you can run depends on the client's connections and your access to them, so GET /tools is the list for you.

Tokens and sign-in

Credential	Send	Acts as
Personal API token (`msat_...`)	`Authorization: Bearer <token>` and `Metric-Sensei-Client: <client ID>`	You, with your current role in that client. A read-only token can only read.
Gateway API key (`mcpgw_...`)	`Authorization: Bearer <key>`	The person who owns the key, in the key's client, with that person's current role and access.
Sign-in (OAuth)	Handled by the AI app	You, in the client you picked when you signed in.

Create personal tokens and gateway keys in the admin page. Your role decides what you can use: client and agency admins can use every connection; a user can use only the connections they were given, and changes data only where they were also given change access.

Tools that change something need a connection that allows changes, and a token that isn't read-only.
Keep tokens and keys out of code and chats. If one leaks, revoke it in the admin page right away.

Connect an AI app

Add https://gateway.api.metricsensei.com/mcp as a remote MCP server and sign in when the app asks. You sign in with your Metric Sensei account and pick the client; the app then sees only the tools you have access to there.

Claude (claude.ai, Desktop and mobile): Settings → Connectors → Add custom connector, paste https://gateway.api.metricsensei.com/mcp, then Connect.
Claude Code: claude mcp add --transport http metricsensei https://gateway.api.metricsensei.com/mcp, then run /mcp and choose Authenticate.
ChatGPT, Cursor, VS Code and others: add a remote server with the Streamable HTTP transport and choose OAuth sign-in. No client ID is needed: apps find the sign-in through https://gateway.api.metricsensei.com/.well-known/oauth-protected-resource/mcp and register themselves.
Apps that can only send a fixed header: send Authorization: Bearer with a gateway API key, or a personal token plus the Metric-Sensei-Client header.

Signed-in apps are listed in the admin page under Connect an AI app, where you can sign them out. To let an AI app manage Metric Sensei itself, connect it to the Admin API's /mcp the same way.

Connections

A connection is one of the client's accounts on a data source (a GA4 property, an Ads account, a Shopify store), set up in the admin page. Every data-source tool takes an optional connection field with the connection's name. Leave it out when the client has only one connection for that source, or a default one; otherwise name it. GET /connections (MCP tool list_connections) lists the ones you can use, with their default IDs, so most tools need no account or property ID.

Built-in services (Analytics, SEO and the others) need no connection: their tools work while the service is turned on for the client.

Versions

Every deploy of the API/MCP Gateway is a new API version: v1, v2, v3 and so on. Older versions keep running unchanged until they're retired.

Without a version you always get the latest: https://gateway.api.metricsensei.com/mcp, https://gateway.api.metricsensei.com/tools.
To pin a version, put it before the path: https://gateway.api.metricsensei.com/v16/mcp.
Or send a header: Metric-Sensei-Version: 16.
Every response carries the version that answered it in the Metric-Sensei-Version header.
A retired version answers 410 Gone, and an unknown one 404. Move to the latest or a live version.

Version	Released	Status	Pinned URL
v16 latest	2026-11-12	Live	`https://gateway.api.metricsensei.com/v16`
v15	2026-11-12	Live	`https://gateway.api.metricsensei.com/v15`
v14	2026-11-11	Live	`https://gateway.api.metricsensei.com/v14`
v13	2026-11-10	Retired 2026-11-11	`https://gateway.api.metricsensei.com/v13`
v12	2026-11-10	Retired 2026-11-10	`https://gateway.api.metricsensei.com/v12`
v11	2026-11-09	Retired 2026-11-10	`https://gateway.api.metricsensei.com/v11`
v10	2026-11-09	Retired 2026-11-09	`https://gateway.api.metricsensei.com/v10`
v9	2026-11-08	Retired 2026-11-09: Use the latest version	`https://gateway.api.metricsensei.com/v9`
v8	2026-11-08	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v8`
v7	2026-11-08	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v7`
v6	2026-11-08	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v6`
v5	2026-11-08	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v5`
v4	2026-11-08	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v4`
v3	2026-11-08	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v3`
v2	2026-11-07	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v2`
v1	2026-11-07	Retired 2026-11-08: Use the latest version	`https://gateway.api.metricsensei.com/v1`

As JSON: GET https://gateway.api.metricsensei.com/versions

Requests, limits and errors

Send tool fields as a JSON object in the body of POST /tools/{tool}. Answers are JSON: a tool's answer is {"result": ...}, and an error has an error code and a plain message.

Status	Error	What it means
`400`	`bad_request`	The body isn't a JSON object.
`401`	`unauthorized`	No token, or one that isn't valid. AI apps are pointed at the sign-in.
`402`	`services_paused`	The account's services are paused for an overdue invoice. They resume within a minute of payment.
`404`	`unknown_tool`	No such tool, or not one you can use in this client.
`410`		The pinned version is retired.
`413`	`too_large`	The answer is too big. Narrow the request (fewer rows, a shorter date range).
`422`	`tool_error`	The tool ran but couldn't do it; the message says why (a missing field, the data source's own error).
`429`	`rate_limited`	Too many requests this minute. Wait the seconds in the `Retry-After` header.

Each client may make a set number of requests a minute, counted across all its API keys, tokens and signed-in apps. Every tool call counts toward the client's usage; a combined tool counts once.

Examples

curl -H "Authorization: Bearer $API_KEY" https://gateway.api.metricsensei.com/tools
curl -H "Authorization: Bearer $API_KEY" https://gateway.api.metricsensei.com/v16/tools
curl -H "Authorization: Bearer $API_KEY" -H "Metric-Sensei-Version: 16" https://gateway.api.metricsensei.com/tools
curl -H "Authorization: Bearer $MS_TOKEN" -H "Metric-Sensei-Client: acme" https://gateway.api.metricsensei.com/connections

For an AI app, use https://gateway.api.metricsensei.com/mcp to follow the latest version, or https://gateway.api.metricsensei.com/v16/mcp to stay on one. Sign-in works the same on every version.

Connections and combined tools

1 tool The gateway's own tools. list_connections is GET /connections in REST. Combined tools run several data sources' read-only tools at once, with your access to each, and count as one call.

List connections

GET/connections MCP tool list_connections Read only

The client's connections you can use, with their default IDs and settings. Use a connection's name as the connection field of other tools.

Field	Type	About
`service`	string	Only this service's connections, e.g. `ga4`.

Google Analytics 4

17 tools7 change data Tools for a client's Google Analytics 4 connections (ga4_...).

List GA4 accounts and properties

POST/tools/ga4_list_account_summaries MCP tool ga4_list_account_summaries Read only

List the GA4 accounts and properties this connection can access, with their property IDs.

Field	Type	About
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Get GA4 property

POST/tools/ga4_get_property MCP tool ga4_get_property Read only

Get a GA4 property's settings (time zone, currency, industry, service level).

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

List GA4 data streams

POST/tools/ga4_list_data_streams MCP tool ga4_list_data_streams Read only

List a property's web/app data streams, including web measurement IDs (G-XXXX).

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

List GA4 custom dimensions and metrics

POST/tools/ga4_list_custom_definitions MCP tool ga4_list_custom_definitions Read only

List a property's custom dimensions and custom metrics.

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Get GA4 report fields

POST/tools/ga4_get_metadata MCP tool ga4_get_metadata Read only

List the dimension and metric API names usable in reports for a property, including custom ones. Use 'search' to filter (e.g. 'session', 'revenue').

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`search`	string	Case-insensitive filter on name/category/description.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Run GA4 report

POST/tools/ga4_run_report MCP tool ga4_run_report Read only

Run a Google Analytics 4 report (Data API runReport). Returns rows as objects keyed by dimension and metric names. Defaults to the last 28 days and 1000 rows.

Field	Type	About
`metrics` required	array of string	Metric API names, e.g. activeUsers, sessions, screenPageViews, keyEvents, totalRevenue.
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`dimensions`	array of string	Dimension API names, e.g. date, country, sessionDefaultChannelGroup, pagePath.
`date_ranges`	array of object	YYYY-MM-DD or relative ('today', 'yesterday', '7daysAgo'). Up to 4 ranges.
`dimension_filter`	object	GA4 Data API FilterExpression, e.g. {"filter": {"fieldName": "country", "stringFilter": {"value": "Canada"}}}. Supports andGroup/orGroup/notExpression.
`metric_filter`	object	GA4 FilterExpression applied to metrics.
`order_bys`	array of object	GA4 OrderBy objects, e.g. [{"metric": {"metricName": "sessions"}, "desc": true}].
`limit`	integer
`offset`	integer
`metric_aggregations`	array of TOTAL \| MAXIMUM \| MINIMUM \| COUNT
`keep_empty_rows`	boolean
`currency_code`	string	ISO 4217 code, e.g. USD.
`return_property_quota`	boolean	Include remaining API quota.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Run GA4 realtime report

POST/tools/ga4_run_realtime_report MCP tool ga4_run_realtime_report Read only

Run a realtime report covering the last 30 minutes (or custom minute_ranges).

Field	Type	About
`metrics` required	array of string	e.g. activeUsers, eventCount.
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`dimensions`	array of string	e.g. country, unifiedScreenName, eventName.
`minute_ranges`	array of object	e.g. [{"startMinutesAgo": 29, "endMinutesAgo": 0}].
`dimension_filter`	object	GA4 Data API FilterExpression, e.g. {"filter": {"fieldName": "country", "stringFilter": {"value": "Canada"}}}. Supports andGroup/orGroup/notExpression.
`metric_filter`	object	GA4 FilterExpression applied to metrics.
`order_bys`	array of object
`limit`	integer
`metric_aggregations`	array of TOTAL \| MAXIMUM \| MINIMUM \| COUNT
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

List GA4 property settings

POST/tools/ga4_list_resources MCP tool ga4_list_resources Read only

List a property's key events, Google Ads links, data streams, custom definitions or measurement protocol secrets (those need stream_id).

Field	Type	About
`resource_type` required	data_streams \| custom_dimensions \| custom_metrics \| key_events \| google_ads_links \| measurement_protocol_secrets
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`stream_id`	string	Data stream ID; only for measurement_protocol_secrets.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Create GA4 property setting

POST/tools/ga4_create_resource MCP tool ga4_create_resource Changes data

Create a data stream, custom dimension/metric, key event, Google Ads link or measurement protocol secret. body is the Admin API resource, e.g. {"parameterName": "plan", "displayName": "Plan", "scope": "EVENT"} for a custom dimension, or {"eventName": "purchase"} for a key event.

Field	Type	About
`resource_type` required	data_streams \| custom_dimensions \| custom_metrics \| key_events \| google_ads_links \| measurement_protocol_secrets
`body` required	object
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`stream_id`	string	Data stream ID; only for measurement_protocol_secrets.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Update GA4 property setting

POST/tools/ga4_update_resource MCP tool ga4_update_resource Changes data

Change fields of a data stream, custom dimension/metric, key event, Ads link or MP secret. Only the top-level fields in body change.

Field	Type	About
`resource_type` required	data_streams \| custom_dimensions \| custom_metrics \| key_events \| google_ads_links \| measurement_protocol_secrets
`resource_id` required	string
`body` required	object
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`stream_id`	string	Data stream ID; only for measurement_protocol_secrets.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Delete or archive GA4 property setting

POST/tools/ga4_delete_resource MCP tool ga4_delete_resource Changes data

Delete a key event, Ads link, MP secret or data stream, or archive a custom dimension/metric. Deleting a data stream returns a preview unless confirm=true.

Field	Type	About
`resource_type` required	data_streams \| custom_dimensions \| custom_metrics \| key_events \| google_ads_links \| measurement_protocol_secrets
`resource_id` required	string
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`stream_id`	string	Data stream ID; only for measurement_protocol_secrets.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Create GA4 property

POST/tools/ga4_create_property MCP tool ga4_create_property Changes data

Create a GA4 property in an account (then add a web data stream with ga4_create_resource).

Field	Type	About
`account_id` required	string
`display_name` required	string
`time_zone` required	string	IANA time zone, e.g. America/New_York.
`currency_code`	string	ISO 4217, e.g. USD.
`industry_category`	string	e.g. SHOPPING, TRAVEL, FINANCE.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Update GA4 property

POST/tools/ga4_update_property MCP tool ga4_update_property Changes data

Change a property's name, time zone, currency or industry.

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`display_name`	string
`time_zone`	string	IANA time zone, e.g. America/New_York.
`currency_code`	string	ISO 4217, e.g. USD.
`industry_category`	string	e.g. SHOPPING, TRAVEL, FINANCE.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Delete GA4 property

POST/tools/ga4_delete_property MCP tool ga4_delete_property Changes data

Move a property to the trash (deleted for good after 35 days). Returns a preview unless confirm=true.

Field	Type	About
`property_id` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Get GA4 data retention

POST/tools/ga4_get_data_retention MCP tool ga4_get_data_retention Read only

Get how long the property keeps user-level event data.

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Update GA4 data retention

POST/tools/ga4_update_data_retention MCP tool ga4_update_data_retention Changes data

Change event data retention (TWO_MONTHS, FOURTEEN_MONTHS; 360 properties also TWENTY_SIX_MONTHS, THIRTY_EIGHT_MONTHS, FIFTY_MONTHS) and whether new activity resets it.

Field	Type	About
`property_id`	string	GA4 property ID (digits, e.g. '123456789'). Defaults to the connection's default property.
`event_data_retention`	string
`reset_on_new_activity`	boolean
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Google Analytics 4: setup checks

POST/tools/ga4_setup_checks MCP tool ga4_setup_checks Read only

Whether everything on the Google Analytics 4 side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Analytics 4 connection to use. Optional when the client has one, or a default.

Google Tag Manager

37 tools23 change data Tools for a client's Google Tag Manager connections (gtm_...).

List GTM accounts

POST/tools/gtm_list_accounts MCP tool gtm_list_accounts Read only

List Google Tag Manager accounts this connection can access.

Field	Type	About
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

List GTM containers

POST/tools/gtm_list_containers MCP tool gtm_list_containers Read only

List containers in a GTM account (IDs, public GTM-XXXX IDs, usage context).

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

List GTM workspaces

POST/tools/gtm_list_workspaces MCP tool gtm_list_workspaces Read only

List workspaces in a GTM container.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Get GTM workspace status

POST/tools/gtm_get_workspace_status MCP tool gtm_get_workspace_status Read only

Show a workspace's unpublished changes and merge conflicts.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

List GTM workspace entities

POST/tools/gtm_list_entities MCP tool gtm_list_entities Read only

List tags, triggers, variables, folders, templates, etc. in a workspace (summary by default).

Field	Type	About
`entity_type` required	tags \| triggers \| variables \| folders \| templates \| clients \| transformations \| zones \| built_in_variables
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`full`	boolean	Return every field instead of a summary.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Get GTM workspace entity

POST/tools/gtm_get_entity MCP tool gtm_get_entity Read only

Get one tag, trigger, variable, folder, template, client, transformation or zone.

Field	Type	About
`entity_type` required	tags \| triggers \| variables \| folders \| templates \| clients \| transformations \| zones	Kind of workspace entity.
`entity_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

List GTM container versions

POST/tools/gtm_list_versions MCP tool gtm_list_versions Read only

List a container's version headers (ID, name, counts).

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Get live GTM version

POST/tools/gtm_get_live_version MCP tool gtm_get_live_version Read only

Get the currently published container version (summary by default).

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`full`	boolean
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Create GTM workspace entity

POST/tools/gtm_create_entity MCP tool gtm_create_entity Changes data

Create a tag, trigger, variable, etc. in a workspace. 'body' is the GTM API resource, e.g. {"name": "GA4 event", "type": "gaawe", "parameter": [...], "firingTriggerId": ["12"]}.

Field	Type	About
`entity_type` required	tags \| triggers \| variables \| folders \| templates \| clients \| transformations \| zones	Kind of workspace entity.
`body` required	object
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Update GTM workspace entity

POST/tools/gtm_update_entity MCP tool gtm_update_entity Changes data

Replace a workspace entity. Fetch it with gtm_get_entity first, change fields, and send the whole object back. Pass its fingerprint to avoid overwriting concurrent edits.

Field	Type	About
`entity_type` required	tags \| triggers \| variables \| folders \| templates \| clients \| transformations \| zones	Kind of workspace entity.
`entity_id` required	string
`body` required	object
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`fingerprint`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Delete GTM workspace entity

POST/tools/gtm_delete_entity MCP tool gtm_delete_entity Changes data

Delete a tag, trigger, variable, etc. from a workspace (not live until published).

Field	Type	About
`entity_type` required	tags \| triggers \| variables \| folders \| templates \| clients \| transformations \| zones	Kind of workspace entity.
`entity_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Create GTM container version

POST/tools/gtm_create_version MCP tool gtm_create_version Changes data

Create a container version from a workspace's changes (does not publish it).

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`name`	string
`notes`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Publish GTM container version

POST/tools/gtm_publish_version MCP tool gtm_publish_version Changes data

Publish a container version so it goes live on the site or app. Without confirm=true it only returns a preview; show it to the user and call again with confirm=true once they agree.

Field	Type	About
`version_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`fingerprint`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Update GTM account

POST/tools/gtm_update_account MCP tool gtm_update_account Changes data

Rename a GTM account or change whether it shares data with Google.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`name`	string
`share_data`	boolean
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Create GTM container

POST/tools/gtm_create_container MCP tool gtm_create_container Changes data

Create a container in an account. usage_context is web (default), android, ios, amp or server.

Field	Type	About
`name` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`usage_context`	array of web \| android \| ios \| amp \| server
`domain_name`	array of string
`notes`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Update GTM container

POST/tools/gtm_update_container MCP tool gtm_update_container Changes data

Rename a container or change its domain names or notes. Only the fields passed change.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`name`	string
`domain_name`	array of string
`notes`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Delete GTM container

POST/tools/gtm_delete_container MCP tool gtm_delete_container Changes data

Delete a container and everything in it; cannot be undone. Without confirm=true it only returns a preview.

Field	Type	About
`container_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Get GTM install snippet

POST/tools/gtm_get_container_snippet MCP tool gtm_get_container_snippet Read only

Get the HTML/JS snippet that installs a container on a site.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Find GTM container

POST/tools/gtm_lookup_container MCP tool gtm_lookup_container Read only

Find a container by its public ID (GTM-XXXX) or by a Google tag ID (G-XXXX, AW-XXXX).

Field	Type	About
`public_id`	string
`tag_id`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

List GTM destinations

POST/tools/gtm_list_destinations MCP tool gtm_list_destinations Read only

List destinations (e.g. GA4 data streams) linked to a Google tag container.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Link GTM destination

POST/tools/gtm_link_destination MCP tool gtm_link_destination Changes data

Link a destination such as a GA4 measurement ID (G-XXXX) to a Google tag container.

Field	Type	About
`destination_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`allow_user_permission_feature_update`	boolean
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Create GTM workspace

POST/tools/gtm_create_workspace MCP tool gtm_create_workspace Changes data

Create a workspace (a separate draft of the container) to make changes in.

Field	Type	About
`name` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`description`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Update GTM workspace

POST/tools/gtm_update_workspace MCP tool gtm_update_workspace Changes data

Rename a workspace or change its description.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`name`	string
`description`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Delete GTM workspace

POST/tools/gtm_delete_workspace MCP tool gtm_delete_workspace Changes data

Delete a workspace and its unpublished changes. Without confirm=true it only returns a preview.

Field	Type	About
`workspace_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Sync GTM workspace

POST/tools/gtm_sync_workspace MCP tool gtm_sync_workspace Changes data

Update a workspace to the latest container version. Lists merge conflicts if there are any.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Resolve GTM merge conflict

POST/tools/gtm_resolve_conflict MCP tool gtm_resolve_conflict Changes data

Resolve a merge conflict: pass the entity as it should end up (e.g. {"tag": {...}}), taken from gtm_get_workspace_status, with the conflict's fingerprint.

Field	Type	About
`entity` required	object
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`fingerprint`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Preview GTM workspace

POST/tools/gtm_quick_preview MCP tool gtm_quick_preview Changes data

Compile a workspace into a preview to check it builds. Nothing goes live.

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Revert GTM workspace entity

POST/tools/gtm_revert_entity MCP tool gtm_revert_entity Changes data

Undo this workspace's changes to one tag, trigger, variable, folder, etc.

Field	Type	About
`entity_type` required	tags \| triggers \| variables \| folders \| templates \| clients \| transformations \| zones	Kind of workspace entity.
`entity_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`fingerprint`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Enable or disable GTM built-in variables

POST/tools/gtm_set_built_in_variables MCP tool gtm_set_built_in_variables Changes data

Turn built-in variables on (enable) or off (disable), e.g. enable ["pageUrl", "clickText"].

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`workspace_id`	string	Workspace ID. Defaults to the connection's default workspace.
`enable`	array of string
`disable`	array of string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

List GTM environments

POST/tools/gtm_list_environments MCP tool gtm_list_environments Read only

List a container's environments (Live, Latest and custom ones such as staging).

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Create or update GTM environment

POST/tools/gtm_save_environment MCP tool gtm_save_environment Changes data

Create a custom environment, or change one by environment_id. Setting version_id makes that environment serve the version (publishing to staging, not live).

Field	Type	About
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`environment_id`	string	Omit to create a new environment.
`name`	string
`description`	string
`url`	string	Default preview URL for the environment.
`enable_debug`	boolean
`version_id`	string	Container version this environment serves.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Delete GTM environment

POST/tools/gtm_delete_environment MCP tool gtm_delete_environment Changes data

Delete a custom environment; its snippet stops working.

Field	Type	About
`environment_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Reset GTM environment link

POST/tools/gtm_reauthorize_environment MCP tool gtm_reauthorize_environment Changes data

Issue a new auth code for an environment, so old preview and share links stop working.

Field	Type	About
`environment_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Get GTM container version

POST/tools/gtm_get_version MCP tool gtm_get_version Read only

Get one container version in full (tags, triggers, variables, etc.).

Field	Type	About
`version_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Update GTM container version

POST/tools/gtm_update_version MCP tool gtm_update_version Changes data

Rename a container version or change its notes.

Field	Type	About
`version_id` required	string
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`name`	string
`notes`	string
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Delete, undelete or set latest GTM version

POST/tools/gtm_manage_version MCP tool gtm_manage_version Changes data

Delete or undelete a container version, or make it the latest version (the base for new workspaces). Delete returns a preview unless confirm=true.

Field	Type	About
`version_id` required	string
`action` required	delete \| undelete \| set_latest
`account_id`	string	GTM account ID. Defaults to the connection's default account.
`container_id`	string	GTM container ID (numeric, not GTM-XXXX). Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Google Tag Manager: setup checks

POST/tools/gtm_setup_checks MCP tool gtm_setup_checks Read only

Whether everything on the Google Tag Manager side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Tag Manager connection to use. Optional when the client has one, or a default.

Google Search Console

9 tools4 change data Tools for a client's Google Search Console connections (gsc_...).

List Search Console sites

POST/tools/gsc_list_sites MCP tool gsc_list_sites Read only

List the Search Console properties (sites) this connection can access.

Field	Type	About
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Query Search Console performance

POST/tools/gsc_search_analytics MCP tool gsc_search_analytics Read only

Google Search performance for a site: clicks, impressions, CTR and average position, grouped by dimensions such as query, page, country, device or date. Defaults to the last 28 days by query. Data is usually 2-3 days behind; set include_fresh_data for preliminary recent days. Grouping by hour covers about the last 10 days (Pacific time).

Field	Type	About
`site_url`	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`dimensions`	array of date \| query \| page \| country \| device \| searchAppearance \| hour
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`search_type`	web \| image \| video \| news \| discover \| googleNews
`filters`	array of object	All must match, e.g. [{'dimension': 'page', 'expression': '/blog/'}].
`limit`	integer
`start_row`	integer
`include_fresh_data`	boolean
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Inspect a URL in Search Console

POST/tools/gsc_inspect_url MCP tool gsc_inspect_url Read only

Check how Google sees one page: whether it is indexed (and why not), the Google-chosen canonical, last crawl, mobile usability and rich results. Limited to 2,000 checks a day per site.

Field	Type	About
`url` required	string	Full URL of the page, inside the site.
`site_url`	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`language_code`	string	Language for messages, e.g. 'en-US'.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

List Search Console sitemaps

POST/tools/gsc_list_sitemaps MCP tool gsc_list_sitemaps Read only

List a site's submitted sitemaps with status, last download, warnings and errors.

Field	Type	About
`site_url`	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Submit a sitemap

POST/tools/gsc_submit_sitemap MCP tool gsc_submit_sitemap Changes data

Submit or resubmit a sitemap URL to Search Console for a site.

Field	Type	About
`sitemap_url` required	string	Full sitemap URL.
`site_url`	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Delete a sitemap

POST/tools/gsc_delete_sitemap MCP tool gsc_delete_sitemap Changes data

Remove a sitemap from Search Console. The sitemap file on the website is not changed.

Field	Type	About
`sitemap_url` required	string	Full sitemap URL.
`site_url`	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Add Search Console site

POST/tools/gsc_add_site MCP tool gsc_add_site Changes data

Add a site (https://www.example.com/ or sc-domain:example.com) to Search Console. Ownership still has to be verified.

Field	Type	About
`site_url` required	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Remove Search Console site

POST/tools/gsc_remove_site MCP tool gsc_remove_site Changes data

Remove a site from this Google account's Search Console. Returns a preview unless confirm=true.

Field	Type	About
`site_url` required	string	Site, e.g. 'https://www.example.com/' or 'sc-domain:example.com'. Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Google Search Console: setup checks

POST/tools/gsc_setup_checks MCP tool gsc_setup_checks Read only

Whether everything on the Google Search Console side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Search Console connection to use. Optional when the client has one, or a default.

Google Business Profile

20 tools8 change data Tools for a client's Google Business Profile connections (gbp_...).

Business Profile: list live events

POST/tools/gbp_list_live_events MCP tool gbp_list_live_events Read only

List events Business Profile pushed to Metric Sensei by webhook (NEW_REVIEW, UPDATED_REVIEW, GOOGLE_UPDATE, NEW_CUSTOMER_MEDIA), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use gbp_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. NEW_REVIEW.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Business Profile: get a live event

POST/tools/gbp_get_live_event MCP tool gbp_get_live_event Read only

One live event from Business Profile with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Business Profile: live events status

POST/tools/gbp_live_events_status MCP tool gbp_live_events_status Read only

Whether live events (webhooks) from Business Profile are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

List Business Profile accounts

POST/tools/gbp_list_accounts MCP tool gbp_list_accounts Read only

List the Google Business Profile accounts and location groups this connection manages.

Field	Type	About
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

List Business Profile locations

POST/tools/gbp_list_locations MCP tool gbp_list_locations Read only

List the businesses (locations) in a Business Profile account, with address and website.

Field	Type	About
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Get Business Profile location

POST/tools/gbp_get_location MCP tool gbp_get_location Read only

Get one location's profile: categories, hours, phone, website, description, service area.

Field	Type	About
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

List Business Profile reviews

POST/tools/gbp_list_reviews MCP tool gbp_list_reviews Read only

List a location's Google reviews with rating, text and the owner's reply, plus the average rating and total count. Newest first unless order_by says otherwise.

Field	Type	About
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`order_by`	updateTime desc \| rating \| rating desc
`limit`	integer
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Reply to a Business Profile review

POST/tools/gbp_reply_to_review MCP tool gbp_reply_to_review Changes data

Post (or replace) the business owner's public reply to a review. The reply is visible on Google right away, so confirm the text with the user first.

Field	Type	About
`review_id` required	string
`comment` required	string
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Delete a Business Profile review reply

POST/tools/gbp_delete_review_reply MCP tool gbp_delete_review_reply Changes data

Remove the business owner's reply from a review.

Field	Type	About
`review_id` required	string
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Get Business Profile performance

POST/tools/gbp_get_performance MCP tool gbp_get_performance Read only

Daily profile metrics for a location: views on Search and Maps (desktop and mobile), calls, direction requests, website clicks, and optionally messages, bookings and food orders. Returns a total and a per-day list for each metric.

Field	Type	About
`location_id`	string	Location ID. Defaults to the connection's default location.
`metrics`	array of BUSINESS_IMPRESSIONS_DESKTOP_MAPS \| BUSINESS_IMPRESSIONS_DESKTOP_SEARCH \| BUSINESS_IMPRESSIONS_MOBILE_MAPS \| BUSINESS_IMPRESSIONS_MOBILE_SEARCH \| BUSINESS_CONVERSATIONS \| BUSINESS_DIRECTION_REQUESTS \| CALL_CLICKS \| WEBSITE_CLICKS \| BUSINESS_BOOKINGS \| BUSINESS_FOOD_ORDERS \| BUSINESS_FOOD_MENU_CLICKS
`start_date`	string	YYYY-MM-DD. Defaults to 28 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Get Business Profile search keywords

POST/tools/gbp_get_search_keywords MCP tool gbp_get_search_keywords Read only

Search terms people used on Google Search and Maps that showed this business, with monthly impressions (small counts are given as 'below' a threshold). Defaults to the last 90 days.

Field	Type	About
`location_id`	string	Location ID. Defaults to the connection's default location.
`start_date`	string	YYYY-MM-DD. Defaults to 28 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Update Business Profile location

POST/tools/gbp_update_location MCP tool gbp_update_location Changes data

Change a location's details. body holds only the fields to change, e.g. {"regularHours": {"periods": [...]}}, {"specialHours": {...}}, {"profile": {"description": "..."}}, {"phoneNumbers": {"primaryPhone": "..."}}, {"websiteUri": "..."}, {"categories": {...}}. Set validate_only to check a change without saving it.

Field	Type	About
`body` required	object
`location_id`	string	Location ID. Defaults to the connection's default location.
`validate_only`	boolean
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

List Business Profile posts

POST/tools/gbp_list_posts MCP tool gbp_list_posts Read only

List a location's posts (updates, offers, events).

Field	Type	About
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Create Business Profile post

POST/tools/gbp_create_post MCP tool gbp_create_post Changes data

Publish a post on the profile. body is a LocalPost, e.g. {"languageCode": "en", "summary": "...", "topicType": "STANDARD", "callToAction": {"actionType": "LEARN_MORE", "url": "https://..."}}. It goes live right away.

Field	Type	About
`body` required	object
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Update Business Profile post

POST/tools/gbp_update_post MCP tool gbp_update_post Changes data

Change a post. body holds only the fields to change.

Field	Type	About
`post_id` required	string
`body` required	object
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Delete Business Profile post

POST/tools/gbp_delete_post MCP tool gbp_delete_post Changes data

Remove a post from the profile.

Field	Type	About
`post_id` required	string
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

List Business Profile photos

POST/tools/gbp_list_media MCP tool gbp_list_media Read only

List a location's photos and videos.

Field	Type	About
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Add Business Profile photo

POST/tools/gbp_add_photo MCP tool gbp_add_photo Changes data

Add a photo to the profile from a public https image URL.

Field	Type	About
`source_url` required	string
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`category`	COVER \| PROFILE \| LOGO \| EXTERIOR \| INTERIOR \| PRODUCT \| AT_WORK \| FOOD_AND_DRINK \| MENU \| COMMON_AREA \| ROOMS \| TEAMS \| ADDITIONAL
`description`	string
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Delete Business Profile photo

POST/tools/gbp_delete_media MCP tool gbp_delete_media Changes data

Remove a photo or video from the profile.

Field	Type	About
`media_id` required	string
`account_id`	string	Business Profile account ID. Defaults to the connection's.
`location_id`	string	Location ID. Defaults to the connection's default location.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Google Business Profile: setup checks

POST/tools/gbp_setup_checks MCP tool gbp_setup_checks Read only

Whether everything on the Google Business Profile side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Business Profile connection to use. Optional when the client has one, or a default.

Google Merchant Center

22 tools9 change data Tools for a client's Google Merchant Center connections (merchant_...).

Merchant Center: list live events

POST/tools/merchant_list_live_events MCP tool merchant_list_live_events Read only

List events Merchant Center pushed to Metric Sensei by webhook (product_status_change), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use merchant_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. product_status_change.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Merchant Center: get a live event

POST/tools/merchant_get_live_event MCP tool merchant_get_live_event Read only

One live event from Merchant Center with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Merchant Center: live events status

POST/tools/merchant_live_events_status MCP tool merchant_live_events_status Read only

Whether live events (webhooks) from Merchant Center are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

List Merchant Center accounts

POST/tools/merchant_list_accounts MCP tool merchant_list_accounts Read only

List the Google Merchant Center accounts this connection can access.

Field	Type	About
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Get Merchant Center account

POST/tools/merchant_get_account MCP tool merchant_get_account Read only

Get a Merchant Center account's details and account-level issues (suspensions, warnings).

Field	Type	About
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

List Merchant Center products

POST/tools/merchant_list_products MCP tool merchant_list_products Read only

List products with title, price, availability, approval status per destination and issue count. Set only_with_issues to see just products with problems.

Field	Type	About
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`limit`	integer
`only_with_issues`	boolean
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Get Merchant Center product

POST/tools/merchant_get_product MCP tool merchant_get_product Read only

Get one product with every attribute and its full status and issues.

Field	Type	About
`product_id` required	string	e.g. 'en~US~SKU123' (from merchant_list_products).
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Summarise Merchant Center product issues

POST/tools/merchant_list_product_issues MCP tool merchant_list_product_issues Read only

Group product problems (disapprovals, warnings) by issue, with how to fix each, how many products it affects and example product IDs. Checks up to 1,000 products.

Field	Type	About
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Run a Merchant Center report

POST/tools/merchant_run_report MCP tool merchant_run_report Read only

Run a Merchant Center Query Language report. Example: SELECT offer_id, title, clicks, impressions, click_through_rate FROM product_performance_view WHERE date BETWEEN '2026-10-01' AND '2026-10-31' ORDER BY clicks DESC LIMIT 50. Other views include price_competitiveness_product_view, best_sellers_product_cluster_view and product_view.

Field	Type	About
`query` required	string
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`limit`	integer
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

List Merchant Center feeds

POST/tools/merchant_list_data_sources MCP tool merchant_list_data_sources Read only

List the account's product feeds and other data sources (file, API, website crawl).

Field	Type	About
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Merchant Center shopping overview

POST/tools/merchant_shopping_overview MCP tool merchant_shopping_overview Read only

One summary for a date range: clicks, impressions, click-through rate, conversions and conversion value from free listings and from Shopping ads, the busiest products, how many products are showing, limited, pending or not showing on Google today, and the most common product problems.

Field	Type	About
`start_date` required	string	First day, YYYY-MM-DD.
`end_date` required	string	Last day, YYYY-MM-DD.
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`top`	integer
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Add or replace Merchant Center product

POST/tools/merchant_save_product MCP tool merchant_save_product Changes data

Add a product, or replace the product with the same offerId/contentLanguage/feedLabel. product is a ProductInput, e.g. {"offerId": "SKU1", "contentLanguage": "en", "feedLabel": "US", "productAttributes": {"title": "...", "link": "https://...", "imageLink": "https://...", "availability": "IN_STOCK", "price": {"amountMicros": "19990000", "currencyCode": "USD"}}}. data_source_id must be an API data source.

Field	Type	About
`data_source_id` required	string	Data source ID (merchant_list_data_sources shows them).
`product` required	object
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Update Merchant Center product

POST/tools/merchant_update_product MCP tool merchant_update_product Changes data

Change some attributes of a product, e.g. product_attributes {"price": {"amountMicros": "17990000", "currencyCode": "USD"}, "availability": "OUT_OF_STOCK"}.

Field	Type	About
`product_id` required	string	'<language>~<feed label>~<offer id>', e.g. 'en~US~SKU1'.
`data_source_id` required	string	Data source ID (merchant_list_data_sources shows them).
`product_attributes` required	object
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Delete Merchant Center product

POST/tools/merchant_delete_product MCP tool merchant_delete_product Changes data

Delete a product from a data source. Returns a preview unless confirm=true.

Field	Type	About
`product_id` required	string	'<language>~<feed label>~<offer id>', e.g. 'en~US~SKU1'.
`data_source_id` required	string	Data source ID (merchant_list_data_sources shows them).
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Set Merchant Center inventory

POST/tools/merchant_set_inventory MCP tool merchant_set_inventory Changes data

Set a product's stock or price at a store (store_code) or in a region (region). inventory is e.g. {"availability": "IN_STOCK", "quantity": "5", "price": {...}}.

Field	Type	About
`product_id` required	string	'<language>~<feed label>~<offer id>', e.g. 'en~US~SKU1'.
`inventory` required	object
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`store_code`	string	Store code (local inventory).
`region`	string	Region ID (regional inventory).
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Delete Merchant Center inventory

POST/tools/merchant_delete_inventory MCP tool merchant_delete_inventory Changes data

Remove a product's inventory entry for a store (store_code) or a region (region).

Field	Type	About
`product_id` required	string	'<language>~<feed label>~<offer id>', e.g. 'en~US~SKU1'.
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`store_code`	string	Store code (local inventory).
`region`	string	Region ID (regional inventory).
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Create or update Merchant Center data source

POST/tools/merchant_save_data_source MCP tool merchant_save_data_source Changes data

Create a data source (omit data_source_id), or change one. data_source is a DataSource, e.g. {"displayName": "API feed", "primaryProductDataSource": {"contentLanguage": "en", "feedLabel": "US", "countries": ["US"]}}.

Field	Type	About
`data_source` required	object
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`data_source_id`	string	Data source ID (merchant_list_data_sources shows them).
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Delete Merchant Center data source

POST/tools/merchant_delete_data_source MCP tool merchant_delete_data_source Changes data

Delete a data source and every product it supplies. Returns a preview unless confirm=true.

Field	Type	About
`data_source_id` required	string	Data source ID (merchant_list_data_sources shows them).
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Fetch Merchant Center data source now

POST/tools/merchant_fetch_data_source MCP tool merchant_fetch_data_source Changes data

Fetch a scheduled file data source now instead of waiting for its schedule.

Field	Type	About
`data_source_id` required	string	Data source ID (merchant_list_data_sources shows them).
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

List Merchant Center promotions

POST/tools/merchant_list_promotions MCP tool merchant_list_promotions Read only

List an account's promotions.

Field	Type	About
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Add or replace Merchant Center promotion

POST/tools/merchant_save_promotion MCP tool merchant_save_promotion Changes data

Add a promotion, or replace the one with the same promotionId. promotion is a Merchant API Promotion (promotionId, contentLanguage, targetCountry, redemptionChannel, attributes); data_source_id is the promotions data source.

Field	Type	About
`data_source_id` required	string	Data source ID (merchant_list_data_sources shows them).
`promotion` required	object
`account_id`	string	Merchant Center ID. Defaults to the connection's account.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Google Merchant Center: setup checks

POST/tools/merchant_setup_checks MCP tool merchant_setup_checks Read only

Whether everything on the Google Merchant Center side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Merchant Center connection to use. Optional when the client has one, or a default.

Google Ads

28 tools11 change data Tools for a client's Google Ads connections (ads_...).

Google Ads: list live events

POST/tools/ads_list_live_events MCP tool ads_list_live_events Read only

List events Google Ads pushed to Metric Sensei by webhook (lead_form), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use ads_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. lead_form.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads: get a live event

POST/tools/ads_get_live_event MCP tool ads_get_live_event Read only

One live event from Google Ads with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads: live events status

POST/tools/ads_live_events_status MCP tool ads_live_events_status Read only

Whether live events (webhooks) from Google Ads are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

List Google Ads accounts

POST/tools/ads_list_accounts MCP tool ads_list_accounts Read only

List the IDs of Google Ads accounts the signed-in user can open directly.

Field	Type	About
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

List Google Ads client accounts

POST/tools/ads_list_client_accounts MCP tool ads_list_client_accounts Read only

List an account and, for a manager account, the accounts under it with names and currency.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads campaign performance

POST/tools/ads_campaign_performance MCP tool ads_campaign_performance Read only

Per-campaign spend, impressions, clicks, CTR, average CPC, conversions and conversion value, with status and daily budget. Defaults to the last 30 days, highest spend first. Money is shown both in micros and as a plain amount in the account's currency.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads ad group performance

POST/tools/ads_ad_group_performance MCP tool ads_ad_group_performance Read only

Per-ad-group spend, clicks, impressions and conversions, optionally for one campaign.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`campaign_id`	string	Only this campaign.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads keyword performance

POST/tools/ads_keyword_performance MCP tool ads_keyword_performance Read only

Per-keyword match type, quality score, spend, clicks and conversions.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`campaign_id`	string	Only this campaign.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads search terms

POST/tools/ads_search_terms MCP tool ads_search_terms Read only

The searches people actually typed that showed the ads, with clicks, cost and conversions.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`campaign_id`	string	Only this campaign.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to yesterday.
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Look up a Google Ads click

POST/tools/ads_click_lookup MCP tool ads_click_lookup Read only

The campaign, ad group, keyword and ad behind one gclid, from Google's click view. Needs the click's date (YYYY-MM-DD); Google keeps click details for 90 days. Attribution blocks on orders, calls and leads give the gclid and the click time.

Field	Type	About
`gclid` required	string	The Google click ID.
`date` required	string	The click's date, YYYY-MM-DD.
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Run a Google Ads query

POST/tools/ads_run_query MCP tool ads_run_query Read only

Run any Google Ads Query Language (GAQL) SELECT on an account, e.g. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS. Use ads_list_fields to find field names.

Field	Type	About
`query` required	string
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

List Google Ads query fields

POST/tools/ads_list_fields MCP tool ads_list_fields Read only

Find GAQL fields by name prefix (e.g. 'metrics.conv' or 'campaign.'), with type and usage.

Field	Type	About
`prefix` required	string
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Pause or enable a Google Ads campaign

POST/tools/ads_set_campaign_status MCP tool ads_set_campaign_status Changes data

Pause or enable a campaign. Pausing happens right away; enabling returns a dry-run preview unless confirm=true.

Field	Type	About
`campaign_id` required	string
`status` required	ENABLED \| PAUSED
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Pause or enable a Google Ads ad group

POST/tools/ads_set_ad_group_status MCP tool ads_set_ad_group_status Changes data

Pause or enable an ad group. Enabling returns a dry-run preview unless confirm=true.

Field	Type	About
`ad_group_id` required	string
`status` required	ENABLED \| PAUSED
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Change a Google Ads campaign budget

POST/tools/ads_set_campaign_budget MCP tool ads_set_campaign_budget Changes data

Set a campaign's average daily budget, in the account's currency (e.g. 50 for $50/day). Lowering happens right away; raising returns a dry-run preview unless confirm=true. Shared budgets need allow_shared=true.

Field	Type	About
`campaign_id` required	string
`daily_amount` required	number
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`allow_shared`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Create Google Ads campaign

POST/tools/ads_create_campaign MCP tool ads_create_campaign Changes data

Create a Search campaign with its own daily budget (account currency). It starts paused; add ad groups, keywords and ads, then enable it. Bidding: MAXIMIZE_CLICKS (default), MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, MANUAL_CPC. Other campaign types: use ads_mutate.

Field	Type	About
`name` required	string
`daily_amount` required	number
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`bidding`	MAXIMIZE_CLICKS \| MAXIMIZE_CONVERSIONS \| MAXIMIZE_CONVERSION_VALUE \| MANUAL_CPC
`search_partners`	boolean
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`enable`	boolean	Create it enabled (needs confirm). Default: paused.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Create Google Ads ad group

POST/tools/ads_create_ad_group MCP tool ads_create_ad_group Changes data

Create an ad group in a campaign (paused unless enable=true with confirm). cpc_bid is the default max CPC in the account currency (manual CPC campaigns).

Field	Type	About
`campaign_id` required	string
`name` required	string
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`cpc_bid`	number
`enable`	boolean	Create it enabled (needs confirm). Default: paused.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Create Google Ads responsive search ad

POST/tools/ads_create_search_ad MCP tool ads_create_search_ad Changes data

Create a responsive search ad: 3-15 headlines (max 30 chars), 2-4 descriptions (max 90), a final URL and optional display paths. Paused unless enable=true with confirm.

Field	Type	About
`ad_group_id` required	string
`headlines` required	array of string
`descriptions` required	array of string
`final_url` required	string
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`path1`	string
`path2`	string
`enable`	boolean	Create it enabled (needs confirm). Default: paused.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Add Google Ads keywords

POST/tools/ads_add_keywords MCP tool ads_add_keywords Changes data

Add keywords to an ad group, e.g. [{"text": "red shoes", "match_type": "PHRASE"}]. Paused unless enable=true with confirm.

Field	Type	About
`ad_group_id` required	string
`keywords` required	array of object
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`cpc_bid`	number
`enable`	boolean	Create it enabled (needs confirm). Default: paused.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Add Google Ads negative keywords

POST/tools/ads_add_negative_keywords MCP tool ads_add_negative_keywords Changes data

Stop ads showing for searches with these words, on a campaign or an ad group.

Field	Type	About
`keywords` required	array of object
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`campaign_id`	string
`ad_group_id`	string
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Remove Google Ads item

POST/tools/ads_remove MCP tool ads_remove Changes data

Remove a campaign, ad group, ad (ad_group_ad, id '<ad group id>~<ad id>'), keyword (ad_group_criterion, '<ad group id>~<criterion id>'), campaign criterion, budget or asset group. Removed items can't be re-enabled. Returns a dry-run preview unless confirm=true.

Field	Type	About
`resource_type` required	campaign \| ad_group \| ad_group_ad \| ad_group_criterion \| campaign_criterion \| campaign_budget \| asset_group
`resource_id` required	string
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Make any Google Ads change

POST/tools/ads_mutate MCP tool ads_mutate Changes data

Apply raw Google Ads API mutate operations to one collection, for anything the other tools don't cover (bids, locations, schedules, assets, bidding strategies, conversion actions...). E.g. collection "adGroupCriteria", operations [{"update": {"resourceName": "customers/1/adGroupCriteria/2~3", "cpcBidMicros": "1500000"}, "updateMask": "cpc_bid_micros"}]. Returns a dry-run preview unless confirm=true.

Field	Type	About
`collection` required	string
`operations` required	array of object
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Local Services leads

POST/tools/ads_lsa_leads MCP tool ads_lsa_leads Read only

Local Services Ads leads (phone calls, messages, bookings from the Google Guaranteed/Screened ad), newest first: type, status, job category, when, whether Google charged for it or credited it, and the person's name, phone and email. Defaults to the last 30 days.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to today.
`lead_type`	PHONE_CALL \| MESSAGE \| BOOKING
`status`	NEW \| ACTIVE \| BOOKED \| DECLINED \| EXPIRED \| DISABLED \| CONSUMER_DECLINED \| WIPED_OUT
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Local Services lead

POST/tools/ads_lsa_get_lead MCP tool ads_lsa_get_lead Read only

One Local Services lead with every call (length, recording link) and message on it.

Field	Type	About
`lead_id` required	string
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Local Services calls and messages

POST/tools/ads_lsa_conversations MCP tool ads_lsa_conversations Read only

Calls (length in seconds, recording link) and messages on Local Services leads, newest first, for a date range or one lead_id.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to today.
`lead_id`	string
`limit`	integer
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Local Services summary

POST/tools/ads_lsa_summary MCP tool ads_lsa_summary Read only

Local Services Ads totals for a date range: spend, impressions, leads by type (calls, messages, bookings), charged and credited leads and cost per charged lead, also per day and per job category. Defaults to the last 30 days.

Field	Type	About
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD. Defaults to 30 days before end_date.
`end_date`	string	YYYY-MM-DD. Defaults to today.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Rate a Google Local Services lead

POST/tools/ads_lsa_lead_feedback MCP tool ads_lsa_lead_feedback Changes data

Rate a Local Services lead (once per lead; it can't be changed). SATISFIED/VERY_SATISFIED need a reason from BOOKED_CUSTOMER, LIKELY_BOOKED_CUSTOMER, SERVICE_RELATED, HIGH_VALUE_SERVICE, OTHER_SATISFIED_REASON; DISSATISFIED/VERY_DISSATISFIED one from GEO_MISMATCH, JOB_TYPE_MISMATCH, NOT_READY_TO_BOOK, SPAM, DUPLICATE, SOLICITATION, OTHER_DISSATISFIED_REASON (a bad lead may be credited). OTHER_ reasons need a comment. Returns a preview unless confirm=true.

Field	Type	About
`lead_id` required	string
`rating` required	VERY_SATISFIED \| SATISFIED \| NEUTRAL \| DISSATISFIED \| VERY_DISSATISFIED
`customer_id`	string	Ads account ID, e.g. 123-456-7890. Defaults to the connection's.
`reason`	BOOKED_CUSTOMER \| LIKELY_BOOKED_CUSTOMER \| SERVICE_RELATED \| HIGH_VALUE_SERVICE \| OTHER_SATISFIED_REASON \| GEO_MISMATCH \| JOB_TYPE_MISMATCH \| NOT_READY_TO_BOOK \| SPAM \| DUPLICATE \| SOLICITATION \| OTHER_DISSATISFIED_REASON
`comment`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google Ads: setup checks

POST/tools/ads_setup_checks MCP tool ads_setup_checks Read only

Whether everything on the Google Ads side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Ads connection to use. Optional when the client has one, or a default.

Google PageSpeed Insights

3 tools Tools for a client's Google PageSpeed Insights connections (pagespeed_...).

Run a PageSpeed test

POST/tools/pagespeed_run_test MCP tool pagespeed_run_test Read only

Run Google Lighthouse on a public page and return 0-100 scores, lab metrics (LCP, TBT, CLS, FCP, Speed Index), the biggest improvement opportunities, and real-user field data when Chrome has enough traffic for it. A test takes 10-25 seconds.

Field	Type	About
`url` required	string	Full public URL, e.g. https://www.example.com/pricing
`strategy`	mobile \| desktop \| both
`categories`	array of performance \| accessibility \| best-practices \| seo	Lighthouse categories to score. Defaults to performance.
`connection`	string	Which Google PageSpeed Insights connection to use. Optional when the client has one, or a default.

Get real-user Core Web Vitals

POST/tools/pagespeed_get_field_data MCP tool pagespeed_get_field_data Read only

Real-user Core Web Vitals from the Chrome UX Report (75th percentile over the last 28 days) for a page, or for the whole site with whole_site=true. Fast; no test is run.

Field	Type	About
`url` required	string	Full public URL, e.g. https://www.example.com/pricing
`whole_site`	boolean	Report on the URL's origin instead.
`form_factor`	PHONE \| DESKTOP \| TABLET
`connection`	string	Which Google PageSpeed Insights connection to use. Optional when the client has one, or a default.

Google PageSpeed Insights: setup checks

POST/tools/pagespeed_setup_checks MCP tool pagespeed_setup_checks Read only

Whether everything on the Google PageSpeed Insights side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google PageSpeed Insights connection to use. Optional when the client has one, or a default.

Shopify

28 tools15 change data Tools for a client's Shopify connections (shopify_...).

Shopify: list live events

POST/tools/shopify_list_live_events MCP tool shopify_list_live_events Read only

List events Shopify pushed to Metric Sensei by webhook (orders/create, orders/updated, refunds/create, customers/create, checkouts/create), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use shopify_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. orders/create.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Shopify: get a live event

POST/tools/shopify_get_live_event MCP tool shopify_get_live_event Read only

One live event from Shopify with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Shopify: live events status

POST/tools/shopify_live_events_status MCP tool shopify_live_events_status Read only

Whether live events (webhooks) from Shopify are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Get Shopify store

POST/tools/shopify_get_shop MCP tool shopify_get_shop Read only

Store name, domains, currency, plan and time zone.

Field	Type	About
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

List Shopify products

POST/tools/shopify_list_products MCP tool shopify_list_products Read only

List products, newest-updated first. Filter with Shopify search syntax in 'query'.

Field	Type	About
`query`	string	Shopify search syntax, e.g. "status:active vendor:Acme".
`first`	integer
`after`	string	page_info.endCursor from the previous page.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Get Shopify product

POST/tools/shopify_get_product MCP tool shopify_get_product Read only

A product with up to 100 variants.

Field	Type	About
`product_id` required	string	Numeric ID or gid://shopify/Product/<id>
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

List Shopify orders

POST/tools/shopify_list_orders MCP tool shopify_list_orders Read only

List orders, newest first. Without read_all_orders, only the last 60 days are visible. Filter e.g. "financial_status:paid created_at:>2026-01-01".

Field	Type	About
`query`	string	Shopify search syntax, e.g. "status:active vendor:Acme".
`first`	integer
`after`	string	page_info.endCursor from the previous page.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Shopify sales summary

POST/tools/shopify_sales_summary MCP tool shopify_sales_summary Read only

Orders and sales per day for a date range, with totals (orders, sales, average order value) in the store's currency. Cancelled and test orders are left out. Good for dashboard tiles.

Field	Type	About
`start_date`	string	YYYY-MM-DD (default: 29 days before end_date)
`end_date`	string	YYYY-MM-DD (default: today)
`financial_status`	paid \| pending \| refunded \| partially_refunded \| authorized	Only orders with this payment status (default: all).
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Get Shopify order

POST/tools/shopify_get_order MCP tool shopify_get_order Read only

An order with totals and line items.

Field	Type	About
`order_id` required	string	Numeric ID or gid://shopify/Order/<id>
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

List Shopify customers

POST/tools/shopify_list_customers MCP tool shopify_list_customers Read only

List customers with order counts and amount spent.

Field	Type	About
`query`	string	Shopify search syntax, e.g. "status:active vendor:Acme".
`first`	integer
`after`	string	page_info.endCursor from the previous page.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Run Shopify GraphQL query

POST/tools/shopify_graphql MCP tool shopify_graphql Read only

Run any read-only Admin GraphQL query (mutations are refused). Returns data, errors and query cost.

Field	Type	About
`query` required	string	GraphQL document for the Shopify Admin API.
`variables`	object
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Run Shopify GraphQL mutation

POST/tools/shopify_graphql_mutation MCP tool shopify_graphql_mutation Changes data

Run any Admin GraphQL mutation (changes the store), for what the other tools don't cover. Returns a preview unless confirm=true.

Field	Type	About
`query` required	string	GraphQL document for the Shopify Admin API.
`variables`	object
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Create or update Shopify product

POST/tools/shopify_save_product MCP tool shopify_save_product Changes data

Create a product (omit product_id) or update one. product holds ProductCreateInput/ProductUpdateInput fields, e.g. {"title": "Tee", "descriptionHtml": "<p>..</p>", "vendor": "Acme", "tags": ["summer"], "status": "DRAFT"}. Change prices with shopify_update_variants.

Field	Type	About
`product` required	object
`product_id`	string	Numeric ID or gid://shopify/... ID.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Delete Shopify product

POST/tools/shopify_delete_product MCP tool shopify_delete_product Changes data

Delete a product and its variants. Returns a preview unless confirm=true.

Field	Type	About
`product_id` required	string	Numeric ID or gid://shopify/... ID.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Update Shopify variants

POST/tools/shopify_update_variants MCP tool shopify_update_variants Changes data

Change variants of a product, e.g. variants [{"id": "123", "price": "19.99", "compareAtPrice": "24.99"}].

Field	Type	About
`product_id` required	string	Numeric ID or gid://shopify/... ID.
`variants` required	array of object
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

List Shopify locations

POST/tools/shopify_list_locations MCP tool shopify_list_locations Read only

List the store's locations (warehouses, shops), needed for inventory changes.

Field	Type	About
`query`	string	Shopify search syntax, e.g. "status:active vendor:Acme".
`first`	integer
`after`	string	page_info.endCursor from the previous page.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Set Shopify inventory

POST/tools/shopify_set_inventory MCP tool shopify_set_inventory Changes data

Set available stock to exact numbers, e.g. quantities [{"inventory_item_id": "1", "location_id": "2", "quantity": 10}]. The inventory item ID is on each variant (inventoryItem { id }).

Field	Type	About
`quantities` required	array of object
`reason`	string	e.g. correction (default), received, restock.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Create or update Shopify collection

POST/tools/shopify_save_collection MCP tool shopify_save_collection Changes data

Create a collection (omit collection_id) or update one with CollectionInput fields, and/or add products to it with add_product_ids.

Field	Type	About
`collection_id`	string	Numeric ID or gid://shopify/... ID.
`collection`	object
`add_product_ids`	array of string
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Create or update Shopify customer

POST/tools/shopify_save_customer MCP tool shopify_save_customer Changes data

Create a customer (omit customer_id) or update one. customer is CustomerInput, e.g. {"email": "...", "firstName": "...", "tags": ["vip"]}.

Field	Type	About
`customer` required	object
`customer_id`	string	Numeric ID or gid://shopify/... ID.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Delete Shopify customer

POST/tools/shopify_delete_customer MCP tool shopify_delete_customer Changes data

Delete a customer without orders. Returns a preview unless confirm=true.

Field	Type	About
`customer_id` required	string	Numeric ID or gid://shopify/... ID.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Create Shopify discount code

POST/tools/shopify_create_discount_code MCP tool shopify_create_discount_code Changes data

Create a basic discount code. discount is DiscountCodeBasicInput, e.g. {"title": "10% off", "code": "SAVE10", "startsAt": "2026-11-10T00:00:00Z", "customerSelection": {"all": true}, "customerGets": {"value": {"percentage": 0.1}, "items": {"all": true}}}.

Field	Type	About
`discount` required	object
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Activate, deactivate or delete Shopify discount

POST/tools/shopify_set_discount MCP tool shopify_set_discount Changes data

Turn a code discount on or off, or delete it.

Field	Type	About
`discount_id` required	string	Numeric ID or gid://shopify/... ID.
`action` required	activate \| deactivate \| delete
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Set Shopify metafields

POST/tools/shopify_set_metafields MCP tool shopify_set_metafields Changes data

Set up to 25 metafields, e.g. [{"ownerId": "gid://shopify/Product/1", "namespace": "custom", "key": "care", "type": "single_line_text_field", "value": "Hand wash"}].

Field	Type	About
`metafields` required	array of object
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Update Shopify order

POST/tools/shopify_update_order MCP tool shopify_update_order Changes data

Change an order's note, tags, email or shipping address.

Field	Type	About
`order_id` required	string	Numeric ID or gid://shopify/... ID.
`note`	string
`tags`	array of string
`email`	string
`shipping_address`	object
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Fulfil Shopify order

POST/tools/shopify_fulfill_order MCP tool shopify_fulfill_order Changes data

Mark an order's open items as fulfilled, with optional tracking. Notifies the customer unless notify_customer=false.

Field	Type	About
`order_id` required	string	Numeric ID or gid://shopify/... ID.
`tracking_number`	string
`tracking_url`	string
`carrier`	string
`notify_customer`	boolean
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Cancel Shopify order

POST/tools/shopify_cancel_order MCP tool shopify_cancel_order Changes data

Cancel an order; refund=true also refunds the original payment, restock (default true) puts items back. Returns a preview unless confirm=true.

Field	Type	About
`order_id` required	string	Numeric ID or gid://shopify/... ID.
`reason`	CUSTOMER \| DECLINED \| FRAUD \| INVENTORY \| STAFF \| OTHER
`refund`	boolean
`restock`	boolean
`notify_customer`	boolean
`staff_note`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Refund Shopify order

POST/tools/shopify_refund_order MCP tool shopify_refund_order Changes data

Refund money on an order. refund is RefundInput without orderId, e.g. {"refundLineItems": [{"lineItemId": "gid://shopify/LineItem/1", "quantity": 1, "restockType": "RETURN"}], "transactions": [...], "notify": true}. Returns a preview unless confirm=true.

Field	Type	About
`order_id` required	string	Numeric ID or gid://shopify/... ID.
`refund` required	object
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Shopify: setup checks

POST/tools/shopify_setup_checks MCP tool shopify_setup_checks Read only

Whether everything on the Shopify side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Shopify connection to use. Optional when the client has one, or a default.

Meta Ads

20 tools7 change data Tools for a client's Meta Ads connections (meta_ads_...).

List Meta ad accounts

POST/tools/meta_ads_list_ad_accounts MCP tool meta_ads_list_ad_accounts Read only

Ad accounts this connection can use, with currency, time zone, status, total spend and owning business.

Field	Type	About
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Get Meta ad account

POST/tools/meta_ads_get_ad_account MCP tool meta_ads_get_ad_account Read only

One ad account: status, disable reason, currency, time zone, spend, spend cap, balance.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

List Meta campaigns

POST/tools/meta_ads_list_campaigns MCP tool meta_ads_list_campaigns Read only

Campaigns in an ad account with objective, status, budgets and bid strategy. Every call names the account it works in; IDs of campaigns, posts, media or comments are checked to belong to it.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`statuses`	array of string	effective_status values to keep, e.g. ACTIVE, PAUSED, ARCHIVED, WITH_ISSUES.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

List Meta ad sets

POST/tools/meta_ads_list_ad_sets MCP tool meta_ads_list_ad_sets Read only

Ad sets in an ad account, or in one campaign, with budget, bid, optimization goal and targeting.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`campaign_id`	string
`statuses`	array of string	effective_status values to keep, e.g. ACTIVE, PAUSED, ARCHIVED, WITH_ISSUES.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

List Meta ads

POST/tools/meta_ads_list_ads MCP tool meta_ads_list_ads Read only

Ads in an ad account, or in one campaign or ad set, with status and creative.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`campaign_id`	string
`adset_id`	string
`statuses`	array of string	effective_status values to keep, e.g. ACTIVE, PAUSED, ARCHIVED, WITH_ISSUES.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

List Meta ad creatives

POST/tools/meta_ads_list_creatives MCP tool meta_ads_list_creatives Read only

Ad creatives in an ad account (text, link, image, call to action).

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Get Meta campaign, ad set, ad or creative

POST/tools/meta_ads_get MCP tool meta_ads_get Read only

One campaign, ad set, ad or creative with all its settings.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`object_type` required	campaign \| adset \| ad \| adcreative
`object_id` required	string
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Meta Ads performance report

POST/tools/meta_ads_get_insights MCP tool meta_ads_get_insights Read only

Performance (spend, impressions, reach, clicks, CTR, CPC, CPM, actions/conversions, values, ROAS) for an ad account, or one campaign/ad set/ad, at account, campaign, adset or ad level. Dates: date_preset (default last_28d) or start_date + end_date. time_increment 1 gives daily rows. breakdowns e.g. age, gender, country, publisher_platform, platform_position, device_platform. Money values are in the account currency (not cents).

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`level`	account \| campaign \| adset \| ad
`object_type`	campaign \| adset \| ad
`object_id`	string
`fields`	array of string
`date_preset`	today \| yesterday \| this_month \| last_month \| this_quarter \| maximum \| last_3d \| last_7d \| last_14d \| last_28d \| last_30d \| last_90d \| last_week_mon_sun \| last_week_sun_sat \| last_quarter \| last_year \| this_week_mon_today \| this_week_sun_today \| this_year
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`time_increment`	1 \| 7 \| monthly \| all_days
`breakdowns`	array of string
`action_breakdowns`	array of string
`limit`	integer
`after`	string
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Meta Ads landing pages

POST/tools/meta_ads_landing_pages MCP tool meta_ads_landing_pages Read only

The website pages an ad account's ads send people to, with ads, link clicks, spend and conversions (leads, purchases, sign-ups ...) per page. date_preset defaults to last_30d.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`date_preset`	today \| yesterday \| this_month \| last_month \| this_quarter \| maximum \| last_3d \| last_7d \| last_14d \| last_28d \| last_30d \| last_90d \| last_week_mon_sun \| last_week_sun_sat \| last_quarter \| last_year \| this_week_mon_today \| this_week_sun_today \| this_year
`limit`	integer
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

List Meta audiences

POST/tools/meta_ads_list_audiences MCP tool meta_ads_list_audiences Read only

Custom and lookalike audiences in an ad account, with size and delivery status.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

List Meta pixels

POST/tools/meta_ads_list_pixels MCP tool meta_ads_list_pixels Read only

Meta pixels (datasets) the ad account can use, and when each last received an event.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Search Meta targeting options

POST/tools/meta_ads_search_targeting MCP tool meta_ads_search_targeting Read only

Find interests (adinterest), places (adgeolocation), languages (adlocale), schools, employers or job titles to use in an ad set's targeting.

Field	Type	About
`q` required	string
`type`	adinterest \| adgeolocation \| adlocale \| adeducationschool \| adworkemployer \| adworkposition
`limit`	integer
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Create Meta campaign

POST/tools/meta_ads_create_campaign MCP tool meta_ads_create_campaign Changes data

Create a campaign. It is always created PAUSED, so nothing spends until it is turned on with meta_ads_update. Budgets are in the currency's minor unit (cents).

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`name` required	string
`objective` required	string	OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OUTCOME_AWARENESS or OUTCOME_APP_PROMOTION
`special_ad_categories`	array of string	[] or e.g. HOUSING, EMPLOYMENT, CREDIT, ISSUES_ELECTIONS_POLITICS
`bid_strategy`	string
`daily_budget`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`lifetime_budget`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`is_adset_budget_sharing_enabled`	boolean
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Create Meta ad set

POST/tools/meta_ads_create_ad_set MCP tool meta_ads_create_ad_set Changes data

Create an ad set in a campaign (always PAUSED) with targeting, optimization goal, budget and schedule. Use meta_ads_search_targeting to find interest and location IDs.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`campaign_id` required	string
`name` required	string
`optimization_goal` required	string
`targeting` required	object
`billing_event`	string
`bid_strategy`	string
`bid_amount`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`daily_budget`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`lifetime_budget`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`promoted_object`	object	e.g. {"pixel_id": "...", "custom_event_type": "PURCHASE"}
`start_time`	string	ISO 8601
`end_time`	string	ISO 8601
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Create Meta ad creative

POST/tools/meta_ads_create_creative MCP tool meta_ads_create_creative Changes data

Create an ad creative. object_story_spec example: {"page_id": "...", "link_data": {"link": "https://...", "message": "...", "name": "headline", "picture": "https://.../img.jpg", "call_to_action": {"type": "SHOP_NOW"}}}. Or promote an existing Page post with object_story_id (<page_id>_<post_id>).

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`name` required	string
`object_story_spec`	object
`object_story_id`	string
`degrees_of_freedom_spec`	object
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Create Meta ad

POST/tools/meta_ads_create_ad MCP tool meta_ads_create_ad Changes data

Create an ad in an ad set from a creative. It is always created PAUSED.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`adset_id` required	string
`creative_id` required	string
`name` required	string
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Update Meta campaign, ad set or ad

POST/tools/meta_ads_update MCP tool meta_ads_update Changes data

Rename, pause, archive or turn on (ACTIVE) a campaign, ad set or ad, or change its daily/lifetime budget, bid_amount or end time. Turning on or changing money returns a preview first; call again with confirm=true after the user agrees.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`object_type` required	campaign \| adset \| ad
`object_id` required	string
`name`	string
`status`	ACTIVE \| PAUSED \| ARCHIVED
`daily_budget`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`lifetime_budget`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`bid_amount`	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`end_time`	string	ISO 8601
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Set Meta ad account spend cap

POST/tools/meta_ads_set_spend_cap MCP tool meta_ads_set_spend_cap Changes data

Set an ad account's spend cap (minor unit; 0 removes it). Returns a preview first; call again with confirm=true.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`spend_cap` required	integer	In the account currency's minor unit, e.g. cents (5000 = 50.00).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Delete Meta campaign, ad set, ad or creative

POST/tools/meta_ads_delete MCP tool meta_ads_delete Changes data

Delete a campaign, ad set, ad or creative. This can't be undone (pausing or archiving can). Returns a preview first; call again with confirm=true.

Field	Type	About
`ad_account_id` required	string	Ad account ID (act_123 or 123). See meta_ads_list_ad_accounts.
`object_type` required	campaign \| adset \| ad \| adcreative
`object_id` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Meta Ads: setup checks

POST/tools/meta_ads_setup_checks MCP tool meta_ads_setup_checks Read only

Whether everything on the Meta Ads side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Meta Ads connection to use. Optional when the client has one, or a default.

Facebook Pages

19 tools7 change data Tools for a client's Facebook Pages connections (facebook_...).

Facebook Pages: list live events

POST/tools/facebook_list_live_events MCP tool facebook_list_live_events Read only

List events Facebook Pages pushed to Metric Sensei by webhook (leadgen, feed, ratings), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use facebook_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. leadgen.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Facebook Pages: get a live event

POST/tools/facebook_get_live_event MCP tool facebook_get_live_event Read only

One live event from Facebook Pages with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Facebook Pages: live events status

POST/tools/facebook_live_events_status MCP tool facebook_live_events_status Read only

Whether live events (webhooks) from Facebook Pages are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

List Facebook Pages

POST/tools/facebook_list_pages MCP tool facebook_list_pages Read only

Facebook Pages this connection manages, with category, followers, owning business and linked Instagram account.

Field	Type	About
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Get Facebook Page

POST/tools/facebook_get_page MCP tool facebook_get_page Read only

One Page's details: about, description, website, phone, emails, hours, followers.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Facebook Page insights

POST/tools/facebook_get_page_insights MCP tool facebook_get_page_insights Read only

Page metrics by day, week or 28 days, e.g. page_post_engagements, page_views_total, page_follows, page_media_view, page_total_actions. Dates are at most 90 days apart.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`metrics`	array of string
`period`	day \| week \| days_28 \| total_over_range
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

List Facebook posts

POST/tools/facebook_list_posts MCP tool facebook_list_posts Read only

A Page's published posts, newest first, with reaction, comment and share counts.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

List scheduled Facebook posts

POST/tools/facebook_list_scheduled_posts MCP tool facebook_list_scheduled_posts Read only

A Page's posts scheduled for later.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Get Facebook post

POST/tools/facebook_get_post MCP tool facebook_get_post Read only

One post with its text, link, picture and counts.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`post_id` required	string	Post ID (<page_id>_<post_id>).
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Facebook post insights

POST/tools/facebook_get_post_insights MCP tool facebook_get_post_insights Read only

One post's metrics, e.g. post_clicks, post_reactions_by_type_total, post_media_view.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`post_id` required	string	Post ID (<page_id>_<post_id>).
`metrics`	array of string
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

List Facebook comments

POST/tools/facebook_list_comments MCP tool facebook_list_comments Read only

Comments on a post, or replies to one comment (comment_id), with hidden state.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`post_id`	string	Post ID (<page_id>_<post_id>).
`comment_id`	string
`newest_first`	boolean
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Publish Facebook post

POST/tools/facebook_create_post MCP tool facebook_create_post Changes data

Publish a post on a Page now, or schedule it (scheduled_time, 10 minutes to 30 days ahead): text, a link, a photo (image_url) or a video (video_url). Returns a preview first; call again with confirm=true after the user agrees.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`message`	string
`link`	string
`image_url`	string	Public https URL of the photo.
`video_url`	string	Public https URL of the video.
`scheduled_time`	string	ISO 8601 with offset, or Unix seconds.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Edit Facebook post

POST/tools/facebook_update_post MCP tool facebook_update_post Changes data

Change a post's text. Returns a preview first; call again with confirm=true.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`post_id` required	string	Post ID (<page_id>_<post_id>).
`message` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Delete Facebook post

POST/tools/facebook_delete_post MCP tool facebook_delete_post Changes data

Delete a post. This can't be undone. Returns a preview first; call again with confirm=true.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`post_id` required	string	Post ID (<page_id>_<post_id>).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Reply to Facebook comment

POST/tools/facebook_reply_to_comment MCP tool facebook_reply_to_comment Changes data

Reply to a comment as the Page (comment_id), or comment on one of its posts (post_id).

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`message` required	string
`comment_id`	string
`post_id`	string	Post ID (<page_id>_<post_id>).
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Hide or unhide Facebook comment

POST/tools/facebook_hide_comment MCP tool facebook_hide_comment Changes data

Hide a comment on the Page (hidden=true) or show it again (hidden=false).

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`comment_id` required	string
`hidden`	boolean
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Delete Facebook comment

POST/tools/facebook_delete_comment MCP tool facebook_delete_comment Changes data

Delete a comment on the Page. This can't be undone (hiding can). Returns a preview first; call again with confirm=true.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`comment_id` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Update Facebook Page details

POST/tools/facebook_update_page MCP tool facebook_update_page Changes data

Change a Page's about text, description, website, phone, general info or emails.

Field	Type	About
`page_id` required	string	Facebook Page ID. See facebook_list_pages.
`about`	string
`description`	string
`website`	string
`phone`	string
`general_info`	string
`emails`	array of string
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Facebook Pages: setup checks

POST/tools/facebook_setup_checks MCP tool facebook_setup_checks Read only

Whether everything on the Facebook Pages side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Facebook Pages connection to use. Optional when the client has one, or a default.

Instagram

20 tools6 change data Tools for a client's Instagram connections (instagram_...).

Instagram: list live events

POST/tools/instagram_list_live_events MCP tool instagram_list_live_events Read only

List events Instagram pushed to Metric Sensei by webhook (comments, mentions), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use instagram_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. comments.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Instagram: get a live event

POST/tools/instagram_get_live_event MCP tool instagram_get_live_event Read only

One live event from Instagram with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Instagram: live events status

POST/tools/instagram_live_events_status MCP tool instagram_live_events_status Read only

Whether live events (webhooks) from Instagram are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

List Instagram accounts

POST/tools/instagram_list_accounts MCP tool instagram_list_accounts Read only

Instagram business/creator accounts this connection can use, with the Facebook Page each is linked to.

Field	Type	About
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Get Instagram account

POST/tools/instagram_get_account MCP tool instagram_get_account Read only

Profile: username, name, bio, website, followers, following and media count.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Instagram account insights

POST/tools/instagram_get_account_insights MCP tool instagram_get_account_insights Read only

Account metrics, e.g. reach, views, accounts_engaged, total_interactions, likes, comments, shares, saves, follows_and_unfollows, profile_links_taps (metric_type total_value or time_series), or follower demographics (metrics follower_demographics, period lifetime, timeframe this_month, breakdown age, gender, city or country). At most 30 days per call.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`metrics`	array of string
`period`	day \| lifetime
`metric_type`	total_value \| time_series
`breakdown`	array of string
`timeframe`	string
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

List Instagram posts

POST/tools/instagram_list_media MCP tool instagram_list_media Read only

The account's posts, reels and carousels, newest first, with likes and comments.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

List Instagram stories

POST/tools/instagram_list_stories MCP tool instagram_list_stories Read only

The account's current stories (last 24 hours).

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Get Instagram post

POST/tools/instagram_get_media MCP tool instagram_get_media Read only

One post, reel or story with caption, link, counts and carousel items.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`media_id` required	string	Media ID (from instagram_list_media).
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Instagram post insights

POST/tools/instagram_get_media_insights MCP tool instagram_get_media_insights Read only

One post's or reel's metrics, e.g. views, reach, likes, comments, shares, saved, total_interactions, ig_reels_avg_watch_time.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`media_id` required	string	Media ID (from instagram_list_media).
`metrics`	array of string
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

List Instagram comments

POST/tools/instagram_list_comments MCP tool instagram_list_comments Read only

Comments on a post (media_id), or replies to one comment (comment_id).

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`media_id`	string	Media ID (from instagram_list_media).
`comment_id`	string
`limit`	integer
`after`	string	next_cursor from the previous page.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Search Instagram hashtag

POST/tools/instagram_search_hashtag MCP tool instagram_search_hashtag Read only

Top (or recent) public posts with a hashtag. Instagram allows 30 different hashtags per account per 7 days.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`hashtag` required	string
`recent`	boolean
`limit`	integer
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Look up another Instagram account

POST/tools/instagram_lookup_account MCP tool instagram_lookup_account Read only

Another business or creator account's public profile and recent posts (e.g. a competitor), by username.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`username` required	string
`limit`	integer
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Publish to Instagram

POST/tools/instagram_publish MCP tool instagram_publish Changes data

Publish a photo (IMAGE, image_url), a reel (REELS, video_url), a story (STORIES) or a carousel (CAROUSEL, items: 2-10 of {image_url} or {video_url}). Files must be at public https URLs (JPEG for photos). Returns a preview first; call again with confirm=true after the user agrees. A video still processing returns a container_id for instagram_publish_container.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`media_type`	IMAGE \| REELS \| STORIES \| CAROUSEL
`caption`	string
`image_url`	string
`video_url`	string
`items`	array of object
`share_to_feed`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Finish an Instagram publish

POST/tools/instagram_publish_container MCP tool instagram_publish_container Changes data

Publish a media container that was still processing (from instagram_publish). Returns its status first; call again with confirm=true.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`container_id` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Reply to Instagram comment

POST/tools/instagram_reply_to_comment MCP tool instagram_reply_to_comment Changes data

Reply to a comment (comment_id), or comment on one of the account's posts (media_id).

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`message` required	string
`comment_id`	string
`media_id`	string	Media ID (from instagram_list_media).
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Hide or unhide Instagram comment

POST/tools/instagram_hide_comment MCP tool instagram_hide_comment Changes data

Hide a comment on the account's media (hidden=true) or show it again.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`comment_id` required	string
`hidden`	boolean
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Delete Instagram comment

POST/tools/instagram_delete_comment MCP tool instagram_delete_comment Changes data

Delete a comment on the account's media. This can't be undone (hiding can). Returns a preview first; call again with confirm=true.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`comment_id` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Turn Instagram comments on or off

POST/tools/instagram_set_comments MCP tool instagram_set_comments Changes data

Turn comments on (enabled=true) or off for one of the account's posts.

Field	Type	About
`ig_account_id` required	string	Instagram account ID. See instagram_list_accounts.
`media_id` required	string	Media ID (from instagram_list_media).
`enabled`	boolean
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Instagram: setup checks

POST/tools/instagram_setup_checks MCP tool instagram_setup_checks Read only

Whether everything on the Instagram side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Instagram connection to use. Optional when the client has one, or a default.

Meta Business

4 tools Tools for a client's Meta Business connections (meta_business_...).

List Meta business portfolios

POST/tools/meta_business_list_businesses MCP tool meta_business_list_businesses Read only

Business portfolios (Business Manager) this connection belongs to, with verification status and primary Page.

Field	Type	About
`connection`	string	Which Meta Business connection to use. Optional when the client has one, or a default.

Get Meta business portfolio

POST/tools/meta_business_get_business MCP tool meta_business_get_business Read only

One business portfolio's details.

Field	Type	About
`business_id` required	string	Business portfolio ID. See meta_business_list_businesses.
`connection`	string	Which Meta Business connection to use. Optional when the client has one, or a default.

List Meta business assets

POST/tools/meta_business_list_assets MCP tool meta_business_list_assets Read only

What a business owns or manages for clients: ad_accounts, pages, instagram_accounts, product_catalogs, pixels; or its clients and agencies.

Field	Type	About
`business_id` required	string	Business portfolio ID. See meta_business_list_businesses.
`kind` required	ad_accounts \| pages \| instagram_accounts \| product_catalogs \| pixels \| clients \| agencies
`connection`	string	Which Meta Business connection to use. Optional when the client has one, or a default.

Meta Business: setup checks

POST/tools/meta_business_setup_checks MCP tool meta_business_setup_checks Read only

Whether everything on the Meta Business side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Meta Business connection to use. Optional when the client has one, or a default.

WordPress

24 tools6 change data Tools for a client's WordPress connections (wordpress_...).

WordPress: list live events

POST/tools/wordpress_list_live_events MCP tool wordpress_list_live_events Read only

List events WordPress pushed to Metric Sensei by webhook (forms, woo_order_created, woo_order_updated, woo_customer_created), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use wordpress_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. forms.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

WordPress: get a live event

POST/tools/wordpress_get_live_event MCP tool wordpress_get_live_event Read only

One live event from WordPress with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

WordPress: live events status

POST/tools/wordpress_live_events_status MCP tool wordpress_live_events_status Read only

Whether live events (webhooks) from WordPress are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Get WordPress site

POST/tools/wordpress_get_site MCP tool wordpress_get_site Read only

Site name, address, time zone, available REST APIs and the Metric Sensei plugin's status.

Field	Type	About
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress posts or pages

POST/tools/wordpress_list_posts MCP tool wordpress_list_posts Read only

Posts (type=post) or pages (type=page), newest first. Filter by status (comma-separated), search text, categories/tags (IDs) and after/before (ISO dates).

Field	Type	About
`type`	post \| page
`status`	string	e.g. publish or draft,pending
`search`	string
`categories`	array of integer
`tags`	array of integer
`after`	string	ISO 8601 date, e.g. 2026-01-01T00:00:00
`before`	string
`orderby`	date \| modified \| title \| id
`order`	asc \| desc
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Get WordPress post or page

POST/tools/wordpress_get_post MCP tool wordpress_get_post Read only

One post or page with its raw and rendered content.

Field	Type	About
`post_id` required	integer
`type`	post \| page
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress media

POST/tools/wordpress_list_media MCP tool wordpress_list_media Read only

Media library items (images, video, documents), newest first.

Field	Type	About
`search`	string
`media_type`	image \| video \| audio \| application
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress categories or tags

POST/tools/wordpress_list_terms MCP tool wordpress_list_terms Read only

Categories or tags with their post counts, most used first.

Field	Type	About
`taxonomy`	categories \| tags
`search`	string
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress comments

POST/tools/wordpress_list_comments MCP tool wordpress_list_comments Read only

Comments, newest first. status: approve (default), hold (awaiting moderation), spam, trash or all.

Field	Type	About
`status`	approve \| hold \| spam \| trash \| all
`post_id`	integer
`search`	string
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress users

POST/tools/wordpress_list_users MCP tool wordpress_list_users Read only

The site's users with their roles.

Field	Type	About
`search`	string
`roles`	array of string
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress plugins

POST/tools/wordpress_list_plugins MCP tool wordpress_list_plugins Read only

Installed plugins with version and status (needs an administrator's password).

Field	Type	About
`status`	active \| inactive
`search`	string
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress themes

POST/tools/wordpress_list_themes MCP tool wordpress_list_themes Read only

Installed themes and which one is active.

Field	Type	About
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Search WordPress site

POST/tools/wordpress_search MCP tool wordpress_search Read only

Search the site's content. type: post (posts and pages, default), term or post-format.

Field	Type	About
`search` required	string
`type`	post \| term \| post-format
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Read any WordPress REST route

POST/tools/wordpress_rest_get MCP tool wordpress_rest_get Read only

GET any REST route on the site, e.g. /wc/v3/orders (WooCommerce) or /yoast/v1/... query is an object of query-string parameters. Use wordpress_get_site to see the available namespaces.

Field	Type	About
`route` required	string
`query`	object
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

WooCommerce sales summary

POST/tools/wordpress_woocommerce_sales MCP tool wordpress_woocommerce_sales Read only

WooCommerce orders and sales per day for a date range, with totals (orders, sales, net sales, refunds, average order value), from WooCommerce's sales report. Good for dashboard tiles.

Field	Type	About
`start_date`	string	YYYY-MM-DD (default: 29 days before end_date)
`end_date`	string	YYYY-MM-DD (default: today)
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress forms

POST/tools/wordpress_list_forms MCP tool wordpress_list_forms Read only

Every form of the site's form plugins (WPForms, Gravity Forms, Contact Form 7, Ninja Forms, Formidable, Fluent Forms, Forminator, Elementor Pro) with how many submissions are saved and the last one's time. Needs the Metric Sensei plugin 1.1.0+.

Field	Type	About
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

List WordPress form entries

POST/tools/wordpress_list_form_entries MCP tool wordpress_list_form_entries Read only

Form submissions saved by the Metric Sensei plugin, newest first: when, which form and page, the visitor's traffic source (source, medium, campaign, click ID, landing page, first touch) and the submitted fields. Filter by plugin and form_id (from wordpress_list_forms) and after/before (ISO dates, UTC).

Field	Type	About
`plugin`	wpforms \| gravityforms \| cf7 \| ninjaforms \| formidable \| fluentforms \| forminator \| elementor
`form_id`	string
`after`	string	ISO 8601, e.g. 2026-11-01
`before`	string
`per_page`	integer
`page`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Create or update WordPress post or page

POST/tools/wordpress_save_post MCP tool wordpress_save_post Changes data

Create a post or page (omit post_id; saved as a draft unless status says otherwise) or update one. content is HTML or block markup. Publishing, scheduling or changing a live post returns a preview unless confirm=true.

Field	Type	About
`post_id`	integer
`type`	post \| page
`title`	string
`content`	string
`excerpt`	string
`slug`	string
`status`	publish \| future \| draft \| pending \| private
`date`	string	Publish date (site time), e.g. 2026-12-01T09:00:00
`categories`	array of integer
`tags`	array of integer
`parent`	integer
`author`	integer
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Delete WordPress post or page

POST/tools/wordpress_delete_post MCP tool wordpress_delete_post Changes data

Move a post or page to the trash (force=true deletes it for good). Returns a preview unless confirm=true.

Field	Type	About
`post_id` required	integer
`type`	post \| page
`force`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Moderate WordPress comment

POST/tools/wordpress_moderate_comment MCP tool wordpress_moderate_comment Changes data

Approve, hold, mark as spam or trash a comment, or reply to it (action=reply with content).

Field	Type	About
`comment_id` required	integer
`action` required	approve \| hold \| spam \| trash \| reply
`content`	string
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Add WordPress category or tag

POST/tools/wordpress_create_term MCP tool wordpress_create_term Changes data

Add a category (with optional parent) or a tag.

Field	Type	About
`name` required	string
`taxonomy`	categories \| tags
`slug`	string
`description`	string
`parent`	integer
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Activate or deactivate WordPress plugin

POST/tools/wordpress_set_plugin MCP tool wordpress_set_plugin Changes data

Turn an installed plugin on or off (id from wordpress_list_plugins). Returns a preview unless confirm=true.

Field	Type	About
`plugin` required	string
`action` required	activate \| deactivate
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

Change anything through WordPress REST

POST/tools/wordpress_rest_write MCP tool wordpress_rest_write Changes data

Send POST, PUT, PATCH or DELETE to any REST route (e.g. WooCommerce), for what the other tools don't cover. Returns a preview unless confirm=true.

Field	Type	About
`method` required	POST \| PUT \| PATCH \| DELETE
`route` required	string
`query`	object
`body`	object
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

WordPress: setup checks

POST/tools/wordpress_setup_checks MCP tool wordpress_setup_checks Read only

Whether everything on the WordPress side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which WordPress connection to use. Optional when the client has one, or a default.

CallRail

19 tools3 change data Tools for a client's CallRail connections (callrail_...).

CallRail: list live events

POST/tools/callrail_list_live_events MCP tool callrail_list_live_events Read only

List events CallRail pushed to Metric Sensei by webhook (post_call, call_modified, text_received, form_submission), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use callrail_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. post_call.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

CallRail: get a live event

POST/tools/callrail_get_live_event MCP tool callrail_get_live_event Read only

One live event from CallRail with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

CallRail: live events status

POST/tools/callrail_live_events_status MCP tool callrail_live_events_status Read only

Whether live events (webhooks) from CallRail are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail accounts

POST/tools/callrail_list_accounts MCP tool callrail_list_accounts Read only

CallRail accounts this API key can see.

Field	Type	About
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail companies

POST/tools/callrail_list_companies MCP tool callrail_list_companies Read only

Companies in an account (usually one per client business). Filter by status or name.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`status`	active \| disabled
`search`	string
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail calls

POST/tools/callrail_list_calls MCP tool callrail_list_calls Read only

Calls, newest first, with caller, duration, source, lead status and tags. Filter by company, date, tracker, direction, answer status, lead status, tags or search text (name/number). Ask for more fields (e.g. utm_campaign, gclid, transcription) with fields.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`date_range`	recent \| today \| yesterday \| last_7_days \| last_30_days \| this_month \| last_month \| this_year \| last_year \| all_time
`start_date`	string	YYYY-MM-DD or ISO 8601; use instead of date_range.
`end_date`	string	YYYY-MM-DD or ISO 8601.
`tracker_id`	string
`direction`	inbound \| outbound
`answer_status`	answered \| missed \| voicemail
`lead_status`	good_lead \| not_a_lead \| previously_marked_good_lead
`tags`	array of string
`search`	string
`sort`	start_time \| duration \| customer_name
`order`	asc \| desc
`fields`	array of company_id \| company_name \| tracker_id \| source \| source_name \| medium \| campaign \| keywords \| landing_page_url \| referring_url \| gclid \| fbclid \| utm_source \| utm_medium \| utm_campaign \| utm_term \| utm_content \| lead_status \| value \| note \| tags \| first_call \| call_type \| agent_email \| transcription \| call_summary \| call_highlights \| sentiment \| keywords_spotted \| milestones \| person_id \| timeline_url	Extra fields to include, e.g. transcription, call_summary, sentiment, utm_campaign, gclid.
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

Get CallRail call

POST/tools/callrail_get_call MCP tool callrail_get_call Read only

One call. Add transcription, call_summary, sentiment or keywords_spotted to fields for Conversation Intelligence (when the account has it).

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`call_id` required	string
`fields`	array of company_id \| company_name \| tracker_id \| source \| source_name \| medium \| campaign \| keywords \| landing_page_url \| referring_url \| gclid \| fbclid \| utm_source \| utm_medium \| utm_campaign \| utm_term \| utm_content \| lead_status \| value \| note \| tags \| first_call \| call_type \| agent_email \| transcription \| call_summary \| call_highlights \| sentiment \| keywords_spotted \| milestones \| person_id \| timeline_url	Extra fields to include, e.g. transcription, call_summary, sentiment, utm_campaign, gclid.
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

CallRail call summary

POST/tools/callrail_call_summary MCP tool callrail_call_summary Read only

Call totals for a period: total, answered and missed calls, first-time callers, leads and average duration. Group by source, keywords, campaign, referrer, landing_page or company.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`date_range`	recent \| today \| yesterday \| last_7_days \| last_30_days \| this_month \| last_month \| this_year \| last_year \| all_time
`start_date`	string	YYYY-MM-DD or ISO 8601; use instead of date_range.
`end_date`	string	YYYY-MM-DD or ISO 8601.
`group_by`	source \| keywords \| campaign \| referrer \| landing_page \| company
`fields`	array of total_calls \| missed_calls \| answered_calls \| first_time_callers \| average_duration \| formatted_average_duration \| leads
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

CallRail calls over time

POST/tools/callrail_call_timeseries MCP tool callrail_call_timeseries Read only

Call totals per hour, day, week or month for a period.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`date_range`	recent \| today \| yesterday \| last_7_days \| last_30_days \| this_month \| last_month \| this_year \| last_year \| all_time
`start_date`	string	YYYY-MM-DD or ISO 8601; use instead of date_range.
`end_date`	string	YYYY-MM-DD or ISO 8601.
`interval`	hour \| day \| week \| month
`fields`	array of total_calls \| missed_calls \| answered_calls \| first_time_callers \| average_duration \| formatted_average_duration \| leads
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail tracking numbers

POST/tools/callrail_list_trackers MCP tool callrail_list_trackers Read only

Tracking numbers (source and website session trackers): numbers, where they forward, what source they track, and their company.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`status`	active \| disabled
`type`	source \| session
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail form submissions

POST/tools/callrail_list_form_submissions MCP tool callrail_list_form_submissions Read only

Website form submissions captured by CallRail form tracking, with source and UTM data.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`date_range`	recent \| today \| yesterday \| last_7_days \| last_30_days \| this_month \| last_month \| this_year \| last_year \| all_time
`start_date`	string	YYYY-MM-DD or ISO 8601; use instead of date_range.
`end_date`	string	YYYY-MM-DD or ISO 8601.
`lead_status`	good_lead \| not_a_lead \| previously_marked_good_lead
`order`	asc \| desc
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail text conversations

POST/tools/callrail_list_text_conversations MCP tool callrail_list_text_conversations Read only

SMS conversations with customers on tracking numbers, newest first.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`date_range`	recent \| today \| yesterday \| last_7_days \| last_30_days \| this_month \| last_month \| this_year \| last_year \| all_time
`start_date`	string	YYYY-MM-DD or ISO 8601; use instead of date_range.
`end_date`	string	YYYY-MM-DD or ISO 8601.
`search`	string
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

Get CallRail text conversation

POST/tools/callrail_get_text_conversation MCP tool callrail_get_text_conversation Read only

One SMS conversation with its recent messages.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`conversation_id` required	string
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail tags

POST/tools/callrail_list_tags MCP tool callrail_list_tags Read only

Tags used to label calls, form submissions and texts.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id`	string	Company ID (COM... or a number). See callrail_list_companies.
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

List CallRail users

POST/tools/callrail_list_users MCP tool callrail_list_users Read only

The account's CallRail users and their roles.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`page`	integer
`per_page`	integer
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

Update CallRail call

POST/tools/callrail_update_call MCP tool callrail_update_call Changes data

Add a note or tags, set lead status or value, name the caller, or mark spam on one call. Tags are added to the existing ones unless replace_tags is true. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id` required	string	Company ID (COM... or a number). See callrail_list_companies.
`call_id` required	string
`note`	string
`tags`	array of string
`replace_tags`	boolean
`lead_status`	good_lead \| not_a_lead \| previously_marked_good_lead
`value`	string	Lead value, e.g. 250.00
`customer_name`	string
`spam`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

Create CallRail tag

POST/tools/callrail_create_tag MCP tool callrail_create_tag Changes data

Add a tag to a company's tag list. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id` required	string	Company ID (COM... or a number). See callrail_list_companies.
`name` required	string
`color`	string	CallRail color name, e.g. blue1, red1, green1.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

Send CallRail text message

POST/tools/callrail_send_text MCP tool callrail_send_text Changes data

Send an SMS to a customer from one of the company's tracking numbers (the number must have texting turned on). Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	CallRail account ID (ACC... or a number). See callrail_list_accounts.
`company_id` required	string	Company ID (COM... or a number). See callrail_list_companies.
`tracking_number` required	string	The company's tracking number, e.g. +15555550100
`customer_phone_number` required	string
`content` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

CallRail: setup checks

POST/tools/callrail_setup_checks MCP tool callrail_setup_checks Read only

Whether everything on the CallRail side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which CallRail connection to use. Optional when the client has one, or a default.

Microsoft Advertising

18 tools6 change data Tools for a client's Microsoft Advertising connections (microsoft_ads_...).

List Microsoft Advertising accounts

POST/tools/microsoft_ads_list_accounts MCP tool microsoft_ads_list_accounts Read only

Customers (manager accounts) and ad accounts this Microsoft sign-in can reach, with IDs.

Field	Type	About
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising campaigns

POST/tools/microsoft_ads_list_campaigns MCP tool microsoft_ads_list_campaigns Read only

An ad account's campaigns with status, type, daily budget and bidding.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_type`	Search \| Shopping \| DynamicSearchAds \| Audience \| PerformanceMax
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising ad groups

POST/tools/microsoft_ads_list_ad_groups MCP tool microsoft_ads_list_ad_groups Read only

A campaign's ad groups with status and default bid.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising ads

POST/tools/microsoft_ads_list_ads MCP tool microsoft_ads_list_ads Read only

An ad group's ads (responsive search, expanded text, product and other ads) with their text and status.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`ad_group_id` required	string	Ad group ID. See microsoft_ads_list_ad_groups.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising keywords

POST/tools/microsoft_ads_list_keywords MCP tool microsoft_ads_list_keywords Read only

An ad group's keywords with match type, bid and status.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`ad_group_id` required	string	Ad group ID. See microsoft_ads_list_ad_groups.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising budgets

POST/tools/microsoft_ads_list_budgets MCP tool microsoft_ads_list_budgets Read only

An ad account's shared budgets.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising conversion goals

POST/tools/microsoft_ads_list_conversion_goals MCP tool microsoft_ads_list_conversion_goals Read only

An ad account's conversion goals (destination URL, event, duration, offline and others).

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

List Microsoft Advertising UET tags

POST/tools/microsoft_ads_list_uet_tags MCP tool microsoft_ads_list_uet_tags Read only

An ad account's UET (Universal Event Tracking) tags and whether they are receiving data.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Microsoft Advertising performance report

POST/tools/microsoft_ads_run_report MCP tool microsoft_ads_run_report Read only

Performance for an ad account: account, campaign, ad_group, keyword, search_query (what people searched), geographic or destination_url (landing pages). Impressions, clicks, CTR, CPC, spend, conversions and revenue by default. Waits about 20 seconds; if the report isn't ready it returns a report_id for microsoft_ads_get_report.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`report`	account \| campaign \| ad_group \| keyword \| search_query \| geographic \| destination_url
`campaign_id`	string	Limit the report to one campaign (not for the account report).
`date_range`	today \| yesterday \| last_7_days \| last_14_days \| last_30_days \| this_week \| last_week \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use with end_date instead of date_range.
`end_date`	string	YYYY-MM-DD.
`aggregation`	Summary \| Hourly \| Daily \| Weekly \| Monthly \| Yearly \| DayOfWeek \| HourOfDay
`columns`	array of string	Microsoft report column names to use instead of the defaults, e.g. Impressions, Clicks, Spend, Conversions, AllConversions, ImpressionSharePercent.
`max_rows`	integer
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Microsoft Advertising search totals

POST/tools/microsoft_ads_search_totals MCP tool microsoft_ads_search_totals Read only

Daily search impressions and clicks for an ad account, split into searches containing the given terms (for example the brand) and all other searches. Microsoft builds the report in the background: if it isn't ready in about 8 seconds this returns status running and a report_id; call again in about 20 seconds with that report_id and the same arguments.

Field	Type	About
`terms` required	array of string
`start_date` required	string	YYYY-MM-DD
`end_date` required	string	YYYY-MM-DD
`account_id`	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`exclude_terms`	array of string
`report_id`	string	From an earlier call that returned running.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Get Microsoft Advertising report

POST/tools/microsoft_ads_get_report MCP tool microsoft_ads_get_report Read only

Pick up a report that microsoft_ads_run_report returned as still running.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`report_id` required	string
`max_rows`	integer
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Create Microsoft Advertising campaign

POST/tools/microsoft_ads_create_campaign MCP tool microsoft_ads_create_campaign Changes data

Create a Search campaign with a daily budget. It is always created paused. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`name` required	string
`daily_budget` required	number	In the account's currency.
`time_zone`	string
`languages`	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Update Microsoft Advertising campaign

POST/tools/microsoft_ads_update_campaign MCP tool microsoft_ads_update_campaign Changes data

Rename a campaign, pause it or turn it on (Active spends money), or change its daily budget. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`name`	string
`status`	Active \| Paused
`daily_budget`	number
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Update Microsoft Advertising ad group

POST/tools/microsoft_ads_update_ad_group MCP tool microsoft_ads_update_ad_group Changes data

Pause or turn on an ad group, or change its default CPC bid. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`ad_group_id` required	string	Ad group ID. See microsoft_ads_list_ad_groups.
`status`	Active \| Paused
`cpc_bid`	number
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Add Microsoft Advertising keywords

POST/tools/microsoft_ads_add_keywords MCP tool microsoft_ads_add_keywords Changes data

Add keywords to an ad group. They are added paused unless status is Active. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`ad_group_id` required	string	Ad group ID. See microsoft_ads_list_ad_groups.
`keywords` required	array of object
`status`	Active \| Paused
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Update Microsoft Advertising keyword

POST/tools/microsoft_ads_update_keyword MCP tool microsoft_ads_update_keyword Changes data

Pause or turn on a keyword, or change its bid. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`ad_group_id` required	string	Ad group ID. See microsoft_ads_list_ad_groups.
`keyword_id` required	string
`status`	Active \| Paused
`bid`	number
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Add Microsoft Advertising negative keywords

POST/tools/microsoft_ads_add_negative_keywords MCP tool microsoft_ads_add_negative_keywords Changes data

Add negative keywords (exact or phrase) to a campaign, or to one of its ad groups when ad_group_id is given, so ads stop showing for those searches. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	Ad account ID (numeric, not the account number). See microsoft_ads_list_accounts.
`campaign_id` required	string	Campaign ID. See microsoft_ads_list_campaigns.
`keywords` required	array of object
`ad_group_id`	string	Ad group ID. See microsoft_ads_list_ad_groups.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Microsoft Advertising: setup checks

POST/tools/microsoft_ads_setup_checks MCP tool microsoft_ads_setup_checks Read only

Whether everything on the Microsoft Advertising side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Microsoft Advertising connection to use. Optional when the client has one, or a default.

Bing Webmaster Tools

17 tools3 change data Tools for a client's Bing Webmaster Tools connections (bing_webmaster_...).

List Bing Webmaster sites

POST/tools/bing_webmaster_list_sites MCP tool bing_webmaster_list_sites Read only

Sites added to this Bing Webmaster Tools account and whether each is verified.

Field	Type	About
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing search queries

POST/tools/bing_webmaster_query_stats MCP tool bing_webmaster_query_stats Read only

Search queries that showed the site on Bing, with clicks, impressions and average positions per week, most clicks first.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing top pages

POST/tools/bing_webmaster_page_stats MCP tool bing_webmaster_page_stats Read only

The site's pages that appeared on Bing, with clicks, impressions and positions, most clicks first.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing queries for a page

POST/tools/bing_webmaster_page_queries MCP tool bing_webmaster_page_queries Read only

Search queries that showed one page of the site on Bing.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`page` required	string
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing pages for a query

POST/tools/bing_webmaster_query_pages MCP tool bing_webmaster_query_pages Read only

The site's pages that showed on Bing for one search query.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`query` required	string
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing clicks and impressions

POST/tools/bing_webmaster_traffic MCP tool bing_webmaster_traffic Read only

The site's Bing clicks and impressions per day (about the last six months).

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing crawl stats

POST/tools/bing_webmaster_crawl_stats MCP tool bing_webmaster_crawl_stats Read only

Bingbot's crawling of the site per day: pages crawled, crawl errors, pages blocked by robots.txt, pages in the index and more.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing crawl issues

POST/tools/bing_webmaster_crawl_issues MCP tool bing_webmaster_crawl_issues Read only

Pages Bing had trouble crawling: HTTP errors, redirects, robots.txt blocks, malware and other issues.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`limit`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing URL info

POST/tools/bing_webmaster_url_info MCP tool bing_webmaster_url_info Read only

What Bing knows about one page of the site: whether it is indexed, when it was last crawled, its HTTP status and size.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`url` required	string
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing inbound links

POST/tools/bing_webmaster_link_counts MCP tool bing_webmaster_link_counts Read only

The site's pages with the number of inbound links Bing found for each, one page of results at a time (page 0 first).

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`page`	integer
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

List Bing sitemaps

POST/tools/bing_webmaster_list_sitemaps MCP tool bing_webmaster_list_sitemaps Read only

Sitemaps and feeds submitted for the site, with status, last crawl and URL counts.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing URL submission quota

POST/tools/bing_webmaster_submission_quota MCP tool bing_webmaster_submission_quota Read only

How many more URLs the site may submit to Bing today and this month.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing keyword research

POST/tools/bing_webmaster_keyword_research MCP tool bing_webmaster_keyword_research Read only

Bing search volume for a keyword: weekly impressions, for a country (e.g. us) and language (e.g. en-US). Not tied to a site.

Field	Type	About
`query` required	string
`country`	string
`language`	string
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Submit URLs to Bing

POST/tools/bing_webmaster_submit_urls MCP tool bing_webmaster_submit_urls Changes data

Ask Bing to crawl up to 500 pages of the site now. Each URL counts against the site's daily quota (see bing_webmaster_submission_quota). Returns a preview unless confirm=true.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`urls` required	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Submit sitemap to Bing

POST/tools/bing_webmaster_submit_sitemap MCP tool bing_webmaster_submit_sitemap Changes data

Submit a sitemap (or RSS/Atom feed) on the site to Bing. Returns a preview unless confirm=true.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`sitemap_url` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Remove sitemap from Bing

POST/tools/bing_webmaster_remove_sitemap MCP tool bing_webmaster_remove_sitemap Changes data

Remove a submitted sitemap from Bing Webmaster Tools. Returns a preview unless confirm=true.

Field	Type	About
`site_url` required	string	Site as listed by bing_webmaster_list_sites, e.g. https://www.example.com/
`sitemap_url` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Bing Webmaster Tools: setup checks

POST/tools/bing_webmaster_setup_checks MCP tool bing_webmaster_setup_checks Read only

Whether everything on the Bing Webmaster Tools side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Bing Webmaster Tools connection to use. Optional when the client has one, or a default.

Supermetrics

6 tools Tools for a client's Supermetrics connections (supermetrics_...).

List Supermetrics connectors

POST/tools/supermetrics_list_connectors MCP tool supermetrics_list_connectors Read only

The platforms (connectors) the Supermetrics team has signed in to, with their logins. Set include_supported for every connector ID Supermetrics offers.

Field	Type	About
`include_supported`	boolean
`connection`	string	Which Supermetrics connection to use. Optional when the client has one, or a default.

List Supermetrics accounts

POST/tools/supermetrics_list_accounts MCP tool supermetrics_list_accounts Read only

Accounts (ad accounts, GA4 properties, pages, ...) under a connector's logins. Use their account_id in supermetrics_query.

Field	Type	About
`ds_id`	string	Supermetrics connector ID, e.g. AW (Google Ads), FA (Facebook Ads), GAWA (GA4), LIA (LinkedIn Ads). See supermetrics_list_connectors.
`search`	string
`refresh`	boolean	Ask Supermetrics to re-read the account list.
`connection`	string	Which Supermetrics connection to use. Optional when the client has one, or a default.

List Supermetrics fields

POST/tools/supermetrics_list_fields MCP tool supermetrics_list_fields Read only

Metrics and dimensions a connector offers, with the field_id to pass in fields.

Field	Type	About
`ds_id`	string	Supermetrics connector ID, e.g. AW (Google Ads), FA (Facebook Ads), GAWA (GA4), LIA (LinkedIn Ads). See supermetrics_list_connectors.
`search`	string
`type`	metric \| dimension
`limit`	integer
`connection`	string	Which Supermetrics connection to use. Optional when the client has one, or a default.

Run Supermetrics query

POST/tools/supermetrics_query MCP tool supermetrics_query Read only

A report from one connector: fields (dimensions and metrics) for chosen accounts and dates. Returns columns and rows. A slow query returns status RUNNING and a schedule_id for supermetrics_query_status.

Field	Type	About
`fields` required	array of string	Field IDs, e.g. Date, Clicks.
`ds_id`	string	Supermetrics connector ID, e.g. AW (Google Ads), FA (Facebook Ads), GAWA (GA4), LIA (LinkedIn Ads). See supermetrics_list_connectors.
`accounts`	array of string	Account IDs from supermetrics_list_accounts (account_id). Leave out for every account of the connector (only when the data source isn't limited to particular accounts).
`date_range_type`	today \| yesterday \| last_7_days \| last_14_days \| last_28_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD or relative, e.g. 30 days ago.
`end_date`	string	YYYY-MM-DD or relative, e.g. yesterday.
`filter`	string	Supermetrics filter, e.g. Clicks > 10.
`order_rows`	string	e.g. Clicks desc
`max_rows`	integer
`ds_user`	string	Use only this login (its ds_user).
`settings`	object	Connector-specific Supermetrics settings.
`connection`	string	Which Supermetrics connection to use. Optional when the client has one, or a default.

Get Supermetrics query result

POST/tools/supermetrics_query_status MCP tool supermetrics_query_status Read only

The result of a query that returned RUNNING. Pass its schedule_id with the same ds_id and accounts.

Field	Type	About
`schedule_id` required	string
`ds_id`	string	Supermetrics connector ID, e.g. AW (Google Ads), FA (Facebook Ads), GAWA (GA4), LIA (LinkedIn Ads). See supermetrics_list_connectors.
`accounts`	array of string	Account IDs from supermetrics_list_accounts (account_id). Leave out for every account of the connector (only when the data source isn't limited to particular accounts).
`connection`	string	Which Supermetrics connection to use. Optional when the client has one, or a default.

Supermetrics: setup checks

POST/tools/supermetrics_setup_checks MCP tool supermetrics_setup_checks Read only

Whether everything on the Supermetrics side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Supermetrics connection to use. Optional when the client has one, or a default.

Blazeo

5 tools Tools for a client's Blazeo connections (blazeo_...).

List Blazeo chat leads

POST/tools/blazeo_list_leads MCP tool blazeo_list_leads Read only

Chat leads Blazeo (formerly ApexChat) sent, newest first: name, email, phone, message, lead type, page, referrer and UTM/click IDs. Transcripts are left out (use blazeo_get_lead). Filter by date, lead_type or search text; page with next_cursor.

Field	Type	About
`start_date`	string	YYYY-MM-DD (UTC) or ISO 8601. Default: 30 days ago.
`end_date`	string	YYYY-MM-DD (UTC, whole day) or ISO 8601. Default: now.
`lead_type`	string	e.g. sales, service
`search`	string	Text in the name, email, phone, message, page or transcript.
`include_tests`	boolean	Include test leads sent from the admin page.
`order`	desc \| asc
`limit`	integer
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Blazeo connection to use. Optional when the client has one, or a default.

Get Blazeo chat lead

POST/tools/blazeo_get_lead MCP tool blazeo_get_lead Read only

One chat lead with its full transcript and every field Blazeo sent.

Field	Type	About
`lead_id` required	string
`connection`	string	Which Blazeo connection to use. Optional when the client has one, or a default.

Blazeo lead summary

POST/tools/blazeo_lead_summary MCP tool blazeo_lead_summary Read only

How many chat leads came in over a period, grouped by day, week, month, lead_type, page_url, referrer (host), utm_source, utm_medium or utm_campaign. Days are UTC.

Field	Type	About
`start_date`	string	YYYY-MM-DD (UTC) or ISO 8601. Default: 30 days ago.
`end_date`	string	YYYY-MM-DD (UTC, whole day) or ISO 8601. Default: now.
`group_by`	day \| week \| month \| lead_type \| page_url \| referrer \| utm_source \| utm_medium \| utm_campaign
`connection`	string	Which Blazeo connection to use. Optional when the client has one, or a default.

Blazeo webhook status

POST/tools/blazeo_webhook_status MCP tool blazeo_webhook_status Read only

Whether Blazeo is sending leads to this data source: leads received and when the last one arrived.

Field	Type	About
`connection`	string	Which Blazeo connection to use. Optional when the client has one, or a default.

Blazeo: setup checks

POST/tools/blazeo_setup_checks MCP tool blazeo_setup_checks Read only

Whether everything on the Blazeo side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Blazeo connection to use. Optional when the client has one, or a default.

Salesforce

19 tools5 change data Tools for a client's Salesforce connections (salesforce_...).

Get Salesforce org info

POST/tools/salesforce_org_info MCP tool salesforce_org_info Read only

The Salesforce org (name, edition, sandbox, time zone) and its API usage limits.

Field	Type	About
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

List Salesforce objects

POST/tools/salesforce_list_objects MCP tool salesforce_list_objects Read only

Objects (standard and custom) this connection can see, with whether records can be created, changed or deleted.

Field	Type	About
`search`	string
`custom_only`	boolean
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Describe Salesforce object

POST/tools/salesforce_describe_object MCP tool salesforce_describe_object Read only

An object's fields: API names, types, picklist values, lookups and which are required. Use before writing SOQL or creating records.

Field	Type	About
`object` required	string	Object API name, e.g. Account, Lead, Opportunity, Invoice__c.
`search`	string	Only fields whose name or label contains this.
`include_children`	boolean	List child relationships too.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Run SOQL query

POST/tools/salesforce_query MCP tool salesforce_query Read only

Run a read-only SOQL SELECT query, e.g. SELECT Id, Name, StageName, Amount FROM Opportunity WHERE CloseDate = THIS_QUARTER. Returns up to max_rows records (default 200, at most 2000).

Field	Type	About
`soql` required	string
`max_rows`	integer
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Search Salesforce

POST/tools/salesforce_search MCP tool salesforce_search Read only

Find records by text (name, email, phone, ...) in some objects (default Account, Contact, Lead, Opportunity).

Field	Type	About
`text` required	string
`objects`	array of string
`max_rows`	integer
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Get Salesforce record

POST/tools/salesforce_get_record MCP tool salesforce_get_record Read only

One record by ID, with all fields or the ones named.

Field	Type	About
`id` required	string	Salesforce record ID (15 or 18 characters).
`fields`	array of string
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

List Salesforce reports

POST/tools/salesforce_list_reports MCP tool salesforce_list_reports Read only

Reports in the org, newest first. Not available when the data source is limited to particular objects.

Field	Type	About
`search`	string
`max_rows`	integer
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Run Salesforce report

POST/tools/salesforce_run_report MCP tool salesforce_run_report Read only

Run a report now and return its columns, groupings, rows (up to 2,000) and totals.

Field	Type	About
`report_id` required	string	Salesforce record ID (15 or 18 characters).
`include_details`	boolean
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

List Salesforce dashboards

POST/tools/salesforce_list_dashboards MCP tool salesforce_list_dashboards Read only

Dashboards in the org, newest first.

Field	Type	About
`max_rows`	integer
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Get Salesforce dashboard

POST/tools/salesforce_get_dashboard MCP tool salesforce_get_dashboard Read only

A dashboard's components with their figures as last refreshed in Salesforce.

Field	Type	About
`dashboard_id` required	string	Salesforce record ID (15 or 18 characters).
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Summarize Salesforce leads

POST/tools/salesforce_lead_summary MCP tool salesforce_lead_summary Read only

Leads created between two dates (default last 30 days) counted by lead source and/or status, plus leads converted in that range.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`group_by`	source \| status \| source_and_status
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Salesforce opportunity pipeline

POST/tools/salesforce_opportunity_pipeline MCP tool salesforce_opportunity_pipeline Read only

Opportunities closing between two dates (default last 90 days) by stage, with count and amount, and open, won and lost totals. Optionally split by lead source.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`by_lead_source`	boolean
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

List Salesforce campaigns

POST/tools/salesforce_list_campaigns MCP tool salesforce_list_campaigns Read only

Campaigns with leads, contacts, responses, opportunities, won amount and costs.

Field	Type	About
`active_only`	boolean
`search`	string
`max_rows`	integer
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Create Salesforce record

POST/tools/salesforce_create_record MCP tool salesforce_create_record Changes data

Create one record (e.g. a Lead, Contact, Opportunity or custom object). Without confirm=true it only returns a preview.

Field	Type	About
`object` required	string	Object API name, e.g. Account, Lead, Opportunity, Invoice__c.
`fields` required	object	Field API name -> value, e.g. {"LastName": "Lee", "Company": "Acme", "LeadSource": "Web"}. Use salesforce_describe_object for names and picklist values.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Update Salesforce record

POST/tools/salesforce_update_record MCP tool salesforce_update_record Changes data

Change some fields of one record; the others stay as they are. Without confirm=true it only returns a preview.

Field	Type	About
`id` required	string	Salesforce record ID (15 or 18 characters).
`fields` required	object	Field API name -> value, e.g. {"LastName": "Lee", "Company": "Acme", "LeadSource": "Web"}. Use salesforce_describe_object for names and picklist values.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Delete Salesforce record

POST/tools/salesforce_delete_record MCP tool salesforce_delete_record Changes data

Delete one record. It goes to the Recycle Bin and can be restored there for 15 days. Without confirm=true it only returns a preview.

Field	Type	About
`id` required	string	Salesforce record ID (15 or 18 characters).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Add or remove Salesforce campaign member

POST/tools/salesforce_campaign_member MCP tool salesforce_campaign_member Changes data

Add a lead or contact to a campaign (optionally with a member status such as Responded), or remove them. Without confirm=true it only returns a preview.

Field	Type	About
`action` required	add \| remove
`campaign_id` required	string	Salesforce record ID (15 or 18 characters).
`person_id` required	string	Lead or Contact ID.
`status`	string	Campaign member status, e.g. Sent, Responded.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Log Salesforce activity

POST/tools/salesforce_log_activity MCP tool salesforce_log_activity Changes data

Log a completed task or call on a lead or contact (who_id) and/or a related record such as an account or opportunity (what_id). Without confirm=true it only returns a preview.

Field	Type	About
`subject` required	string
`type`	task \| call
`description`	string
`date`	string	YYYY-MM-DD
`status`	string	Task status, default Completed.
`who_id`	string	Lead or Contact ID.
`what_id`	string	Account, Opportunity, Campaign, Case, ... ID.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

Salesforce: setup checks

POST/tools/salesforce_setup_checks MCP tool salesforce_setup_checks Read only

Whether everything on the Salesforce side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Salesforce connection to use. Optional when the client has one, or a default.

MNTN (Mountain)

17 tools Tools for a client's MNTN (Mountain) connections (mntn_...).

List MNTN advertisers

POST/tools/mntn_list_advertisers MCP tool mntn_list_advertisers Read only

The advertisers the MNTN API key reaches (usually one), with currency and time zone.

Field	Type	About
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

List MNTN campaigns

POST/tools/mntn_list_campaigns MCP tool mntn_list_campaigns Read only

An advertiser's MNTN campaigns: status, objective, goal, budget and flight dates.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`status`	string	Only this status, e.g. Live.
`search`	string
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

List MNTN report columns

POST/tools/mntn_list_columns MCP tool mntn_list_columns Read only

Tables and columns MNTN's reporting API offers (1,000+ metrics), with the table.column names to use in mntn_report. Filter by table or search text.

Field	Type	About
`table`	string	e.g. graph, campaigninfo, conversions
`search`	string	e.g. roas, households, visits
`limit`	integer
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN performance

POST/tools/mntn_performance MCP tool mntn_performance Read only

MNTN Performance TV results by day, week, month, campaign, creative or channel: spend, impressions, CTV impressions, households reached, verified visits, conversions, revenue, ROAS, CPA, CPM. First touch by default (MNTN's default), or last touch.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`by`	day \| week \| month \| campaign \| creative \| channel \| total
`attribution`	first_touch \| last_touch
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`limit`	integer
`offset`	integer
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Run MNTN report

POST/tools/mntn_report MCP tool mntn_report Read only

Any MNTN report: choose columns (mntn_list_columns), optional group_by, filter and sort, for a date range. Visitor IPs and street addresses aren't available.

Field	Type	About
`columns` required	array of string	Columns as table.column, e.g. graph.day, graph.spend, campaigninfo.name (mntn_list_columns).
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`group_by`	array of string	Columns to group (sum) by, e.g. campaigninfo.name.
`filter`	object	MNTN filter: {"table.column": value \| [values] \| {"gt": 100}}, with AND/OR/NOT groups. Operators: equals, not, in, notIn, lt, lte, gt, gte, contains, notContains, startsWith, endsWith, hasAny.
`sort`	array of string	e.g. graph.spend desc
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`limit`	integer
`offset`	integer
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

List MNTN conversions

POST/tools/mntn_conversions MCP tool mntn_conversions Read only

Individual conversions MNTN attributed: time, type, order ID, lead ID, order amount, campaign, channel, click-through or view, first/last touch, and city/state/ZIP. Newest first.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`conversion_type`	string	e.g. Purchase, Lead
`order_id`	string
`lead_id`	string
`last_touch_only`	boolean
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`limit`	integer
`offset`	integer
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN attribution paths

POST/tools/mntn_attribution_paths MCP tool mntn_attribution_paths Read only

MNTN's Attribution Paths report: verified visits, site visitors, conversions and revenue by the UTM source, medium or marketing parameter visitors arrived with (direct and indirect).

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`by`	source \| medium \| source_medium \| marketing_parameter \| day
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`limit`	integer
`offset`	integer
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Start MNTN CSV export

POST/tools/mntn_export_submit MCP tool mntn_export_submit Read only

Queue a large MNTN report as a CSV export (same arguments as mntn_report). Returns a batch_id for mntn_export_status.

Field	Type	About
`columns` required	array of string	Columns as table.column, e.g. graph.day, graph.spend, campaigninfo.name (mntn_list_columns).
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`group_by`	array of string	Columns to group (sum) by.
`filter`	object
`sort`	array of string
`limit`	integer
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN export status

POST/tools/mntn_export_status MCP tool mntn_export_status Read only

Status of an export from mntn_export_submit and, once SUCCEEDED, a fresh time-limited download link for the CSV. Pass the same advertiser_id and campaign_ids as the export.

Field	Type	About
`batch_id` required	string
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN incrementality (holdout) results

POST/tools/mntn_incrementality MCP tool mntn_incrementality Read only

MNTN's holdout tests: households that saw the ads vs similar households held back, with incremental visitors, conversions, revenue, ROAS and CPA (also for new-to-brand), plus MNTN ghost-bid tests with significance. The strongest proof of TV impact. Only advertisers enrolled in MNTN's lift program have results; the answer says so when there are none.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`by`	campaign \| day \| total
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN reach and frequency

POST/tools/mntn_reach_frequency MCP tool mntn_reach_frequency Read only

Households reached by the TV ads, average frequency, new vs existing households and site visitors, visits, conversions and spend, by day, week, month, campaign, DMA, state, city, ZIP or total.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`by`	day \| week \| month \| campaign \| dma \| state \| city \| zip \| total
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`limit`	integer
`offset`	integer
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN response timing

POST/tools/mntn_response_timing MCP tool mntn_response_timing Read only

How soon TV ads work: verified visits and conversions by days (or hours) since a household saw the ad, plus the share of visits on the 1st to 7th day after.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`unit`	day \| hour
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

Get MNTN TV flights

POST/tools/mntn_tv_flights MCP tool mntn_tv_flights Read only

When the TV ads ran: impressions, CTV impressions, households, spend and commercials aired by day, grouped into flights (runs of on-air days), or by hour for up to 14 days.

Field	Type	About
`advertiser_id`	string	MNTN advertiser ID (mntn_list_advertisers). Leave out to use the key's own advertiser.
`campaign_ids`	array of string	Limit to these campaign IDs (mntn_list_campaigns). Required when the data source is limited to particular campaigns.
`by`	day \| hour
`min_share`	number	A day is on air with at least this share of the busiest day's impressions (default 0.05).
`gap_days`	integer	Join flights split by up to this many off-air days (default 2).
`begin`	string	First day, YYYY-MM-DD. Default: 30 days before end.
`end`	string	Last day, YYYY-MM-DD. Default: yesterday (MNTN data lags ~36 hours).
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

MNTN: list live events

POST/tools/mntn_list_live_events MCP tool mntn_list_live_events Read only

List events MNTN pushed to Metric Sensei by webhook (verified_visit), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use mntn_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. verified_visit.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

MNTN: get a live event

POST/tools/mntn_get_live_event MCP tool mntn_get_live_event Read only

One live event from MNTN with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

MNTN: live events status

POST/tools/mntn_live_events_status MCP tool mntn_live_events_status Read only

Whether live events (webhooks) from MNTN are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

MNTN (Mountain): setup checks

POST/tools/mntn_setup_checks MCP tool mntn_setup_checks Read only

Whether everything on the MNTN (Mountain) side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which MNTN (Mountain) connection to use. Optional when the client has one, or a default.

RingCentral RingEX

16 tools1 change data Tools for a client's RingCentral RingEX connections (ringex_...).

RingCentral RingEX: list live events

POST/tools/ringex_list_live_events MCP tool ringex_list_live_events Read only

List events RingCentral RingEX pushed to Metric Sensei by webhook (call_ended, sms_received), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use ringex_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. call_ended.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral RingEX: get a live event

POST/tools/ringex_get_live_event MCP tool ringex_get_live_event Read only

One live event from RingCentral RingEX with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral RingEX: live events status

POST/tools/ringex_live_events_status MCP tool ringex_live_events_status Read only

Whether live events (webhooks) from RingCentral RingEX are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral account

POST/tools/ringex_account_info MCP tool ringex_account_info Read only

The RingCentral account: company, main number, brand, plan, and who signed in.

Field	Type	About
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

List RingCentral extensions

POST/tools/ringex_list_extensions MCP tool ringex_list_extensions Read only

Users, call queues (type Department), IVR menus and other extensions, with extension numbers. Filter by types, status or a name search.

Field	Type	About
`types`	array of User \| Department \| Announcement \| Voicemail \| SharedLinesGroup \| PagingOnly \| IvrMenu \| ApplicationExtension \| ParkLocation \| Limited \| Bot \| Site \| Room \| DelegatedLinesGroup \| GroupCallPickup
`status`	Enabled \| Disabled \| NotActivated \| Unassigned
`search`	string
`page`	integer
`per_page`	integer
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

List RingCentral phone numbers

POST/tools/ringex_list_phone_numbers MCP tool ringex_list_phone_numbers Read only

The account's phone numbers (main, direct, company and forwarded numbers) and which extension each rings.

Field	Type	About
`usage_type`	string	e.g. MainCompanyNumber, DirectNumber, CompanyNumber, ForwardedNumber
`page`	integer
`per_page`	integer
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

List RingCentral call queues

POST/tools/ringex_list_call_queues MCP tool ringex_list_call_queues Read only

Call queues (their extension_id is the queue ID for other tools).

Field	Type	About
`page`	integer
`per_page`	integer
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

List RingCentral call queue members

POST/tools/ringex_list_queue_members MCP tool ringex_list_queue_members Read only

The users (agents) in one call queue.

Field	Type	About
`queue_id` required	string
`page`	integer
`per_page`	integer
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

List RingCentral calls

POST/tools/ringex_list_calls MCP tool ringex_list_calls Read only

The call log, newest first: company-wide (needs an admin sign-in) or one extension's (required when the data source is limited to some extensions). Each call has caller and callee, direction, result (Accepted, Missed, Voicemail ...), duration and whether it was recorded. Default period: the last 24 hours. detailed=true adds each call's legs.

Field	Type	About
`extension_id`	string	Extension ID (from ringex_list_extensions; a user or call queue). '~' is the signed-in person.
`date_from`	string	YYYY-MM-DD or ISO 8601 (default: 24 hours ago).
`date_to`	string	YYYY-MM-DD or ISO 8601 (default: now).
`direction`	Inbound \| Outbound
`type`	Voice \| Fax
`result`	Accepted \| Missed \| Voicemail \| Rejected \| Busy \| No Answer \| Call connected \| Hang Up \| Stopped \| Unknown
`phone_number`	string	Only calls with this number (E.164).
`with_recording`	boolean
`detailed`	boolean
`page`	integer
`per_page`	integer
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

Get RingCentral call

POST/tools/ringex_get_call MCP tool ringex_get_call Read only

One call log record with all its legs (transfers, queue hops, voicemail).

Field	Type	About
`call_id` required	string
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

Get RingCentral call recording details

POST/tools/ringex_get_call_recording MCP tool ringex_get_call_recording Read only

A call's recording details (type, length). The audio itself isn't available here.

Field	Type	About
`call_id` required	string
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral call summary

POST/tools/ringex_call_summary MCP tool ringex_call_summary Read only

Call totals for a period from RingCentral Business Analytics: all calls, by direction, result and type, plus talk time. Group by Company, CompanyNumbers, Users, Queues, IVRs, Sites ... Default period: the last 7 days.

Field	Type	About
`date_from`	string	YYYY-MM-DD or ISO 8601 (default: 7 days ago).
`date_to`	string	YYYY-MM-DD or ISO 8601 (default: now).
`group_by`	Company \| CompanyNumbers \| Users \| Queues \| IVRs \| SharedLines \| UserGroups \| Sites \| Departments
`extension_ids`	array of string	Only these users or queues (required when the data source is limited to some extensions).
`direction`	Inbound \| Outbound
`time_zone`	string	IANA zone for the time range, e.g. America/Chicago.
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral calls over time

POST/tools/ringex_call_timeline MCP tool ringex_call_timeline Read only

The same totals per Hour, Day, Week or Month for a period.

Field	Type	About
`date_from`	string	YYYY-MM-DD or ISO 8601 (default: 7 days ago).
`date_to`	string	YYYY-MM-DD or ISO 8601 (default: now).
`group_by`	Company \| CompanyNumbers \| Users \| Queues \| IVRs \| SharedLines \| UserGroups \| Sites \| Departments
`extension_ids`	array of string	Only these users or queues (required when the data source is limited to some extensions).
`direction`	Inbound \| Outbound
`time_zone`	string	IANA zone for the time range, e.g. America/Chicago.
`interval`	Hour \| Day \| Week \| Month
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

List RingCentral text messages

POST/tools/ringex_list_messages MCP tool ringex_list_messages Read only

One extension's text messages (default: the signed-in person's), newest first. Default period: the last 7 days.

Field	Type	About
`extension_id`	string	Extension ID (from ringex_list_extensions; a user or call queue). '~' is the signed-in person.
`date_from`	string	YYYY-MM-DD or ISO 8601 (default: 24 hours ago).
`date_to`	string	YYYY-MM-DD or ISO 8601 (default: now).
`direction`	Inbound \| Outbound
`phone_number`	string
`page`	integer
`per_page`	integer
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

Send RingCentral text message

POST/tools/ringex_send_sms MCP tool ringex_send_sms Changes data

Send a text from one of the signed-in person's RingCentral numbers that can text. Returns a preview unless confirm=true.

Field	Type	About
`to` required	string	E.164, e.g. +15555550100
`text` required	string
`from_number`	string	Default: the person's first texting number.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral RingEX: setup checks

POST/tools/ringex_setup_checks MCP tool ringex_setup_checks Read only

Whether everything on the RingCentral RingEX side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which RingCentral RingEX connection to use. Optional when the client has one, or a default.

RingCentral RingCX

11 tools2 change data Tools for a client's RingCentral RingCX connections (ringcx_...).

List RingCX accounts

POST/tools/ringcx_list_accounts MCP tool ringcx_list_accounts Read only

The RingCX main account and sub-accounts this sign-in reaches.

Field	Type	About
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

List RingCX dial groups

POST/tools/ringcx_list_dial_groups MCP tool ringcx_list_dial_groups Read only

A sub-account's dial groups (outbound dialing setups: predictive, preview ...).

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

List RingCX campaigns

POST/tools/ringcx_list_campaigns MCP tool ringcx_list_campaigns Read only

Outbound campaigns of a sub-account, with their dial group and whether they're active.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`dial_group_id`	string
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

List RingCX queues

POST/tools/ringcx_list_queues MCP tool ringcx_list_queues Read only

Inbound queues (RingCX calls them gates) by queue group.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

List RingCX agents

POST/tools/ringcx_list_agents MCP tool ringcx_list_agents Read only

Agents by agent group, with username and type.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`agent_group_id`	string
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

Search RingCX leads

POST/tools/ringcx_search_leads MCP tool ringcx_search_leads Read only

Find campaign leads by campaign, lead state, disposition, external ID or phone number.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`campaign_ids`	array of string
`lead_states`	array of string	e.g. READY, ACTIVE, COMPLETE, PAUSED, CANCELLED
`agent_dispositions`	array of string
`extern_ids`	array of string
`phone_numbers`	array of string
`count`	integer
`page`	integer
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

List RingCX active calls

POST/tools/ringcx_list_active_calls MCP tool ringcx_list_active_calls Read only

Calls in progress on the sub-account right now.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

List RingCX interactions

POST/tools/ringcx_list_interactions MCP tool ringcx_list_interactions Read only

Finished calls and chats in a window of up to 3 hours starting at start: caller, dialed number, direction, agent, result, length, and whether it was recorded or transcribed. Needs WEM access on the RingCX account; data is ready about 5 minutes after a window ends.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`start` required	string	e.g. 2026-11-10 09:00:00 (in time_zone)
`hours`	number
`time_zone`	string	e.g. US/Eastern (default UTC)
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

Add RingCX leads

POST/tools/ringcx_add_leads MCP tool ringcx_add_leads Changes data

Load leads into a campaign as a new lead list (each needs leadPhone; up to 500). Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`campaign_id` required	string	Campaign ID (see ringcx_list_campaigns).
`leads` required	array of object
`description`	string	Name for the lead list.
`duplicate_handling`	RETAIN_ALL \| REMOVE_ALL_EXISTING \| REMOVE_FROM_LIST
`time_zone_option`	NOT_APPLICABLE \| NPA_NXX \| ZIPCODE \| EXPLICIT \| COUNTRY
`dial_now`	boolean	Dial these before other leads.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

Change RingCX leads

POST/tools/ringcx_lead_action MCP tool ringcx_lead_action Changes data

Pause, ready, reset, cancel, suppress, unsuppress or delete leads of one campaign, named by lead_ids or extern_ids. Returns a preview unless confirm=true.

Field	Type	About
`account_id` required	string	RingCX sub-account ID (see ringcx_list_accounts).
`campaign_id` required	string	Campaign ID (see ringcx_list_campaigns).
`action` required	PAUSE_LEADS \| READY_LEADS \| RESET_LEADS \| CANCEL_LEADS \| SUPPRESS_LEADS \| UNSUPPRESS_LEADS \| DELETE_LEADS
`lead_ids`	array of string
`extern_ids`	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

RingCentral RingCX: setup checks

POST/tools/ringcx_setup_checks MCP tool ringcx_setup_checks Read only

Whether everything on the RingCentral RingCX side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which RingCentral RingCX connection to use. Optional when the client has one, or a default.

Oracle NetSuite

17 tools2 change data Tools for a client's Oracle NetSuite connections (netsuite_...).

List NetSuite subsidiaries

POST/tools/netsuite_list_subsidiaries MCP tool netsuite_list_subsidiaries Read only

The NetSuite account's subsidiaries (OneWorld), with parents. Empty for accounts without subsidiaries.

Field	Type	About
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

List NetSuite record types

POST/tools/netsuite_list_record_types MCP tool netsuite_list_record_types Read only

Record types the NetSuite REST API offers (customer, salesOrder, invoice, custom records).

Field	Type	About
`search`	string
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Describe NetSuite record type

POST/tools/netsuite_describe_record_type MCP tool netsuite_describe_record_type Read only

The fields of one NetSuite record type: names, types and labels (for netsuite_get_record, SuiteQL and writes).

Field	Type	About
`record_type` required	string	e.g. customer, salesOrder
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Run NetSuite SuiteQL query

POST/tools/netsuite_suiteql MCP tool netsuite_suiteql Read only

Run a read-only SuiteQL (SQL-like) query, e.g. SELECT id, entityid, email FROM customer WHERE datecreated >= TO_DATE('2026-01-01','YYYY-MM-DD'). Pages of up to 1,000 rows. Not available while the data source is limited to subsidiaries; use the other tools then.

Field	Type	About
`query` required	string
`limit`	integer
`offset`	integer
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Get NetSuite record

POST/tools/netsuite_get_record MCP tool netsuite_get_record Read only

One NetSuite record by type and internal ID (e.g. customer 123, salesOrder 4567), optionally only some fields.

Field	Type	About
`record_type` required	string
`record_id` required	string
`fields`	array of string
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

List NetSuite customers and leads

POST/tools/netsuite_list_customers MCP tool netsuite_list_customers Read only

Customers, leads or prospects, newest first: name, email, phone, stage, status, lead source (campaign) and subsidiary. Filter by stage, text, created or modified date.

Field	Type	About
`stage`	customer \| lead \| prospect
`search`	string
`created_after`	string	YYYY-MM-DD
`modified_after`	string	YYYY-MM-DD
`include_inactive`	boolean
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`limit`	integer
`offset`	integer
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

List NetSuite contacts

POST/tools/netsuite_list_contacts MCP tool netsuite_list_contacts Read only

Contacts (people at customers), newest first, with email, phone and company.

Field	Type	About
`company_id`	string
`search`	string
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`limit`	integer
`offset`	integer
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

List NetSuite transactions

POST/tools/netsuite_list_transactions MCP tool netsuite_list_transactions Read only

Sales orders, invoices, cash sales (or other types) in a date range, newest first: number, date, status, customer, total and currency, PO/reference number, lead source and subsidiary.

Field	Type	About
`types`	array of sales_order \| invoice \| cash_sale \| credit_memo \| estimate \| opportunity \| cash_refund \| payment	Transaction types. Default: sales_order, invoice, cash_sale.
`customer_id`	string
`search`	string	Text in the number, reference number or memo.
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`start_date`	string	First day, YYYY-MM-DD.
`end_date`	string	Last day, YYYY-MM-DD. Default: today.
`limit`	integer
`offset`	integer
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Get NetSuite sales summary

POST/tools/netsuite_sales_summary MCP tool netsuite_sales_summary Read only

Number and total of sales transactions per day, week, month, quarter or year, by type and currency (totals in each transaction's own currency). Default: last 90 days by month.

Field	Type	About
`by`	day \| week \| month \| quarter \| year
`types`	array of sales_order \| invoice \| cash_sale \| credit_memo \| estimate \| opportunity \| cash_refund \| payment	Transaction types. Default: sales_order, invoice, cash_sale.
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`start_date`	string	First day, YYYY-MM-DD.
`end_date`	string	Last day, YYYY-MM-DD. Default: today.
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

List NetSuite items

POST/tools/netsuite_list_items MCP tool netsuite_list_items Read only

Items (products and services). Not available while the data source is limited to subsidiaries.

Field	Type	About
`search`	string
`limit`	integer
`offset`	integer
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

List NetSuite campaigns

POST/tools/netsuite_list_campaigns MCP tool netsuite_list_campaigns Read only

Marketing campaigns (the lead sources on customers and transactions): dates, cost and expected revenue. Not available while the data source is limited to subsidiaries.

Field	Type	About
`limit`	integer
`offset`	integer
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Create NetSuite record

POST/tools/netsuite_create_record MCP tool netsuite_create_record Changes data

Create a NetSuite customer, lead, prospect, contact or note. Returns a preview unless confirm is true. Pass subsidiary_id to place it in a subsidiary (required when the data source is limited).

Field	Type	About
`record_type` required	customer \| lead \| prospect \| contact \| note
`fields` required	object	Field names and values as NetSuite's REST record API takes them, e.g. {"companyName": "Acme", "email": "a@acme.com"}; references as {"id": "12"}. See netsuite_describe_record_type.
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Update NetSuite record

POST/tools/netsuite_update_record MCP tool netsuite_update_record Changes data

Change fields on a NetSuite customer, lead, prospect, contact or note. Returns a preview unless confirm is true. Nothing is ever deleted.

Field	Type	About
`record_type` required	customer \| lead \| prospect \| contact \| note
`record_id` required	string
`fields` required	object	Field names and values as NetSuite's REST record API takes them, e.g. {"companyName": "Acme", "email": "a@acme.com"}; references as {"id": "12"}. See netsuite_describe_record_type.
`subsidiary_id`	string	Only this subsidiary (internal ID from netsuite_list_subsidiaries). Required when the data source is limited to subsidiaries.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

NetSuite: list live events

POST/tools/netsuite_list_live_events MCP tool netsuite_list_live_events Read only

List events NetSuite pushed to Metric Sensei by webhook (customer, lead, sales_order, invoice), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use netsuite_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. customer.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

NetSuite: get a live event

POST/tools/netsuite_get_live_event MCP tool netsuite_get_live_event Read only

One live event from NetSuite with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

NetSuite: live events status

POST/tools/netsuite_live_events_status MCP tool netsuite_live_events_status Read only

Whether live events (webhooks) from NetSuite are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

Oracle NetSuite: setup checks

POST/tools/netsuite_setup_checks MCP tool netsuite_setup_checks Read only

Whether everything on the Oracle NetSuite side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Oracle NetSuite connection to use. Optional when the client has one, or a default.

HubSpot

24 tools6 change data Tools for a client's HubSpot connections (hubspot_...).

Get HubSpot account info

POST/tools/hubspot_account_info MCP tool hubspot_account_info Read only

The HubSpot account (ID, time zone, currency, data hosting), who signed in and the permissions (scopes) granted.

Field	Type	About
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot objects

POST/tools/hubspot_list_objects MCP tool hubspot_list_objects Read only

Object types in the account: contacts, companies, deals, tickets ... and custom objects.

Field	Type	About
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot properties

POST/tools/hubspot_list_properties MCP tool hubspot_list_properties Read only

An object's properties: names, labels, types, dropdown options and which are read-only. Use before searching with filters or writing records.

Field	Type	About
`object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`search`	string	Only names/labels containing this.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Search HubSpot records

POST/tools/hubspot_search_records MCP tool hubspot_search_records Read only

Find records of one object type by text (query) and/or property filters (AND), e.g. contacts with filters [{"property": "lifecyclestage", "operator": "EQ", "value": "lead"}] or deals closing this month with BETWEEN on closedate (epoch ms). sort is a property name, "-" for newest first. Returns up to max_rows (default 100, at most 2000) and next_after to continue.

Field	Type	About
`object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`query`	string
`filters`	array of object
`properties`	array of string	Property names to return (default: the useful ones for contacts, companies, deals, tickets).
`sort`	string	Property to sort by, e.g. -createdate.
`max_rows`	integer
`after`	string	next_after from an earlier call.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Get HubSpot record

POST/tools/hubspot_get_record MCP tool hubspot_get_record Read only

One record by ID with chosen properties and the IDs of associated records (e.g. a deal's contacts and company).

Field	Type	About
`object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`id` required	string	HubSpot record ID (digits).
`properties`	array of string	Property names to return (default: the useful ones for contacts, companies, deals, tickets).
`associations`	array of string
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot pipelines

POST/tools/hubspot_list_pipelines MCP tool hubspot_list_pipelines Read only

Deal or ticket pipelines with their stages in order (IDs, labels, win probability).

Field	Type	About
`object`	deals \| tickets
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

HubSpot deal pipeline summary

POST/tools/hubspot_deal_pipeline MCP tool hubspot_deal_pipeline Read only

Deals with a close date between two dates (default last 90 days) by pipeline and stage, with count and amount, plus open, won and lost totals. Optionally split by original source.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`pipeline_id`	string
`by_source`	boolean
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Summarize HubSpot contacts

POST/tools/hubspot_contact_summary MCP tool hubspot_contact_summary Read only

Contacts created between two dates (default last 30 days) counted by lifecycle stage, original source (organic search, paid search, social ...) or lead status.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`group_by`	lifecycle_stage \| source \| lead_status
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot forms

POST/tools/hubspot_list_forms MCP tool hubspot_list_forms Read only

The account's forms (ID, name, type).

Field	Type	About
`search`	string
`max_rows`	integer
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot form submissions

POST/tools/hubspot_form_submissions MCP tool hubspot_form_submissions Read only

A form's submissions, newest first: time, page URL and answers.

Field	Type	About
`form_id` required	string
`max_rows`	integer
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot marketing emails

POST/tools/hubspot_list_marketing_emails MCP tool hubspot_list_marketing_emails Read only

Marketing emails, newest first, with sends, opens, clicks, bounces, unsubscribes and rates. Needs Marketing Hub.

Field	Type	About
`state`	string	e.g. PUBLISHED, DRAFT, SCHEDULED
`max_rows`	integer
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot campaigns

POST/tools/hubspot_list_campaigns MCP tool hubspot_list_campaigns Read only

Marketing campaigns with dates, status, owner, audience and goal.

Field	Type	About
`search`	string
`max_rows`	integer
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot owners

POST/tools/hubspot_list_owners MCP tool hubspot_list_owners Read only

People records can be assigned to (owner ID, name, email, teams).

Field	Type	About
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

List HubSpot lists

POST/tools/hubspot_list_lists MCP tool hubspot_list_lists Read only

Lists (segments): ID, name, static or active, object type and size.

Field	Type	About
`search`	string
`max_rows`	integer
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Create HubSpot record

POST/tools/hubspot_create_record MCP tool hubspot_create_record Changes data

Create one record (contact, company, deal, ticket, custom object ...), optionally linked to other records. Without confirm=true it only returns a preview.

Field	Type	About
`object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`properties` required	object	Property name -> value, e.g. {"email": "lee@acme.com", "firstname": "Lee", "lifecyclestage": "lead"}. Use hubspot_list_properties for names and option values.
`associate_with`	array of object	Records to link it to, e.g. [{"object": "contacts", "id": "123"}].
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Update HubSpot record

POST/tools/hubspot_update_record MCP tool hubspot_update_record Changes data

Change some properties of one record; the others stay as they are. Without confirm=true it only returns a preview.

Field	Type	About
`object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`id` required	string	HubSpot record ID (digits).
`properties` required	object	Property name -> value, e.g. {"email": "lee@acme.com", "firstname": "Lee", "lifecyclestage": "lead"}. Use hubspot_list_properties for names and option values.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Archive HubSpot record

POST/tools/hubspot_archive_record MCP tool hubspot_archive_record Changes data

Archive (delete) one record. It can be restored in HubSpot for 90 days. Without confirm=true it only returns a preview.

Field	Type	About
`object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`id` required	string	HubSpot record ID (digits).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Link or unlink HubSpot records

POST/tools/hubspot_associate MCP tool hubspot_associate Changes data

Link two records (e.g. a contact to a deal) or remove the link. Without confirm=true it only returns a preview.

Field	Type	About
`action` required	add \| remove
`from_object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`from_id` required	string	HubSpot record ID (digits).
`to_object` required	string	Object type: contacts, companies, deals, tickets, leads, products, line_items, quotes, calls, emails, meetings, notes, tasks, or a custom object's name or objectTypeId (e.g. 2-1234567).
`to_id` required	string	HubSpot record ID (digits).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Log HubSpot activity

POST/tools/hubspot_log_activity MCP tool hubspot_log_activity Changes data

Log a note, task or call on one or more records (contacts, companies, deals, tickets). Without confirm=true it only returns a preview.

Field	Type	About
`associate_with` required	array of object	Records to link it to, e.g. [{"object": "contacts", "id": "123"}].
`type`	note \| task \| call
`subject`	string
`body`	string
`date`	string	YYYY-MM-DD
`status`	string	Task status, default COMPLETED.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Add or remove HubSpot list members

POST/tools/hubspot_list_membership MCP tool hubspot_list_membership Changes data

Add records to a static list or remove them (at most 100 per call). Active lists can't be changed by hand. Without confirm=true it only returns a preview.

Field	Type	About
`action` required	add \| remove
`list_id` required	string
`record_ids` required	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

HubSpot: list live events

POST/tools/hubspot_list_live_events MCP tool hubspot_list_live_events Read only

List events HubSpot pushed to Metric Sensei by webhook (contact.creation, contact.propertyChange, deal.propertyChange, company.deletion), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use hubspot_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. contact.creation.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

HubSpot: get a live event

POST/tools/hubspot_get_live_event MCP tool hubspot_get_live_event Read only

One live event from HubSpot with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

HubSpot: live events status

POST/tools/hubspot_live_events_status MCP tool hubspot_live_events_status Read only

Whether live events (webhooks) from HubSpot are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

HubSpot: setup checks

POST/tools/hubspot_setup_checks MCP tool hubspot_setup_checks Read only

Whether everything on the HubSpot side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which HubSpot connection to use. Optional when the client has one, or a default.

Snapfulfil

28 tools5 change data Tools for a client's Snapfulfil connections (snapfulfil_...).

Snapfulfil: list live events

POST/tools/snapfulfil_list_live_events MCP tool snapfulfil_list_live_events Read only

List events Snapfulfil pushed to Metric Sensei by webhook (DESPATCH, RECEIPT, STOCK_MOVE), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use snapfulfil_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. DESPATCH.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil: get a live event

POST/tools/snapfulfil_get_live_event MCP tool snapfulfil_get_live_event Read only

One live event from Snapfulfil with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil: live events status

POST/tools/snapfulfil_live_events_status MCP tool snapfulfil_live_events_status Read only

Whether live events (webhooks) from Snapfulfil are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil shipments

POST/tools/snapfulfil_list_shipments MCP tool snapfulfil_list_shipments Read only

Shipments (outbound orders being picked, packed and despatched), newest first: customer, stage, status, carrier, tracking, values and pick/pack times. Filter by date, stage, status, customer, carrier, site or order type.

Field	Type	About
`created_from`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (inclusive).
`created_to`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (exclusive).
`stage`	string	Stage code, e.g. 00 Due Out, 90 closed (see snapfulfil_lookup).
`status`	string	Status code (see snapfulfil_lookup).
`site`	string	Site ID, e.g. 0001.
`customer_id`	string
`carrier_id`	string
`order_type`	string
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Get Snapfulfil shipment

POST/tools/snapfulfil_get_shipment MCP tool snapfulfil_get_shipment Read only

One shipment with its lines, addresses, contacts and despatch (carrier) details.

Field	Type	About
`shipment_id` required	string
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil shipments summary

POST/tools/snapfulfil_shipments_summary MCP tool snapfulfil_shipments_summary Read only

Counts of open shipments, or shipments closed (despatched) on a day, by owner, site, warehouse, stage, status, carrier and ship method.

Field	Type	About
`state`	open \| closed
`site`	string	Site ID, e.g. 0001.
`date`	string	YYYY-MM-DD: closed on this day (needs state closed and site).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil sales orders

POST/tools/snapfulfil_list_sales_orders MCP tool snapfulfil_list_sales_orders Read only

Sales orders sent to the warehouse, newest first. Filter by date, stage, status, customer or site.

Field	Type	About
`created_from`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (inclusive).
`created_to`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (exclusive).
`stage`	string	Stage code, e.g. 00 Due Out, 90 closed (see snapfulfil_lookup).
`status`	string	Status code (see snapfulfil_lookup).
`site`	string	Site ID, e.g. 0001.
`customer_id`	string
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Get Snapfulfil sales order

POST/tools/snapfulfil_get_sales_order MCP tool snapfulfil_get_sales_order Read only

One sales order with its lines and addresses.

Field	Type	About
`order_id` required	string
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil purchase orders

POST/tools/snapfulfil_list_purchase_orders MCP tool snapfulfil_list_purchase_orders Read only

Purchase orders (stock expected from suppliers), newest first.

Field	Type	About
`created_from`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (inclusive).
`created_to`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (exclusive).
`stage`	string	Stage code, e.g. 00 Due Out, 90 closed (see snapfulfil_lookup).
`status`	string	Status code (see snapfulfil_lookup).
`site`	string	Site ID, e.g. 0001.
`supplier_id`	string
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil receipts

POST/tools/snapfulfil_list_receipts MCP tool snapfulfil_list_receipts Read only

Receipts (goods in from suppliers), newest first, with supplier, stage, GRN and carrier details.

Field	Type	About
`created_from`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (inclusive).
`created_to`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (exclusive).
`stage`	string	Stage code, e.g. 00 Due Out, 90 closed (see snapfulfil_lookup).
`status`	string	Status code (see snapfulfil_lookup).
`site`	string	Site ID, e.g. 0001.
`supplier_id`	string
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Get Snapfulfil receipt

POST/tools/snapfulfil_get_receipt MCP tool snapfulfil_get_receipt Read only

One receipt with its lines.

Field	Type	About
`receipt_id` required	string
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil receipts summary

POST/tools/snapfulfil_receipts_summary MCP tool snapfulfil_receipts_summary Read only

Counts of open receipts, or receipts closed on a day, by owner, site, stage and status.

Field	Type	About
`state`	open \| closed
`site`	string	Site ID, e.g. 0001.
`date`	string	YYYY-MM-DD: closed on this day (needs state closed and site).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil customer returns

POST/tools/snapfulfil_list_returns MCP tool snapfulfil_list_returns Read only

Customer returns, newest first, with reasons and stage.

Field	Type	About
`created_from`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (inclusive).
`created_to`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (exclusive).
`stage`	string	Stage code, e.g. 00 Due Out, 90 closed (see snapfulfil_lookup).
`status`	string	Status code (see snapfulfil_lookup).
`site`	string	Site ID, e.g. 0001.
`customer_id`	string
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil stock totals

POST/tools/snapfulfil_stock_totals MCP tool snapfulfil_stock_totals Read only

Stock per SKU: on hand, allocated, assigned, ordered and due in/out, and when it last moved. Pass sku for one product, or page through all.

Field	Type	About
`sku`	string
`site`	string
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil stock detail

POST/tools/snapfulfil_stock_detail MCP tool snapfulfil_stock_detail Read only

Where one SKU's stock sits: zone, bay, slot, unit, quantity, batch, serial and expiry.

Field	Type	About
`sku` required	string
`top`	integer
`skip`	integer
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil products

POST/tools/snapfulfil_list_products MCP tool snapfulfil_list_products Read only

Products (SKUs) with descriptions, units, dimensions and status.

Field	Type	About
`status`	string	Status code (see snapfulfil_lookup).
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Get Snapfulfil product

POST/tools/snapfulfil_get_product MCP tool snapfulfil_get_product Read only

One product (SKU) with its full details.

Field	Type	About
`sku` required	string
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil customers

POST/tools/snapfulfil_list_customers MCP tool snapfulfil_list_customers Read only

Customers that shipments go to.

Field	Type	About
`status`	string	Status code (see snapfulfil_lookup).
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil suppliers

POST/tools/snapfulfil_list_suppliers MCP tool snapfulfil_list_suppliers Read only

Suppliers that receipts and purchase orders come from.

Field	Type	About
`status`	string	Status code (see snapfulfil_lookup).
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

List Snapfulfil 3PL invoices

POST/tools/snapfulfil_list_invoices MCP tool snapfulfil_list_invoices Read only

Warehouse (3PL) invoices with period, currency, values and tax, newest first. Lines show each charge when include_lines is true.

Field	Type	About
`created_from`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (inclusive).
`created_to`	string	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS (exclusive).
`site`	string	Site ID, e.g. 0001.
`stage`	string	Stage code, e.g. 00 Due Out, 90 closed (see snapfulfil_lookup).
`biz_id`	string	Only this Biz (business). Defaults to the connection's Biz.
`owner_id`	string	Only this stock owner.
`filter`	string	Extra OData $filter, e.g. startswith(ShipmentId,'D17') or CarrierId eq 'UPS'.
`orderby`	string	Field name, optionally with ' desc', e.g. 'DateCreated desc'.
`top`	integer
`skip`	integer
`include_lines`	boolean	Include line, address and despatch arrays (long).
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil tasks summary

POST/tools/snapfulfil_tasks_summary MCP tool snapfulfil_tasks_summary Read only

Warehouse workload: task counts (picks, puts, replenishments, checks) by type and stage.

Field	Type	About
`task_type`	string
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil lookup codes

POST/tools/snapfulfil_lookup MCP tool snapfulfil_lookup Read only

What Snapfulfil's codes mean: pass a lookup code such as SHIPSTAGE, SHIPSTATUS, RECSTATUS, ORDTYPE, SHIPMETHOD, CARRIER or MESSAGE.

Field	Type	About
`code` required	string
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Change Snapfulfil shipment status

POST/tools/snapfulfil_set_shipment_status MCP tool snapfulfil_set_shipment_status Changes data

Change one shipment's status code, e.g. to suspend (hold) or cancel it; fulfilled shipments can't change. Find codes with snapfulfil_lookup code SHIPSTATUS. Returns a preview unless confirm=true.

Field	Type	About
`shipment_id` required	string
`status` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Update Snapfulfil shipment

POST/tools/snapfulfil_update_shipment MCP tool snapfulfil_update_shipment Changes data

Set a shipment's carrier tracking number or URL, customer reference, invoice number or proof of delivery. Lines are never changed. Returns a preview unless confirm=true.

Field	Type	About
`shipment_id` required	string
`carrier_tracking_number`	string
`carrier_track_url`	string
`customer_ref`	string
`invoice_number`	string
`pod`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Create Snapfulfil record

POST/tools/snapfulfil_create_record MCP tool snapfulfil_create_record Changes data

Create a shipment, sales order, purchase order, receipt, customer return, product, customer or supplier from Snapfulfil fields (e.g. a sales order with SOLines and Addresses). BizId defaults to the connection's Biz. Codes are checked by Snapfulfil (see snapfulfil_lookup). Returns a preview unless confirm=true.

Field	Type	About
`entity` required	shipment \| sales_order \| purchase_order \| receipt \| customer_return \| product \| customer \| supplier
`record` required	object	Snapfulfil field names and values, as the get/list tools show them (e.g. CustomerRef).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Update Snapfulfil record

POST/tools/snapfulfil_update_record MCP tool snapfulfil_update_record Changes data

Change fields of one shipment, order, receipt, return, product, customer or supplier. Only the fields in changes move; an array sent (e.g. lines) replaces the record's. BizId can't change. Returns a preview with the current values unless confirm=true.

Field	Type	About
`entity` required	shipment \| sales_order \| purchase_order \| receipt \| customer_return \| product \| customer \| supplier
`id` required	string
`changes` required	object	Snapfulfil field names and values, as the get/list tools show them (e.g. CustomerRef).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Delete Snapfulfil record

POST/tools/snapfulfil_delete_record MCP tool snapfulfil_delete_record Changes data

Delete one shipment, order, receipt, return, product, customer or supplier. Snapfulfil refuses records already in progress (cancel shipments with snapfulfil_set_shipment_status). Can't be undone. Returns a preview unless confirm=true.

Field	Type	About
`entity` required	shipment \| sales_order \| purchase_order \| receipt \| customer_return \| product \| customer \| supplier
`id` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

Snapfulfil: setup checks

POST/tools/snapfulfil_setup_checks MCP tool snapfulfil_setup_checks Read only

Whether everything on the Snapfulfil side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Snapfulfil connection to use. Optional when the client has one, or a default.

TechShip

18 tools5 change data Tools for a client's TechShip connections (techship_...).

List TechShip clients

POST/tools/techship_list_clients MCP tool techship_list_clients Read only

The portal's TechShip clients (shipper accounts) with their codes; optionally their carrier billing accounts, or inactive clients only.

Field	Type	About
`client_code`	string	TechShip client code. See techship_list_clients.
`client_name`	string
`include_accounts`	boolean
`inactive`	boolean	true lists only inactive clients.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

List TechShip carriers

POST/tools/techship_list_carriers MCP tool techship_list_carriers Read only

Carriers set up on the portal; optionally their service codes and billing accounts.

Field	Type	About
`client_code`	string	TechShip client code. See techship_list_clients.
`carrier_code`	string
`include_services`	boolean
`include_accounts`	boolean
`include_disabled`	boolean
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

List TechShip boxes

POST/tools/techship_list_boxes MCP tool techship_list_boxes Read only

Box sizes set up for clients: dimensions, weight and volume limits.

Field	Type	About
`client_code`	string	TechShip client code. See techship_list_clients.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

List TechShip shipments

POST/tools/techship_list_shipments MCP tool techship_list_shipments Read only

Shipments with status, dates, routing (carrier account and service), tracking numbers and freight charges, newest day first. Filter by dates (one day if left out; up to 31), client, carrier, status, order number, PO, transaction, tracking or batch number. A lookup by order, PO, transaction, tracking or batch number may leave the dates out.

Field	Type	About
`start_date`	string	YYYY-MM-DD (first day).
`end_date`	string	YYYY-MM-DD (last day, included). Ranges up to 31 days.
`date_type`	ProcessedOn \| CreatedOn \| ShipDate	Which date to filter on.
`client_code`	string	TechShip client code. See techship_list_clients.
`carrier_code`	string	Carrier code (SCAC).
`status`	Unprocessed \| Processed \| Merged \| Failed \| Preprocessed \| Refunded \| RefundFailed \| Processing \| Cancelling \| Failing \| Warning \| Estimating \| CreateDGIS
`transaction_number`	string
`tracking_number`	string
`customer_order`	string	The order number from the store or ERP.
`customer_po`	string
`batch_number`	string
`limit`	integer
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Get TechShip shipment

POST/tools/techship_get_shipment MCP tool techship_get_shipment Read only

One shipment in full: addresses, packages and items, tracking numbers and URLs, routing, freight charges and customs. Label files are left out (label URLs are kept).

Field	Type	About
`shipment_id` required	integer	TechShip shipment ID (Id from a shipment).
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Count TechShip shipments

POST/tools/techship_count_shipments MCP tool techship_count_shipments Read only

How many shipments a period has (up to 31 days), optionally for one client or carrier.

Field	Type	About
`start_date` required	string	YYYY-MM-DD (first day).
`end_date`	string	YYYY-MM-DD (last day, included). Ranges up to 31 days.
`date_type`	ProcessedOn \| CreatedOn \| ShipDate	Which date to filter on.
`client_code`	string	TechShip client code. See techship_list_clients.
`carrier_code`	string
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

TechShip shipping cost summary

POST/tools/techship_cost_summary MCP tool techship_cost_summary Read only

Freight totals for a period (up to 31 days): shipments, packages, shipping charge, fuel surcharge, taxes, markup, total and billable weight, grouped by day, service, carrier account, client or status. Only shipped (Processed or Warning) shipments count unless grouped by status.

Field	Type	About
`start_date` required	string	YYYY-MM-DD (first day).
`end_date`	string	YYYY-MM-DD (last day, included). Ranges up to 31 days.
`date_type`	ProcessedOn \| CreatedOn \| ShipDate	Which date to filter on.
`client_code`	string	TechShip client code. See techship_list_clients.
`carrier_code`	string
`group_by`	day \| service \| account \| client \| status
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

List TechShip manifests

POST/tools/techship_list_manifests MCP tool techship_list_manifests Read only

Carrier manifests (end-of-day close-outs), open or closed, with close time and errors. Manifests span clients, so this needs a data source that isn't limited to particular clients.

Field	Type	About
`start_date`	string	Closed on or after (closed manifests only).
`end_date`	string	Closed on or before.
`is_completed`	boolean
`is_failed`	boolean
`carrier_code`	string
`carrier_name`	string
`account_name`	string
`page`	integer
`page_size`	integer
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Get TechShip manifest

POST/tools/techship_get_manifest MCP tool techship_get_manifest Read only

One manifest: status, close time and error message.

Field	Type	About
`manifest_id` required	string	Manifest ID (ManifestId).
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

List TechShip manifest tracking numbers

POST/tools/techship_list_manifest_tracking_numbers MCP tool techship_list_manifest_tracking_numbers Read only

The tracking numbers on a manifest and whether each was validated.

Field	Type	About
`manifest_id` required	string	Manifest ID (ManifestId).
`page`	integer
`page_size`	integer
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

TechShip rate limits

POST/tools/techship_rate_limits MCP tool techship_rate_limits Read only

How many requests this API key may have in flight and how many are in use right now (general and quote pools).

Field	Type	About
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Get TechShip rate quote

POST/tools/techship_get_rate_quote MCP tool techship_get_rate_quote Read only

Carrier rates for a would-be shipment (rate shopping). Runs as a dry run: nothing is saved or booked in TechShip.

Field	Type	About
`client_code` required	string	TechShip client code. See techship_list_clients.
`order` required	object	TechShip shipment JSON (InputOrder): TransactionNumber, CustomerOrder, ShipToAddress {Name, Address1, City, StateProvince (2 letters), Postal, Country (ISO 2), Phone, Email}, Routing {AccountCode, ServiceCode}, Packages [{Weight (lb), Dimensions {Length, Width, Height} (in), Items [...]}]. ClientCode is set from client_code.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Create TechShip shipment

POST/tools/techship_create_shipment MCP tool techship_create_shipment Changes data

Create a shipment for a client and process it, which books the carrier label (or only import it unprocessed with import_only). Duplicates by transaction number are refused unless duplicate_handling says otherwise. Returns a preview unless confirm=true.

Field	Type	About
`client_code` required	string	TechShip client code. See techship_list_clients.
`order` required	object	TechShip shipment JSON (InputOrder): TransactionNumber, CustomerOrder, ShipToAddress {Name, Address1, City, StateProvince (2 letters), Postal, Country (ISO 2), Phone, Email}, Routing {AccountCode, ServiceCode}, Packages [{Weight (lb), Dimensions {Length, Width, Height} (in), Items [...]}]. ClientCode is set from client_code.
`import_only`	boolean	true imports without processing.
`duplicate_handling`	Exception \| Allow \| Overwrite \| OverwriteOpen \| OverwriteNotProcessed \| OverwriteNotProcessedOrReturnExisting
`label_preference`	ZPL \| PDF \| AZPL \| BZPL \| EPL \| DPL \| PNG
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Update TechShip shipment

POST/tools/techship_update_shipment MCP tool techship_update_shipment Changes data

Change an open shipment's details (addresses, packages, routing, references). The shipment must belong to client_code. Returns a preview unless confirm=true.

Field	Type	About
`client_code` required	string	TechShip client code. See techship_list_clients.
`shipment_id` required	integer	TechShip shipment ID (Id from a shipment).
`order` required	object	TechShip shipment JSON (InputOrder): TransactionNumber, CustomerOrder, ShipToAddress {Name, Address1, City, StateProvince (2 letters), Postal, Country (ISO 2), Phone, Email}, Routing {AccountCode, ServiceCode}, Packages [{Weight (lb), Dimensions {Length, Width, Height} (in), Items [...]}]. ClientCode is set from client_code.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Void TechShip shipment

POST/tools/techship_void_shipment MCP tool techship_void_shipment Changes data

Void or refund a shipment's carrier labels (also after manifesting, where the carrier allows it). The shipment must belong to client_code. Returns a preview unless confirm=true.

Field	Type	About
`client_code` required	string	TechShip client code. See techship_list_clients.
`shipment_id` required	integer	TechShip shipment ID (Id from a shipment).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Delete TechShip shipment

POST/tools/techship_delete_shipment MCP tool techship_delete_shipment Changes data

Void a shipment's labels and delete it, or keep it as an open order with leave_as_open. The shipment must belong to client_code. Returns a preview unless confirm=true.

Field	Type	About
`client_code` required	string	TechShip client code. See techship_list_clients.
`shipment_id` required	integer	TechShip shipment ID (Id from a shipment).
`leave_as_open`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Finalize TechShip manifest

POST/tools/techship_finalize_manifest MCP tool techship_finalize_manifest Changes data

Close a carrier manifest (end-of-day close-out), handing every shipment on it to the carrier, including other orders already on it. Manifests span clients, so this needs a data source that isn't limited to particular clients. Returns a preview unless confirm=true.

Field	Type	About
`manifest_id` required	string	Manifest ID (ManifestId).
`pars_number`	string	PARS number (cross-border), if any.
`sync`	boolean	Wait for the carrier instead of closing in the background.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

TechShip: setup checks

POST/tools/techship_setup_checks MCP tool techship_setup_checks Read only

Whether everything on the TechShip side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which TechShip connection to use. Optional when the client has one, or a default.

Klaviyo

30 tools8 change data Tools for a client's Klaviyo connections (klaviyo_...).

Get Klaviyo account info

POST/tools/klaviyo_account_info MCP tool klaviyo_account_info Read only

The Klaviyo account (ID, name, time zone, currency, default sender) and how this data source signed in.

Field	Type	About
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo lists and segments

POST/tools/klaviyo_list_audiences MCP tool klaviyo_list_audiences Read only

Lists and (unless include_segments=false) segments. with_counts adds member counts for the first 25 (slow on Klaviyo's side).

Field	Type	About
`include_segments`	boolean
`with_counts`	boolean
`max_rows`	integer	Rows to return (default 50).
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Get a Klaviyo list or segment

POST/tools/klaviyo_get_audience MCP tool klaviyo_get_audience Read only

One list or segment with its profile count (and a segment's definition) and tags.

Field	Type	About
`audience_id` required	string
`type`	list \| segment
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo campaigns

POST/tools/klaviyo_list_campaigns MCP tool klaviyo_list_campaigns Read only

Campaigns of one channel (email by default), newest first, with status, send time, audiences and subject. Filter by status, name text or created date.

Field	Type	About
`channel`	email \| sms
`status`	draft \| scheduled \| sending \| sent \| cancelled \| adding recipients
`search`	string
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo campaign performance

POST/tools/klaviyo_campaign_performance MCP tool klaviyo_campaign_performance Read only

Campaign results for messages sent in a date range (default last 30 days): recipients, delivered, opens, clicks, unsubscribes, bounces, spam complaints, conversions, orders and revenue per campaign, plus totals. Same row shape as the other email sources. Rates are fractions (0.25 = 25%). Klaviyo allows few report calls per day, so answers are cached for 30 minutes (6 hours for past days).

Field	Type	About
`channel`	email \| sms
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`campaign_ids`	array of string
`conversion_metric_id`	string	Metric that counts as a conversion (default: Placed Order). See klaviyo_list_metrics.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo email activity over time

POST/tools/klaviyo_campaign_timeseries MCP tool klaviyo_campaign_timeseries Read only

The account's email activity per day, week or month across campaigns and flows: delivered, unique opens, unique clicks, unsubscribes, bounces, open/click rate, and store revenue (all Placed Order value, not only from email). Rates are fractions (0.25 = 25%). Klaviyo allows few report calls per day, so answers are cached for 30 minutes (6 hours for past days).

Field	Type	About
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`interval`	daily \| weekly \| monthly
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo flows

POST/tools/klaviyo_list_flows MCP tool klaviyo_list_flows Read only

Flows (automations: welcome series, abandoned cart ...) with status, trigger type and tags.

Field	Type	About
`status`	string	draft, manual or live
`include_archived`	boolean
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo flow performance

POST/tools/klaviyo_flow_performance MCP tool klaviyo_flow_performance Read only

Flow results in a date range: the same row shape as campaign performance with kind 'flow', per flow, plus totals, sorted by revenue. Rates are fractions (0.25 = 25%). Klaviyo allows few report calls per day, so answers are cached for 30 minutes (6 hours for past days).

Field	Type	About
`channel`	email \| sms
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`flow_ids`	array of string
`conversion_metric_id`	string	Metric that counts as a conversion (default: Placed Order). See klaviyo_list_metrics.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo flow results over time

POST/tools/klaviyo_flow_timeseries MCP tool klaviyo_flow_timeseries Read only

One flow's (or every flow's) results per day, week or month. Rates are fractions (0.25 = 25%). Klaviyo allows few report calls per day, so answers are cached for 30 minutes (6 hours for past days).

Field	Type	About
`flow_id`	string
`channel`	email \| sms
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`interval`	daily \| weekly \| monthly
`conversion_metric_id`	string	Metric that counts as a conversion (default: Placed Order). See klaviyo_list_metrics.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo metrics

POST/tools/klaviyo_list_metrics MCP tool klaviyo_list_metrics Read only

The event types (metrics) the account records, e.g. Placed Order, Opened Email, Active on Site, with the integration that sends each. Use their IDs with klaviyo_metric_aggregate.

Field	Type	About
`search`	string
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo metric totals

POST/tools/klaviyo_metric_aggregate MCP tool klaviyo_metric_aggregate Read only

Totals of one metric over time (count, unique people or sum_value, e.g. revenue from Placed Order), optionally split by up to two dimensions such as $attributed_flow, $attributed_message, $message or a property name. Rates are fractions (0.25 = 25%). Klaviyo allows few report calls per day, so answers are cached for 30 minutes (6 hours for past days).

Field	Type	About
`metric_id` required	string
`measurement`	count \| sum_value \| unique
`interval`	hour \| day \| week \| month
`by`	array of string
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Search Klaviyo profiles

POST/tools/klaviyo_search_subscribers MCP tool klaviyo_search_subscribers Read only

Profiles (subscribers) by email, phone number, external ID or changed since a date, or the members of one list or segment, with their email/SMS consent.

Field	Type	About
`email`	string
`phone_number`	string	E.164, e.g. +15551234567
`external_id`	string
`updated_since`	string	YYYY-MM-DD
`list_id`	string
`segment_id`	string
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Get a Klaviyo profile

POST/tools/klaviyo_get_subscriber MCP tool klaviyo_get_subscriber Read only

One profile (by profile_id or email) with consent, location, custom properties, lists, segments and predictive analytics (expected lifetime value, churn risk).

Field	Type	About
`profile_id`	string
`email`	string
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo events

POST/tools/klaviyo_list_events MCP tool klaviyo_list_events Read only

Events newest first (opens, clicks, orders, form submits, site activity ...), filtered by metric_id, profile_id and/or date range.

Field	Type	About
`metric_id`	string
`profile_id`	string
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo sign-up forms

POST/tools/klaviyo_list_forms MCP tool klaviyo_list_forms Read only

Sign-up forms (pop-ups, flyouts, embeds) with their status.

Field	Type	About
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo sign-up form performance

POST/tools/klaviyo_form_performance MCP tool klaviyo_form_performance Read only

Form views, unique views, submits and submit rate per form in a date range. Rates are fractions (0.25 = 25%). Klaviyo allows few report calls per day, so answers are cached for 30 minutes (6 hours for past days).

Field	Type	About
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`form_ids`	array of string
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo templates

POST/tools/klaviyo_list_templates MCP tool klaviyo_list_templates Read only

Email templates (name, editor type, dates), without their HTML.

Field	Type	About
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

List Klaviyo tags

POST/tools/klaviyo_list_tags MCP tool klaviyo_list_tags Read only

Tags used to organize campaigns, flows, lists and segments.

Field	Type	About
`max_rows`	integer	Rows to return (default 50).
`cursor`	string	next_cursor from the previous page.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Create or update a Klaviyo profile

POST/tools/klaviyo_upsert_subscriber MCP tool klaviyo_upsert_subscriber Changes data

Create a profile, or update the one with the same email, phone number or external ID (names, organization, custom properties). Doesn't change marketing consent: use klaviyo_subscribe. Without confirm=true it only returns a preview.

Field	Type	About
`email`	string
`phone_number`	string	E.164, e.g. +15551234567
`external_id`	string
`first_name`	string
`last_name`	string
`organization`	string
`title`	string
`properties`	object
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Subscribe people in Klaviyo

POST/tools/klaviyo_subscribe MCP tool klaviyo_subscribe Changes data

Subscribe up to 100 people to email (or SMS) marketing on a list. Only for people who agreed to receive marketing (consent_given=true). Without confirm=true it only returns a preview.

Field	Type	About
`list_id` required	string
`consent_given` required	boolean
`channel`	email \| sms
`email`	string
`phone_number`	string	E.164, e.g. +15551234567
`external_id`	string
`profiles`	array of object
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Unsubscribe people in Klaviyo

POST/tools/klaviyo_unsubscribe MCP tool klaviyo_unsubscribe Changes data

Unsubscribe up to 100 people from email (or SMS) marketing, everywhere or only from one list. Without confirm=true it only returns a preview.

Field	Type	About
`list_id`	string
`channel`	email \| sms
`email`	string
`phone_number`	string	E.164, e.g. +15551234567
`external_id`	string
`profiles`	array of object
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Add or remove Klaviyo list members

POST/tools/klaviyo_list_membership MCP tool klaviyo_list_membership Changes data

Add profiles to a list or remove them (up to 100; consent unchanged). Without confirm=true it only returns a preview.

Field	Type	About
`action` required	add \| remove
`list_id` required	string
`profile_ids` required	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Create a Klaviyo list

POST/tools/klaviyo_create_list MCP tool klaviyo_create_list Changes data

Create a list. Without confirm=true it only returns a preview.

Field	Type	About
`name` required	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Change Klaviyo tags

POST/tools/klaviyo_update_tags MCP tool klaviyo_update_tags Changes data

Add or remove tags on campaigns, flows, lists or segments (missing tags are made). Without confirm=true it only returns a preview.

Field	Type	About
`target_type` required	campaign \| flow \| list \| segment
`target_ids` required	array of string
`add`	array of string
`remove`	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Record a Klaviyo event

POST/tools/klaviyo_create_event MCP tool klaviyo_create_event Changes data

Record a custom event on a person's profile (for example a Metric Sensei conversion such as 'Booked call'), which Klaviyo flows and segments can use. Without confirm=true it only returns a preview.

Field	Type	About
`metric_name` required	string
`email`	string
`phone_number`	string	E.164, e.g. +15551234567
`external_id`	string
`properties`	object
`value`	number
`time`	string	ISO 8601
`unique_id`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Create a Klaviyo draft campaign

POST/tools/klaviyo_create_draft_campaign MCP tool klaviyo_create_draft_campaign Changes data

Create an email campaign as a draft for chosen lists or segments (subject, preview text, sender). It is never sent from here: a person adds the content and sends or schedules it in Klaviyo. Without confirm=true it only returns a preview.

Field	Type	About
`name` required	string
`subject` required	string
`audience_ids` required	array of string
`preview_text`	string
`excluded_audience_ids`	array of string
`from_email`	string
`from_label`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo: list live events

POST/tools/klaviyo_list_live_events MCP tool klaviyo_list_live_events Read only

List events Klaviyo pushed to Metric Sensei by webhook (click, open, subscribe, unsubscribe, bounce, sms), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use klaviyo_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. click.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo: get a live event

POST/tools/klaviyo_get_live_event MCP tool klaviyo_get_live_event Read only

One live event from Klaviyo with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo: live events status

POST/tools/klaviyo_live_events_status MCP tool klaviyo_live_events_status Read only

Whether live events (webhooks) from Klaviyo are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Klaviyo: setup checks

POST/tools/klaviyo_setup_checks MCP tool klaviyo_setup_checks Read only

Whether everything on the Klaviyo side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Klaviyo connection to use. Optional when the client has one, or a default.

Mailchimp

23 tools5 change data Tools for a client's Mailchimp connections (mailchimp_...).

Mailchimp: list live events

POST/tools/mailchimp_list_live_events MCP tool mailchimp_list_live_events Read only

List events Mailchimp pushed to Metric Sensei by webhook (subscribe, unsubscribe, profile, upemail, cleaned, campaign), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use mailchimp_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. subscribe.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp: get a live event

POST/tools/mailchimp_get_live_event MCP tool mailchimp_get_live_event Read only

One live event from Mailchimp with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp: live events status

POST/tools/mailchimp_live_events_status MCP tool mailchimp_live_events_status Read only

Whether live events (webhooks) from Mailchimp are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp account

POST/tools/mailchimp_account_info MCP tool mailchimp_account_info Read only

The Mailchimp account: name, plan, contact, time zone, total subscribers, data center.

Field	Type	About
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp audiences

POST/tools/mailchimp_list_audiences MCP tool mailchimp_list_audiences Read only

Audiences (lists) with members, unsubscribes, cleaned, campaigns, and average open and click rates (fractions).

Field	Type	About
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp campaigns

POST/tools/mailchimp_list_campaigns MCP tool mailchimp_list_campaigns Read only

Campaigns, newest first, with audience, subject, status, send time, tracking settings and a short report. Filter by status, type, audience or send date.

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`status`	save \| paused \| schedule \| sending \| sent
`type`	regular \| plaintext \| absplit \| rss \| variate
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp campaign performance

POST/tools/mailchimp_campaign_performance MCP tool mailchimp_campaign_performance Read only

Results of sent campaigns as rows (recipients, delivered, opens, unique opens, open rate, clicks, unique clicks, click rate, unsubscribes, bounces, spam complaints, orders, revenue) plus totals. Same row shape as other email platforms. One campaign with campaign_id, else every campaign sent in the date range (default last 90 days), optionally for one audience.

Field	Type	About
`campaign_id`	string
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`type`	regular \| plaintext \| absplit \| rss \| variate
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp email activity over time

POST/tools/mailchimp_campaign_timeseries MCP tool mailchimp_campaign_timeseries Read only

One audience's daily email activity: sent, unique opens, unique clicks, rates, bounces, subscribes and unsubscribes (Mailchimp keeps the last 180 days).

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`date_range`	today \| yesterday \| last_7_days \| last_30_days \| last_90_days \| this_month \| last_month \| this_year \| last_year
`start_date`	string	YYYY-MM-DD; use instead of date_range.
`end_date`	string	YYYY-MM-DD (inclusive).
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp campaign link clicks

POST/tools/mailchimp_campaign_clicks MCP tool mailchimp_campaign_clicks Read only

Clicks per link in one sent campaign.

Field	Type	About
`campaign_id` required	string
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp audience growth

POST/tools/mailchimp_audience_growth MCP tool mailchimp_audience_growth Read only

One audience's size and growth per month (subscribed, unsubscribed, cleaned, imports).

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`months`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Search Mailchimp subscribers

POST/tools/mailchimp_search_subscribers MCP tool mailchimp_search_subscribers Read only

Find subscribers by email or name across audiences (query), or list one audience's members filtered by status, last change or unique_email_id (Mailchimp's mc_eid).

Field	Type	About
`query`	string	Email or name.
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`status`	subscribed \| unsubscribed \| cleaned \| pending \| transactional \| archived
`changed_since`	string	ISO 8601, e.g. 2026-11-01T00:00:00Z
`unique_email_id`	string
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Get Mailchimp subscriber

POST/tools/mailchimp_get_subscriber MCP tool mailchimp_get_subscriber Read only

One subscriber of an audience: status, merge fields, tags, location, stats, and with include_activity their recent opens, clicks and other activity.

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`email_address`	string	The subscriber's email address.
`subscriber_hash`	string	Mailchimp's subscriber hash (MD5 of the lower-case email); use instead of email_address.
`include_activity`	boolean
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp segments

POST/tools/mailchimp_list_segments MCP tool mailchimp_list_segments Read only

An audience's segments (saved, static, fuzzy) and their sizes.

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`type`	saved \| static \| fuzzy
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp tags

POST/tools/mailchimp_list_tags MCP tool mailchimp_list_tags Read only

An audience's tags, optionally those starting with name.

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`name`	string
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp automations

POST/tools/mailchimp_list_automations MCP tool mailchimp_list_automations Read only

Classic automations with their audience, status, emails sent and results so far.

Field	Type	About
`status`	save \| paused \| sending
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp ecommerce stores

POST/tools/mailchimp_list_stores MCP tool mailchimp_list_stores Read only

Ecommerce stores connected to Mailchimp (Shopify, WooCommerce ...) and the audience each one feeds. Campaign revenue needs one.

Field	Type	About
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

List Mailchimp store orders

POST/tools/mailchimp_list_orders MCP tool mailchimp_list_orders Read only

One connected store's orders, newest first, with the campaign that drove each one. Filter by campaign_id or customer_id.

Field	Type	About
`store_id` required	string
`campaign_id`	string
`customer_id`	string
`count`	integer
`offset`	integer
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Add or update Mailchimp subscriber

POST/tools/mailchimp_upsert_subscriber MCP tool mailchimp_upsert_subscriber Changes data

Add a subscriber to an audience, or update one: status, merge fields (e.g. FNAME, LNAME), language. New people get status_if_new (default subscribed; use pending to send a confirmation email). Returns a preview unless confirm=true.

Field	Type	About
`email_address` required	string	The subscriber's email address.
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`status_if_new`	subscribed \| unsubscribed \| pending \| transactional
`status`	subscribed \| unsubscribed \| pending \| transactional
`merge_fields`	object
`language`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Tag Mailchimp subscriber

POST/tools/mailchimp_update_tags MCP tool mailchimp_update_tags Changes data

Add and/or remove tags on one subscriber. Returns a preview unless confirm=true.

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`email_address`	string	The subscriber's email address.
`subscriber_hash`	string	Mailchimp's subscriber hash (MD5 of the lower-case email); use instead of email_address.
`add`	array of string
`remove`	array of string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Unsubscribe Mailchimp subscriber

POST/tools/mailchimp_unsubscribe MCP tool mailchimp_unsubscribe Changes data

Unsubscribe one subscriber, or with archive=true archive them (removed from the audience, can be added back later). Never deletes permanently. Returns a preview unless confirm=true.

Field	Type	About
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`email_address`	string	The subscriber's email address.
`subscriber_hash`	string	Mailchimp's subscriber hash (MD5 of the lower-case email); use instead of email_address.
`archive`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Create Mailchimp draft campaign

POST/tools/mailchimp_create_draft_campaign MCP tool mailchimp_create_draft_campaign Changes data

Create a draft regular campaign for an audience (optionally one saved segment) with optional HTML or plain-text content. Nothing is sent; review and send it in Mailchimp. Returns a preview unless confirm=true.

Field	Type	About
`subject_line` required	string
`from_name` required	string
`reply_to` required	string
`list_id`	string	Audience (list) ID. See mailchimp_list_audiences.
`segment_id`	string
`preview_text`	string
`title`	string
`html`	string
`plain_text`	string
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Send Mailchimp test email

POST/tools/mailchimp_send_test MCP tool mailchimp_send_test Changes data

Send a test of a campaign to 1 to 5 addresses. Returns a preview unless confirm=true.

Field	Type	About
`campaign_id` required	string
`test_emails` required	array of string
`send_type`	html \| plaintext
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Mailchimp: setup checks

POST/tools/mailchimp_setup_checks MCP tool mailchimp_setup_checks Read only

Whether everything on the Mailchimp side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Mailchimp connection to use. Optional when the client has one, or a default.

Gorgias

28 tools5 change data Tools for a client's Gorgias connections (gorgias_...).

Get Gorgias account info

POST/tools/gorgias_account_info MCP tool gorgias_account_info Read only

The Gorgias account (address, status, business hours), who signed in and how.

Field	Type	About
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias tickets

POST/tools/gorgias_list_tickets MCP tool gorgias_list_tickets Read only

Support tickets created (or with by=updated, updated) in a date range (default last 30 days), newest first: subject, status, priority, channel, customer, assignee, team, tags, times. Filter by status (open/closed), channel (email, chat, sms, phone, facebook ...), tag, priority, assignee_user_id, assignee_team_id, customer_id, view_id or text in subject/customer. Up to max_rows (default 100, at most 1000); continue with next_cursor.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`by`	created \| updated
`status`	open \| closed
`priority`	critical \| high \| normal \| low
`channel`	string
`tag`	string	A tag name.
`assignee_user_id`	string	Gorgias ID (digits).
`assignee_team_id`	string	Gorgias ID (digits).
`customer_id`	string	Gorgias ID (digits).
`view_id`	string	Gorgias ID (digits).
`search`	string	Text in the subject, excerpt or customer.
`max_rows`	integer	Most rows to return.
`cursor`	string	next_cursor from the previous call, to continue.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Get a Gorgias ticket

POST/tools/gorgias_get_ticket MCP tool gorgias_get_ticket Read only

One ticket with its messages (customer and agent messages, internal notes) and custom fields. messages=false leaves the conversation out.

Field	Type	About
`ticket_id` required	string	Gorgias ID (digits).
`messages`	boolean
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias messages

POST/tools/gorgias_list_messages MCP tool gorgias_list_messages Read only

A ticket's messages (ticket_id), or the account's messages in a date range (default last 7 days), newest first; from_agent=true for agent replies only, false for customer messages only.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`ticket_id`	string	Gorgias ID (digits).
`from_agent`	boolean
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Summarize Gorgias tickets

POST/tools/gorgias_ticket_summary MCP tool gorgias_ticket_summary Read only

Tickets created in a date range (default last 30 days) counted per day and by status, channel, tag, team and assignee, with the median hours to close.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Search Gorgias customers

POST/tools/gorgias_search_customers MCP tool gorgias_search_customers Read only

Customers by exact email or external ID, or the most recently updated ones (optionally filtered by text in name/email).

Field	Type	About
`email`	string
`external_id`	string
`search`	string
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Get a Gorgias customer

POST/tools/gorgias_get_customer MCP tool gorgias_get_customer Read only

One customer: contact channels, notes, data, and orders from stores linked in Gorgias (Shopify, BigCommerce, Magento). tickets=true adds their 20 latest tickets.

Field	Type	About
`customer_id` required	string	Gorgias ID (digits).
`tickets`	boolean
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias satisfaction surveys

POST/tools/gorgias_list_satisfaction_surveys MCP tool gorgias_list_satisfaction_surveys Read only

Customer satisfaction (CSAT) surveys scored in a date range (default last 30 days), or one ticket's: score 1-5 and comment, with the average and the share scoring 4-5. Filter by min_score / max_score; scored_only=false includes unanswered surveys.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`ticket_id`	string	Gorgias ID (digits).
`min_score`	integer
`max_score`	integer
`scored_only`	boolean
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Get Gorgias support statistics

POST/tools/gorgias_support_stats MCP tool gorgias_support_stats Read only

One of Gorgias's statistics for a date range (default last 30 days): overview, total-tickets-created/-replied/-closed, median-first-response-time, median-resolution-time, first-response-time, resolution-time, support-volume, tickets-created-per-channel(-per-day), tickets-per-tag, tickets-closed-per-agent(-per-day), messages-sent-per-macro, satisfaction-surveys, revenue-overview, revenue-per-agent/-per-day/-per-ticket ... Filter by agents (user IDs), channels, tags (tag IDs), integrations, score.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`statistic`	overview \| total-tickets-created \| total-tickets-replied \| total-tickets-closed \| total-messages-sent \| total-messages-received \| median-first-response-time \| median-resolution-time \| total-one-touch-tickets \| support-volume \| resolution-time \| first-response-time \| tickets-created-per-hour-per-weekday \| tickets-per-tag \| tickets-created-per-channel \| tickets-created-per-channel-per-day \| tickets-closed-per-agent \| tickets-closed-per-agent-per-day \| messages-sent-per-macro \| satisfaction-surveys \| latest-satisfaction-surveys \| revenue-overview \| revenue-per-agent \| revenue-per-day \| revenue-per-ticket
`agents`	array of string
`channels`	array of string
`tags`	array of string
`integrations`	array of string
`score`	array of integer
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Gorgias support overview

POST/tools/gorgias_support_overview MCP tool gorgias_support_overview Read only

Headline support numbers for a date range (default last 30 days): tickets created and closed, median first response and resolution times in seconds, surveys scored, average score and CSAT (share scoring 4-5). Used by the Analytics Support panel.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Query Gorgias reporting

POST/tools/gorgias_reporting_query MCP tool gorgias_reporting_query Read only

Advanced: a query on Gorgias's newer reporting API by scope (e.g. ai-agent-csat), measures, dimensions and filters ({member, operator, values}), optionally per hour/day/week/month. Prefer gorgias_support_stats unless a scope is only here.

Field	Type	About
`scope` required	string
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`measures`	array of string
`dimensions`	array of string
`filters`	array of object
`granularity`	hour \| day \| week \| month
`timezone`	string
`max_rows`	integer
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias users

POST/tools/gorgias_list_users MCP tool gorgias_list_users Read only

The account's agents and admins: IDs, names, emails, roles.

Field	Type	About
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias teams

POST/tools/gorgias_list_teams MCP tool gorgias_list_teams Read only

The account's teams and their members.

Field	Type	About
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias tags

POST/tools/gorgias_list_tags MCP tool gorgias_list_tags Read only

The account's ticket tags with how often each is used.

Field	Type	About
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias views

POST/tools/gorgias_list_views MCP tool gorgias_list_views Read only

The helpdesk's ticket views (saved filters such as Unassigned or VIP).

Field	Type	About
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List a Gorgias view's tickets

POST/tools/gorgias_view_tickets MCP tool gorgias_view_tickets Read only

The tickets currently in one view, as the helpdesk shows them.

Field	Type	About
`view_id` required	string	Gorgias ID (digits).
`max_rows`	integer	Most rows to return.
`cursor`	string	next_cursor from the previous call, to continue.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias macros

POST/tools/gorgias_list_macros MCP tool gorgias_list_macros Read only

Saved replies (macros) with their intent and how often they are used.

Field	Type	About
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

List Gorgias voice calls

POST/tools/gorgias_list_voice_calls MCP tool gorgias_list_voice_calls Read only

Phone calls handled in Gorgias Voice in a date range (default last 30 days), or one ticket's: direction, status, numbers, duration, agent.

Field	Type	About
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD
`ticket_id`	string	Gorgias ID (digits).
`max_rows`	integer	Most rows to return.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Get a Gorgias voice call

POST/tools/gorgias_get_voice_call MCP tool gorgias_get_voice_call Read only

One voice call.

Field	Type	About
`call_id` required	string	Gorgias ID (digits).
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Add a Gorgias internal note

POST/tools/gorgias_add_note MCP tool gorgias_add_note Changes data

Add an internal note to a ticket (agents see it, the customer never does), from the signed-in user or user_id. Without confirm=true it only returns a preview.

Field	Type	About
`ticket_id` required	string	Gorgias ID (digits).
`body` required	string
`user_id`	string	Gorgias ID (digits).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Reply to a Gorgias customer

POST/tools/gorgias_reply MCP tool gorgias_reply Changes data

Send a reply THE CUSTOMER WILL SEE on the ticket's channel (email, chat, SMS, Messenger, Instagram, WhatsApp), to the address of their latest message, from the signed-in user or user_id; close_ticket=true closes it after. Without confirm=true it only returns a preview (recipient, channel, text): show it to the user first.

Field	Type	About
`ticket_id` required	string	Gorgias ID (digits).
`body` required	string
`user_id`	string	Gorgias ID (digits).
`close_ticket`	boolean
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Update a Gorgias ticket

POST/tools/gorgias_update_ticket MCP tool gorgias_update_ticket Changes data

Change a ticket's status (open/closed), priority, assignee_user_id or assignee_team_id (empty to unassign), subject or snooze_until (YYYY-MM-DD, empty to wake). Without confirm=true it only returns a preview.

Field	Type	About
`ticket_id` required	string	Gorgias ID (digits).
`status`	open \| closed
`priority`	critical \| high \| normal \| low
`assignee_user_id`	string or null
`assignee_team_id`	string or null
`subject`	string
`snooze_until`	string or null
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Add or remove Gorgias ticket tags

POST/tools/gorgias_update_ticket_tags MCP tool gorgias_update_ticket_tags Changes data

Add tags to a ticket (new names are created) or remove them. Without confirm=true it only returns a preview.

Field	Type	About
`ticket_id` required	string	Gorgias ID (digits).
`tags` required	array of string
`action`	add \| remove
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Update a Gorgias customer

POST/tools/gorgias_update_customer MCP tool gorgias_update_customer Changes data

Change a customer's name, firstname, lastname, email, language, timezone, note or external_id. Without confirm=true it only returns a preview.

Field	Type	About
`customer_id` required	string	Gorgias ID (digits).
`values` required	object	Field -> new value.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Gorgias: list live events

POST/tools/gorgias_list_live_events MCP tool gorgias_list_live_events Read only

List events Gorgias pushed to Metric Sensei by webhook (ticket-created, ticket-message-created, ticket-status-updated), newest first, without payloads. Filter by event_type, date range or text; page with cursor. Use gorgias_get_live_event for one event's full payload.

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`event_type`	string	Only this type, e.g. ticket-created.
`search`	string	Text to look for in the event summary.
`limit`	integer
`order`	desc \| asc
`cursor`	string	next_cursor from the previous page.
`include_tests`	boolean
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Gorgias: get a live event

POST/tools/gorgias_get_live_event MCP tool gorgias_get_live_event Read only

One live event from Gorgias with its full payload and any details fetched afterwards.

Field	Type	About
`event_id` required	string	From the list tool.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Gorgias: live events status

POST/tools/gorgias_live_events_status MCP tool gorgias_live_events_status Read only

Whether live events (webhooks) from Gorgias are on for this data source, what is subscribed, when the last event came, and counts by type and day (last 7 days by default).

Field	Type	About
`start_date`	string	YYYY-MM-DD or ISO 8601 (default: 30 days ago).
`end_date`	string	YYYY-MM-DD or ISO 8601 (default: now).
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Gorgias: setup checks

POST/tools/gorgias_setup_checks MCP tool gorgias_setup_checks Read only

Whether everything on the Gorgias side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Gorgias connection to use. Optional when the client has one, or a default.

Google AdSense

22 tools5 change data Tools for a client's Google AdSense connections (adsense_...).

List AdSense accounts

POST/tools/adsense_list_accounts MCP tool adsense_list_accounts Read only

List the AdSense accounts this connection can see, with their state and time zone.

Field	Type	About
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Get AdSense account

POST/tools/adsense_get_account MCP tool adsense_get_account Read only

One AdSense account: name, state (READY, NEEDS_ATTENTION, CLOSED), time zone and the tasks Google is waiting on.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

AdSense earnings overview

POST/tools/adsense_overview MCP tool adsense_overview Read only

Earnings at a glance: estimated earnings, page views, page RPM, impressions and clicks for a period (default the last 7 days up to today), the top-earning pages, today / yesterday / this month, and the number of open alerts and policy issues. Pass domain for one website.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD. Defaults to today.
`date_range`	TODAY \| YESTERDAY \| MONTH_TO_DATE \| YEAR_TO_DATE \| LAST_7_DAYS \| LAST_30_DAYS	Instead of start/end dates.
`domain`	string	Only this website, e.g. 'example.com' (www. included).
`top`	integer
`include_recent`	boolean
`currency_code`	string	Report currency, e.g. USD.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Run an AdSense report

POST/tools/adsense_run_report MCP tool adsense_run_report Read only

AdSense earnings report: metrics such as ESTIMATED_EARNINGS, PAGE_VIEWS, PAGE_VIEWS_RPM, IMPRESSIONS, CLICKS, PAGE_VIEWS_CTR, COST_PER_CLICK, AD_REQUESTS_COVERAGE, ACTIVE_VIEW_VIEWABILITY grouped by dimensions such as DATE, PAGE_URL, DOMAIN_NAME, AD_UNIT_NAME, COUNTRY_NAME, PLATFORM_TYPE_NAME or CUSTOM_CHANNEL_NAME. Days are in the account's time zone; today's earnings are estimates. Defaults to the last 28 days by date.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD. Defaults to today.
`date_range`	TODAY \| YESTERDAY \| MONTH_TO_DATE \| YEAR_TO_DATE \| LAST_7_DAYS \| LAST_30_DAYS	Instead of start/end dates.
`dimensions`	array of string	e.g. ['DATE']
`metrics`	array of string
`filters`	array of object	All must match, e.g. [{'dimension': 'COUNTRY_CODE', 'value': ['US', 'CA']}]. operator: == (default), !=, =@ (contains), !@.
`domain`	string	Only this website, e.g. 'example.com' (www. included).
`order_by`	string	Field to sort by; '-' first for descending.
`limit`	integer
`currency_code`	string	Report currency, e.g. USD.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List saved AdSense reports

POST/tools/adsense_list_saved_reports MCP tool adsense_list_saved_reports Read only

List the reports saved in the AdSense account.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Run a saved AdSense report

POST/tools/adsense_run_saved_report MCP tool adsense_run_saved_report Read only

Run one saved AdSense report (adsense_list_saved_reports shows them) over a date range.

Field	Type	About
`report_id` required	string
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD. Defaults to today.
`date_range`	TODAY \| YESTERDAY \| MONTH_TO_DATE \| YEAR_TO_DATE \| LAST_7_DAYS \| LAST_30_DAYS	Instead of start/end dates.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense sites

POST/tools/adsense_list_sites MCP tool adsense_list_sites Read only

List the account's websites with their state (REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION) and whether Auto ads are on.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Check ads.txt

POST/tools/adsense_check_ads_txt MCP tool adsense_check_ads_txt Read only

Fetch each of the account's sites' public ads.txt and check it has Google's line (google.com, pub-..., DIRECT, f08c47fec0942fa0). Without it Google limits the ads it serves. Pass domain to check one site.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`domain`	string	Only this website, e.g. 'example.com' (www. included).
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense ad clients

POST/tools/adsense_list_ad_clients MCP tool adsense_list_ad_clients Read only

List the account's ad clients (one per product; AFC is AdSense for Content).

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense ad units

POST/tools/adsense_list_ad_units MCP tool adsense_list_ad_units Read only

List the ad units of an ad client with their type, size and state.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Get AdSense ad code

POST/tools/adsense_get_ad_code MCP tool adsense_get_ad_code Read only

The HTML code to place one ad unit, or without ad_unit_id the site-wide Auto ads code.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`ad_unit_id`	string
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense custom channels

POST/tools/adsense_list_custom_channels MCP tool adsense_list_custom_channels Read only

List the ad client's custom channels (groups of ad units used in reports).

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense URL channels

POST/tools/adsense_list_url_channels MCP tool adsense_list_url_channels Read only

List the ad client's URL channels (pages or sections tracked in reports).

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense payments

POST/tools/adsense_list_payments MCP tool adsense_list_payments Read only

Past payments and the current unpaid balance (the entry with unpaid=true).

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense alerts

POST/tools/adsense_list_alerts MCP tool adsense_list_alerts Read only

Google's alerts for the account: ads.txt problems, payment holds, policy notices and more.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

List AdSense policy issues

POST/tools/adsense_list_policy_issues MCP tool adsense_list_policy_issues Read only

Open policy issues: the site or page, what Google did (warned, restricted or disabled ads) and the dates. Fixes are made on the site, then a review is requested in AdSense.

Field	Type	About
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Create AdSense ad unit

POST/tools/adsense_create_ad_unit MCP tool adsense_create_ad_unit Changes data

Create an ad unit (type DISPLAY by default). Google allows this only for AdSense for Platforms accounts.

Field	Type	About
`name` required	string
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`type`	DISPLAY \| FEED \| ARTICLE \| MATCHED_CONTENT \| LINK
`size`	string	e.g. '300x250'.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Update AdSense ad unit

POST/tools/adsense_update_ad_unit MCP tool adsense_update_ad_unit Changes data

Rename an ad unit or set it ACTIVE or ARCHIVED. Archiving stops its ads and returns a preview unless confirm=true. Google allows this only for AdSense for Platforms accounts.

Field	Type	About
`ad_unit_id` required	string
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`name`	string
`state`	ACTIVE \| ARCHIVED
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Create AdSense custom channel

POST/tools/adsense_create_custom_channel MCP tool adsense_create_custom_channel Changes data

Create a custom channel for grouping ad units in reports. Google allows this only for AdSense for Platforms accounts.

Field	Type	About
`name` required	string
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Rename AdSense custom channel

POST/tools/adsense_update_custom_channel MCP tool adsense_update_custom_channel Changes data

Rename a custom channel. Google allows this only for AdSense for Platforms accounts.

Field	Type	About
`channel_id` required	string
`name` required	string
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Delete AdSense custom channel

POST/tools/adsense_delete_custom_channel MCP tool adsense_delete_custom_channel Changes data

Delete a custom channel (its ad units keep running). Returns a preview unless confirm=true. Google allows this only for AdSense for Platforms accounts.

Field	Type	About
`channel_id` required	string
`account_id`	string	AdSense account, e.g. 'pub-1234567890123456'. Defaults to the connection's.
`ad_client_id`	string	Ad client, e.g. 'ca-pub-1234567890123456'. Defaults to the account's AdSense for Content one.
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Google AdSense: setup checks

POST/tools/adsense_setup_checks MCP tool adsense_setup_checks Read only

Whether everything on the Google AdSense side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google AdSense connection to use. Optional when the client has one, or a default.

Google Data Manager

8 tools4 change data Tools for a client's Google Data Manager connections (datamanager_...).

List Google Ads audiences

POST/tools/datamanager_list_audiences MCP tool datamanager_list_audiences Read only

List a Google Ads account's audiences (user lists) with status, membership length, size and Customer Match match rate. Set only_customer_match for lists of emails and phones only.

Field	Type	About
`customer_id`	string	Google Ads account ID, e.g. 123-456-7890 (default: connection's).
`only_customer_match`	boolean
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Get a Google Ads audience

POST/tools/datamanager_get_audience MCP tool datamanager_get_audience Read only

Get one audience's details, size and match rate.

Field	Type	About
`audience_id` required	string	Audience (user list) ID from list_audiences.
`customer_id`	string	Google Ads account ID, e.g. 123-456-7890 (default: connection's).
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Check a Data Manager upload

POST/tools/datamanager_get_upload_status MCP tool datamanager_get_upload_status Read only

How an audience or conversion upload went: processing, success, partial success or failed, with record counts, errors by reason and the match-rate range. Uploads usually finish within a few hours.

Field	Type	About
`request_id` required	string
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Create a Customer Match audience

POST/tools/datamanager_create_audience MCP tool datamanager_create_audience Changes data

Create a Customer Match audience (emails and phone numbers) in a Google Ads account. Needs confirm=true.

Field	Type	About
`name` required	string
`customer_id`	string	Google Ads account ID, e.g. 123-456-7890 (default: connection's).
`description`	string
`membership_days`	integer
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Add people to a Customer Match audience

POST/tools/datamanager_add_audience_members MCP tool datamanager_add_audience_members Changes data

Add up to 10000 people (email and/or phone, plain or SHA-256 hashed) to an audience. Plain values are normalized and hashed before they leave Metric Sensei. Needs the connection's customer_match_terms set to 'accepted', and confirm=true.

Field	Type	About
`audience_id` required	string	Audience (user list) ID from list_audiences.
`people` required	array of object
`customer_id`	string	Google Ads account ID, e.g. 123-456-7890 (default: connection's).
`ad_user_data`	granted \| denied	Consent to use their data.
`ad_personalization`	granted \| denied
`validate_only`	boolean	Google checks the request without saving anything.
`default_country_code`	string	Calling code for phones without one (default 1).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Remove people from a Customer Match audience

POST/tools/datamanager_remove_audience_members MCP tool datamanager_remove_audience_members Changes data

Remove up to 10000 people (email and/or phone) from an audience. Needs confirm=true.

Field	Type	About
`audience_id` required	string	Audience (user list) ID from list_audiences.
`people` required	array of object
`customer_id`	string	Google Ads account ID, e.g. 123-456-7890 (default: connection's).
`validate_only`	boolean	Google checks the request without saving anything.
`default_country_code`	string	Calling code for phones without one (default 1).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Send offline conversions to Google Ads

POST/tools/datamanager_send_conversions MCP tool datamanager_send_conversions Changes data

Send up to 2000 offline conversions (a sale, a qualified lead) to a Google Ads conversion action. Each needs a time and a gclid, gbraid, wbraid, email or phone; a transaction_id stops Google counting it twice. Needs confirm=true.

Field	Type	About
`conversion_action_id` required	string	The conversion action's ID.
`conversions` required	array of object
`customer_id`	string	Google Ads account ID, e.g. 123-456-7890 (default: connection's).
`validate_only`	boolean	Google checks the request without saving anything.
`default_country_code`	string	Calling code for phones without one (default 1).
`confirm`	boolean	Set to true only after the user has seen the preview and agreed. Without it nothing changes.
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Google Data Manager: setup checks

POST/tools/datamanager_setup_checks MCP tool datamanager_setup_checks Read only

Whether everything on the Google Data Manager side is set up so Metric Sensei features work (settings, permissions, tags), from the last daily check. Each check says which features it affects and, when it fails, the steps to fix it. Use it to explain missing data or to walk someone through a fix.

Field	Type	About
`problems_only`	boolean	Only checks that need attention.
`connection`	string	Which Google Data Manager connection to use. Optional when the client has one, or a default.

Analytics

30 tools3 change data Answered by Metric Sensei Analytics while it is turned on for the client; no connection needed. Everyone in the client can read; tools that change something are for the client's admins.

List analytics websites

POST/tools/analytics_list_sites MCP tool analytics_list_sites Read only

The client's websites with Analytics on: site_id, domain, time zone, goals, funnels, linked sources.

Website traffic overview

POST/tools/analytics_report MCP tool analytics_report Read only

Visitors, visits, page views, views per visit, bounce rate and visit duration for a website, compared with the period before, plus a series by day (or by hour for one day).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`data`	ours \| ga4 \| blended	ours (our tag), ga4 (GA4's numbers, same shape) or blended (best estimate of real traffic from both: GA4 divided by the share of our visits GA4 also measured, never below the higher count). ga4 and blended need GA4 linked to the website. Leave it out for the default: the person's saved choice (the Analytics screen's Numbers switch), else blended when GA4 is linked, else ours; the answer's data says which.

Website traffic breakdown

POST/tools/analytics_breakdown MCP tool analytics_breakdown Read only

Visits, page views, bounce rate and duration by one dimension (channel, source, campaign, page, country, device ...). Source, medium, campaign, term and content use the client's tag rules unless raw is true.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`dimension` required	channel \| source \| medium \| campaign \| content \| term \| source_medium \| page \| entry_page \| referrer \| click_id \| country \| region \| city \| device \| browser \| os \| language \| hostname
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`data`	ours \| ga4 \| blended	ours (our tag), ga4 (GA4's numbers, same shape) or blended (best estimate of real traffic from both: GA4 divided by the share of our visits GA4 also measured, never below the higher count). ga4 and blended need GA4 linked to the website. Leave it out for the default: the person's saved choice (the Analytics screen's Numbers switch), else blended when GA4 is linked, else ours; the answer's data says which.
`raw`	boolean	Original source/medium values, before the client's tag rules
`limit`	integer
`q`	string	Only values containing this text

Website events

POST/tools/analytics_events MCP tool analytics_events Read only

Each event (custom, outbound links, downloads, form submits, 404s): times, visits with it, conversion rate; per event its text parameter values (properties), number parameters with count, sum and average (numbers) and GA4-style items with events, quantity and revenue (items).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.

Website goals

POST/tools/analytics_goals MCP tool analytics_goals Read only

Each goal set on the website: conversions (visits) and conversion rate. With data=ga4 or blended, goals are matched with GA4 key events (the goal's ga4_event, or an event of the same name).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`data`	ours \| ga4 \| blended	ours (our tag), ga4 (GA4's numbers, same shape) or blended (best estimate of real traffic from both: GA4 divided by the share of our visits GA4 also measured, never below the higher count). ga4 and blended need GA4 linked to the website. Leave it out for the default: the person's saved choice (the Analytics screen's Numbers switch), else blended when GA4 is linked, else ours; the answer's data says which.

Realtime

POST/tools/analytics_live MCP tool analytics_live Read only

Who is on the website right now (like GA4's Realtime): visitors in the last N minutes (default 30) and last 5 minutes (last_30_minutes and last_5_minutes stay for older callers), visitors, page views and conversions per minute, top pages, channels, sources, campaigns, countries, devices, events and goals, and a feed of recent activity. Source, medium, campaign and channel use the client's tag rules unless raw=true. Nothing in the answer identifies a person.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`minutes`	integer
`raw`	boolean	Show source, medium and campaign as recorded

Website funnel

POST/tools/analytics_funnel MCP tool analytics_funnel Read only

How many visits reached each step in order (pages or events), with drop-off. Give steps, or the name of a saved funnel. May answer {status: running, query_id}: call again with query_id.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`funnel`	string
`steps`	array of object	[{"type": "page", "path": "/pricing"}, {"type": "event", "event": "Signup"}]
`query_id`	string

Website standard report

POST/tools/analytics_standard_report MCP tool analytics_standard_report Read only

One of the standard reports: overview, channels, seo or ecommerce (traffic, sources, pages, goals, and the linked sources' panels when a person asks), ad_lift (the same as analytics_ad_lift, saved settings) or attribution (for websites that run Attribution: people, devices and households, recovered visitors, form submits by channel, source and page, visits after an ad click).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`report` required	overview \| channels \| seo \| ecommerce \| ad_lift \| attribution
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`data`	ours \| ga4 \| blended	ours (our tag), ga4 (GA4's numbers, same shape) or blended (best estimate of real traffic from both: GA4 divided by the share of our visits GA4 also measured, never below the higher count). ga4 and blended need GA4 linked to the website. Leave it out for the default: the person's saved choice (the Analytics screen's Numbers switch), else blended when GA4 is linked, else ours; the answer's data says which.

GA4 numbers for a website

POST/tools/analytics_ga4 MCP tool analytics_ga4 Read only

GA4's users, sessions, views, bounce rate, key events and revenue for the website's linked GA4 property (copied nightly), by day and by channel, page, landing page, country, device and event.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.

Website audience (GA4)

POST/tools/analytics_audience MCP tool analytics_audience Read only

GA4-only breakdowns for the website: new vs returning, age, gender, interests, first-visit channel, Google Ads campaigns and keywords, ecommerce items. Needs GA4 linked; demographics need Google signals.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Website data check (ours vs GA4)

POST/tools/analytics_data_check MCP tool analytics_data_check Read only

How our tag's visits and GA4's sessions agree day by day, the share of visits GA4 measures, and problems: GA4 or our tag not recording, pages only GA4 sees, possible bot traffic. Needs GA4 linked.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Ad-driven lift (direct, organic and branded search)

POST/tools/analytics_ad_lift MCP tool analytics_ad_lift Read only

How much direct traffic, organic-search traffic and branded searching the client's ads brought (people who saw an ad, then typed the address or searched), by ad channel (Google Ads YouTube, Display/Demand Gen/PMax, Search; Meta; MNTN TV) and by campaign: extra visits and searches, share, cost per extra visit, confidence, compared with an earlier period; also before/during/after each flight and TV hour spikes. Visits are the website's Analytics numbers; branded searches come from Search Console, Google Ads and Microsoft Advertising. If the answer has retry, call again in about 20 seconds with retry's ms_ads_report_id. A correlation, not proof.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`outcomes`	array of direct \| organic_search \| brand_searches_google \| brand_searches_google_ads \| brand_searches_microsoft
`brand_terms`	array of string	Default: saved or suggested
`exclude_terms`	array of string
`ads_customer_id`	string
`meta_ad_account_id`	string	act_123... (needed for Meta Ads)
`mntn_advertiser_id`	string
`ms_ads_account_id`	string
`ms_ads_report_id`	string	From an earlier answer's retry, while Microsoft builds
`site_url`	string	Search Console property, when there are several
`include_hourly`	boolean
`baseline_days`	integer
`after_days`	integer
`ads_connection`	string	Which connection to use, when the client has several.
`meta_connection`	string	Which connection to use, when the client has several.
`mntn_connection`	string	Which connection to use, when the client has several.
`gsc_connection`	string	Which connection to use, when the client has several.
`ms_ads_connection`	string	Which connection to use, when the client has several.

Website revenue

POST/tools/analytics_revenue MCP tool analytics_revenue Read only

Revenue from events, and linked orders, calls and leads (Attribution) with ad spend and ROAS, by channel, source_medium, campaign, entry_page or event.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`by`	channel \| source_medium \| campaign \| entry_page \| event
`raw`	boolean

Website speed (Core Web Vitals)

POST/tools/analytics_vitals MCP tool analytics_vitals Read only

75th percentile LCP, INP, CLS, FCP and TTFB from real visitors, for the site and its busiest pages.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Visitor retention cohorts

POST/tools/analytics_cohorts MCP tool analytics_cohorts Read only

Visitors by week (or month) of first visit and the share who came back in each later period.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`unit`	week \| month

Page paths

POST/tools/analytics_paths MCP tool analytics_paths Read only

The pages viewed right after (or before) a page.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`page` required	string
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`direction`	next \| previous

Click heatmap

POST/tools/analytics_heatmap MCP tool analytics_heatmap Read only

A page's clicks by position (sampled visits) and its most clicked elements.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`page` required	string
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`device`	\| Desktop \| Mobile \| Tablet

Scroll depth

POST/tools/analytics_scroll MCP tool analytics_scroll Read only

How far down a page its views reached (each 10%).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`page` required	string
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Website segment

POST/tools/analytics_segment MCP tool analytics_segment Read only

Numbers for visits matching filters (or a saved segment), optionally split by one field.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`segment`	string
`filters`	array of object	[{"field": "page", "op": "is", "value": "/pricing"}]
`breakdown`	string

Traffic alerts

POST/tools/analytics_alerts MCP tool analytics_alerts Read only

The website's traffic spike and drop alerts of the last 30 days.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them

List A/B tests

POST/tools/analytics_list_experiments MCP tool analytics_list_experiments Read only

The website's A/B tests (add-on) and their status, optionally only those made by one service.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`source_service`	string

A/B test results

POST/tools/analytics_experiment_results MCP tool analytics_experiment_results Read only

Visitors, conversions and conversion rate per variant, uplift, probability to beat control, winner and whether there's enough data yet.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`experiment_id` required	string
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

AI crawler visits

POST/tools/analytics_crawlers MCP tool analytics_crawlers Read only

Crawler and AI agent visits to the website from its server logs, by crawler and kind and by page.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Visitor timeline

POST/tools/analytics_person MCP tool analytics_person Read only

One visitor's page views and events (browser ID from Attribution's Look up).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`visitor_id` required	string
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Visitor lifecycle

POST/tools/analytics_lifecycle MCP tool analytics_lifecycle Read only

Weekly new, returning, resurrected and dormant visitors.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Visitor stickiness

POST/tools/analytics_stickiness MCP tool analytics_stickiness Read only

How many days a week visitors come back.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Save an A/B test (draft)

POST/tools/analytics_save_experiment MCP tool analytics_save_experiment Changes data

Create or update an A/B test on a website as a draft (or stop one). People start tests on the Analytics page. Variants after the control may change elements' text or attributes, or add CSS.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`name` required	string
`variants` required	array of object
`goal` required	object
`experiment_id`	string
`page`	string
`hypothesis`	string
`traffic_pct`	integer
`status`	draft \| stopped
`source`	object

Smart events

POST/tools/analytics_smart_events MCP tool analytics_smart_events Read only

A website's smart events: the rules tracked now (with their counts and a warning when one stopped matching), the suggestions waiting for review (what, where, why, an estimated count from data already collected, and whether it should be a goal), the latest discovery run, and the client's event goals. Rules go live when a person approves a suggestion on the Analytics page or through the Admin API.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Find smart events

POST/tools/analytics_discover_events MCP tool analytics_discover_events Changes data

Look at the website's pages and the clicks, forms and pages already measured, and suggest key events to track for the client's goals (Claude ranks and names them). Runs in the background for up to a minute; analytics_smart_events shows the suggestions. Counts as one Analytics AI run. Give goals (primary: leads, calls, sales, bookings, signups, content or brand; notes) to save the client's event goals first.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`goals`	object

Suggest a smart event

POST/tools/analytics_suggest_smart_event MCP tool analytics_suggest_smart_event Changes data

Draft one smart event for a person to approve (it is not tracked until then). rule: {name, type: click|submit|page|visible, selector?, link?: tel|mailto|sms|whatsapp, href?, text?, form?, path?, pages?}. Rules can't watch form fields. goal true suggests making it a website goal.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); analytics_list_sites lists them
`rule` required	object
`why`	string
`goal`	boolean

Website Optimizer

10 tools3 change data Answered by Metric Sensei Website Optimizer while it is turned on for the client; no connection needed. Everyone in the client can read; tools that change something are for the client's admins.

List optimized websites

POST/tools/optimizer_list_sites MCP tool optimizer_list_sites Read only

The client's websites in Website Optimizer: site_id, address, goals (and whether they are set), last check with scores, and counts of open recommendations.

Get an optimized website

POST/tools/optimizer_get_site MCP tool optimizer_get_site Read only

One website's goals, watched pages, settings (competitors, digest, alerts) and its last check.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them

List website recommendations

POST/tools/optimizer_list_recommendations MCP tool optimizer_list_recommendations Read only

Recommendations for a website, highest priority first: title, plain-English summary, why it matters for the website's goals, steps, impact, effort, evidence, pages, status, and whether it can be fixed in one click. Filter by status (new, accepted, in_progress, done, fixed, dismissed; default: open ones) or category (speed, seo, social, structured_data, accessibility, conversion, behaviour, technical, ai_visibility, competitors, crawl, shopping).

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them
`status`	string	open (default: new, accepted, in progress), all, or one
`category`	speed \| seo \| social \| structured_data \| accessibility \| conversion \| behaviour \| technical \| ai_visibility \| competitors \| crawl \| shopping
`limit`	integer

Get a website optimization report

POST/tools/optimizer_get_report MCP tool optimizer_get_report Read only

The one-page report: plain-English summary, scores now vs about 30 days ago (speed, accessibility, SEO, social tags, structured data), the top 5 actions for the goals, what got fixed, alerts, competitor comparison (from the SEO service when it is on) and the measured effect of past fixes.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them

Website score history

POST/tools/optimizer_score_history MCP tool optimizer_score_history Read only

Daily scores (speed, accessibility, best practices, SEO, social tags, structured data) for a website or one page, up to 25 months back.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them
`page`	string	A watched page's URL; default the whole site
`days`	integer

Website page audit

POST/tools/optimizer_page_audit MCP tool optimizer_page_audit Read only

The latest audit of one watched page: speed scores and Core Web Vitals, SEO tags, Open Graph and social tags with share previews, JSON-LD blocks and their problems.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them
`page` required	string	A watched page's URL

Website alerts

POST/tools/optimizer_list_alerts MCP tool optimizer_list_alerts Read only

Recent alerts for a website: down, SSL certificate expiring, score drop, a page dropped from Google's index, broken form page.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them
`days`	integer
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Set website goals

POST/tools/optimizer_set_goals MCP tool optimizer_set_goals Changes data

Set what the website is for. Recommendations are ranked by these goals from the next check on.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them
`goals` required	object	What the website is for. Recommendations are ranked by it.

Update a website recommendation

POST/tools/optimizer_update_recommendation MCP tool optimizer_update_recommendation Changes data

Change a recommendation's status: accepted, in_progress, done (the next check confirms the fix) or dismissed (give a reason); new reopens it.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them
`recommendation_id` required	string
`status` required	new \| accepted \| in_progress \| done \| dismissed
`reason`	string	Why it was dismissed (max 500)

Check a website now

POST/tools/optimizer_run_check MCP tool optimizer_run_check Changes data

Run the website's check now instead of waiting for the daily one (at most once an hour per website). Results arrive in a few minutes: then list recommendations again.

Field	Type	About
`site_id` required	string	The website (MS-XXXXXXXX); optimizer_list_sites lists them

SEO

59 tools16 change data Answered by Metric Sensei SEO while it is turned on for the client; no connection needed. Everyone in the client can read; tools that change something are for the client's admins.

List SEO projects

POST/tools/seo_list_projects MCP tool seo_list_projects Read only

The client's SEO projects: project_id, domain, market, devices, competitors, linked sources.

Get an SEO project

POST/tools/seo_get_project MCP tool seo_get_project Read only

One project's settings.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

SEO overview

POST/tools/seo_overview MCP tool seo_overview Read only

One project at a glance: visibility and positions, trend, latest site audit, backlinks, local grid, AI visibility and recent alerts. The shared date parameters pick the trend's days (default the last 90) and, with compare, add trend_previous and the change in average visibility, traffic and position.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.

Create an SEO project

POST/tools/seo_create_project MCP tool seo_create_project Changes data

Start tracking a website: domain, name, location_code, language_code, device (desktop, mobile, both), competitors (up to 5 domains), business {name, lat, lng} for local SEO.

Field	Type	About
`domain` required	string
`name`	string
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`device`	desktop \| mobile \| both
`competitors`	array of string
`business`	object

Change an SEO project

POST/tools/seo_update_project MCP tool seo_update_project Changes data

Change a project's settings (only those given): name, market, device, extra locations, competitors, business, linked sources, crawl, alerts, report schedule, brand, ai_prompts.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`settings` required	object

Delete an SEO project

POST/tools/seo_delete_project MCP tool seo_delete_project Changes data

Delete a project and all its data (tracked keywords stop being billed).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Tracked keywords

POST/tools/seo_list_keywords MCP tool seo_list_keywords Read only

Tracked keywords with volume, difficulty and latest position per device/market (position, previous, URL, SERP features, competitors' positions). Filter by tag or text q.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`tag`	string
`q`	string
`limit`	integer

Track keywords

POST/tools/seo_track_keywords MCP tool seo_track_keywords Changes data

Add keywords to daily rank tracking (billed per keyword per month, per device and market).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keywords` required	array of string
`tags`	array of string

Stop tracking keywords

POST/tools/seo_untrack_keywords MCP tool seo_untrack_keywords Changes data

Remove keywords (by keywords or keyword_ids) and their history.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keywords`	array of string
`keyword_ids`	array of string

Tag keywords

POST/tools/seo_tag_keywords MCP tool seo_tag_keywords Changes data

Replace tracked keywords' tags.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keyword_ids` required	array of string
`tags` required	array of string

Keyword position history

POST/tools/seo_keyword_history MCP tool seo_keyword_history Read only

Daily positions of one tracked keyword (by keyword or keyword_id).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keyword`	string
`keyword_id`	string
`days`	integer
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`device`	string
`location_code`	integer

Stored top 10

POST/tools/seo_serp_snapshot MCP tool seo_serp_snapshot Read only

The top 10 results stored with a tracked keyword's daily check (latest day by default).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keyword`	string
`keyword_id`	string
`day`	string

Rank tracking summary

POST/tools/seo_rank_summary MCP tool seo_rank_summary Read only

Visibility (0-100), estimated traffic, average position, top 3/10/20/100 counts, movers and share of voice against competitors, per device/market.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Visibility trend

POST/tools/seo_rank_trend MCP tool seo_rank_trend Read only

Daily visibility, traffic, average position and top-10 counts. With compare: an object with trend, trend_previous, period, compare_period and the change in the averages.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`days`	integer
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.

Keyword metrics

POST/tools/seo_keyword_overview MCP tool seo_keyword_overview Read only

Search volume, CPC, competition, difficulty (0-100), intent and 12-month trend for up to 700 keywords. Billed as one lookup.

Field	Type	About
`keywords` required	array of string
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Keyword ideas

POST/tools/seo_keyword_ideas MCP tool seo_keyword_ideas Read only

Keyword ideas for a seed: kind ideas, suggestions (contain the seed), related or questions; filter by min_volume and max_difficulty. Billed as one lookup.

Field	Type	About
`seed` required	string
`kind`	ideas \| suggestions \| related \| questions
`min_volume`	integer
`max_difficulty`	integer
`limit`	integer
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Live search results

POST/tools/seo_serp MCP tool seo_serp Read only

Google's results page for a keyword now: organic results, SERP features, and where the project's domain ranks. Billed as one lookup.

Field	Type	About
`keyword` required	string
`device`	desktop \| mobile
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Domain overview

POST/tools/seo_domain_overview MCP tool seo_domain_overview Read only

Organic keywords, estimated traffic and top-3/top-10 counts of domains (default: the project and its competitors). Billed as one lookup.

Field	Type	About
`domains`	array of string
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Keywords a domain ranks for

POST/tools/seo_ranked_keywords MCP tool seo_ranked_keywords Read only

A domain's organic keywords with positions, URLs and estimated traffic. Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`limit`	integer
`max_position`	integer
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Find competitors

POST/tools/seo_find_competitors MCP tool seo_find_competitors Read only

Domains competing for the same searches (shared keywords, average position, traffic). Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`limit`	integer
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Keyword gap

POST/tools/seo_keyword_gap MCP tool seo_keyword_gap Read only

Keywords against one competitor: missing (they rank, you don't), weak (you rank lower), strong, or shared. Billed as one lookup.

Field	Type	About
`competitor` required	string
`kind`	missing \| weak \| strong \| shared
`domain`	string	A domain (default: the project's)
`limit`	integer
`location_code`	integer	DataForSEO location code (2840 = United States); default the project's
`language_code`	string	e.g. en; default the project's
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Backlink profile

POST/tools/seo_backlinks_summary MCP tool seo_backlinks_summary Read only

Authority Score (0-100), backlinks, referring domains, dofollow/nofollow, broken links and spam score. Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Backlinks

POST/tools/seo_backlinks MCP tool seo_backlinks Read only

Backlinks, strongest first (one per domain by default); dofollow_only, lost or toxic_only. Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`limit`	integer
`offset`	integer
`one_per_domain`	boolean
`dofollow_only`	boolean
`lost`	boolean
`toxic_only`	boolean
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Referring domains

POST/tools/seo_referring_domains MCP tool seo_referring_domains Read only

Domains linking to the site with their Authority Score. Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`limit`	integer
`offset`	integer
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Anchor texts

POST/tools/seo_anchors MCP tool seo_anchors Read only

Most used anchor texts. Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`limit`	integer
`project_id`	string	The SEO project (one website); seo_list_projects lists them

New and lost links

POST/tools/seo_new_lost_links MCP tool seo_new_lost_links Read only

New and lost backlinks and referring domains per week. Billed as one lookup.

Field	Type	About
`domain`	string	A domain (default: the project's)
`days`	integer
`project_id`	string	The SEO project (one website); seo_list_projects lists them

Backlink gap

POST/tools/seo_backlink_gap MCP tool seo_backlink_gap Read only

Domains linking to the project's competitors but not to it (link-building ideas). Billed as one lookup.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`competitors`	array of string
`limit`	integer

Disavow file

POST/tools/seo_disavow_file MCP tool seo_disavow_file Read only

A Google disavow file for the given domains and URLs.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`domains`	array of string
`urls`	array of string

Site audits

POST/tools/seo_list_audits MCP tool seo_list_audits Read only

The project's site audits, newest first.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Site audit results

POST/tools/seo_audit MCP tool seo_audit Read only

An audit (latest finished by default): health score, errors/warnings/notices, every issue with examples, and changes since the previous audit.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`audit_id`	string

Start a site audit

POST/tools/seo_start_audit MCP tool seo_start_audit Changes data

Crawl the project's site now (up to its crawl.max_pages; billed per crawled page). Results in a few minutes.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Audit issue pages

POST/tools/seo_audit_issue MCP tool seo_audit_issue Read only

One issue (rule) with the pages that have it.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`rule` required	string
`audit_id`	string
`limit`	integer

Crawled pages

POST/tools/seo_audit_pages MCP tool seo_audit_pages Read only

Crawled pages (url, status, title, depth, inlinks, words, issues); filter by rule, status or q.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`rule`	string
`status`	integer
`q`	string
`offset`	integer
`limit`	integer
`audit_id`	string

Crawled page

POST/tools/seo_audit_page MCP tool seo_audit_page Read only

Everything recorded for one crawled page.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`url` required	string
`audit_id`	string

Crawl summary

POST/tools/seo_crawl_summary MCP tool seo_crawl_summary Read only

The latest site audit's numbers and top issues plus every crawled page as a short row (for Website Optimizer and AI apps). No crawl is started.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`limit`	integer

Competitor snapshot

POST/tools/seo_competitors MCP tool seo_competitors Read only

The project's competitors: monthly snapshot (organic keywords, traffic, Authority Score) and share of voice from rank tracking. No lookup is billed.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Run a local rank grid

POST/tools/seo_run_local_grid MCP tool seo_run_local_grid Changes data

Google Maps ranks of the business at size x size points (3, 5, 7, 9) spacing_km apart, for up to 10 keywords: average rank, top-3 share, competitors. Billed per point.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keywords` required	array of string
`size`	3 \| 5 \| 7 \| 9
`spacing_km`	number

Local grid runs

POST/tools/seo_local_grids MCP tool seo_local_grids Read only

Recent local grid runs.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Local grid run

POST/tools/seo_local_grid MCP tool seo_local_grid Read only

One grid run with every point.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`grid_id` required	string

Business Profile numbers

POST/tools/seo_local_profile MCP tool seo_local_profile Read only

The linked Business Profile's views, calls, direction requests, reviews and search terms (needs a person).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Write a content brief

POST/tools/seo_content_brief MCP tool seo_content_brief Changes data

A writing brief for a keyword from the top results: title ideas, outline, terms, questions, length, schema, internal links. Uses AI Services (billed there).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keyword` required	string

Grade content

POST/tools/seo_grade_content MCP tool seo_grade_content Changes data

Score a page (url) or draft (text) for a keyword (0-100): length, keyword placement, term coverage, readability and three suggestions. Uses AI Services.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`keyword` required	string
`url`	string
`text`	string
`brief_id`	string

Content briefs

POST/tools/seo_list_briefs MCP tool seo_list_briefs Read only

Briefs and grades, newest first.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Content brief

POST/tools/seo_get_brief MCP tool seo_get_brief Read only

One brief or grade.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`brief_id` required	string

Search Console insights

POST/tools/seo_search_console MCP tool seo_search_console Read only

From the linked Search Console property: top queries, striking-distance queries (position 4-20), cannibalisation, tracked keywords' real clicks and tracking suggestions; with a linked Bing Webmaster site also Bing's top queries, striking distance and tracked keywords' Bing clicks under bing (needs a person).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`days`	integer
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).

Paid and organic overlap

POST/tools/seo_paid_overlap MCP tool seo_paid_overlap Read only

Google Ads search terms with spend where the site already ranks top 3 organically (needs a person).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`days`	integer

Organic landing pages

POST/tools/seo_organic_pages MCP tool seo_organic_pages Read only

Analytics' SEO report for the linked website: organic entry pages and conversions (needs a person).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

AI search visibility

POST/tools/seo_ai_visibility MCP tool seo_ai_visibility Read only

AI Overviews that show and cite the site (from rank tracking), the latest check of AI assistant answers for the project's prompts, AI crawler readiness, and history.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Check AI answers now

POST/tools/seo_check_ai_visibility MCP tool seo_check_ai_visibility Changes data

Ask AI assistants the project's prompts (or the given ones) and record brand mentions and citations. Each prompt is billed as one lookup.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`prompts`	array of string

SEO alerts

POST/tools/seo_alerts MCP tool seo_alerts Read only

Recent alerts: rank drops, top-10 losses, health drops, lost links.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`limit`	integer

SEO report PDF

POST/tools/seo_report_pdf MCP tool seo_report_pdf Changes data

Make the project's PDF report now; returns a 15-minute download link.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Link prospects

POST/tools/seo_prospects MCP tool seo_prospects Read only

The outreach list (filter by status).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`status`	string

Add link prospects

POST/tools/seo_add_prospects MCP tool seo_add_prospects Changes data

Add prospect domains to the outreach list.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`domains` required	array of string

Prospects from the backlink gap

POST/tools/seo_prospects_from_gap MCP tool seo_prospects_from_gap Changes data

Add the backlink gap's domains (min_authority and up) as prospects. Billed as one lookup.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`min_authority`	integer
`limit`	integer

Update a link prospect

POST/tools/seo_update_prospect MCP tool seo_update_prospect Changes data

Change a prospect's status (new, contacted, replied, won, lost, ignored), email, notes or link_page.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`domain` required	string
`status`	string
`email`	string
`notes`	string
`link_page`	string

Remove a link prospect

POST/tools/seo_remove_prospect MCP tool seo_remove_prospect Changes data

Delete a prospect.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`domain` required	string

Verify a prospect's link

POST/tools/seo_verify_prospect MCP tool seo_verify_prospect Read only

Check the prospect's link_page links to the site (marks it won when found).

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`domain` required	string

Log-file analyses

POST/tools/seo_log_analyses MCP tool seo_log_analyses Read only

Past server log analyses.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them

Log-file analysis

POST/tools/seo_log_analysis MCP tool seo_log_analysis Read only

Crawl budget from a server log: hits per bot (Googlebot, Bingbot, AI crawlers), status codes, wasted crawls, pages Googlebot never fetched.

Field	Type	About
`project_id` required	string	The SEO project (one website); seo_list_projects lists them
`log_id` required	string

Network Monitoring

26 tools2 change data Answered by Metric Sensei Network Monitoring while it is turned on for the client; no connection needed. Everyone in the client can read; tools that change something are for the client's admins.

Network status

POST/tools/nms_status MCP tool nms_status Read only

Devices and cloud monitors by status (up, down, degraded, unknown), open alarms by severity, unacknowledged alarms, collectors healthy/total, locations. Optional location_id and/or group_id.

Field	Type	About
`location_id`	string	A location (nms_list_locations lists them)
`group_id`	string	A device group (nms_list_groups lists them)

Device groups

POST/tools/nms_list_groups MCP tool nms_list_groups Read only

Device groups (each can hold devices from any location): hand-picked devices and the rule that adds more, current members, how many are down, members per location.

Locations

POST/tools/nms_list_locations MCP tool nms_list_locations Read only

The client's locations with the networks (address ranges) each covers and its discovery ranges.

Collectors

POST/tools/nms_list_collectors MCP tool nms_list_collectors Read only

On-site collectors: location, health, last heartbeat, version, region, queue.

Devices

POST/tools/nms_list_devices MCP tool nms_list_devices Read only

Monitored devices with status, device groups and where each is checked from (checked_from: our cloud for public addresses by default, the location's collector for private ones or when chosen); filter by location_id, group_id or status (up, down, degraded, unknown).

Field	Type	About
`location_id`	string	A location (nms_list_locations lists them)
`group_id`	string	A device group (nms_list_groups lists them)
`status`	up \| down \| degraded \| unknown

Device details

POST/tools/nms_get_device MCP tool nms_get_device Read only

One device: checks and their state, open alarms, available metrics.

Field	Type	About
`node_id` required	string

Discovered devices

POST/tools/nms_list_found MCP tool nms_list_found Read only

Devices discovery found that wait to be added or ignored.

Cloud monitors

POST/tools/nms_list_monitors MCP tool nms_list_monitors Read only

Website and endpoint monitors checked from the cloud (automatic ones for websites and data sources, and the client's own), with status.

Data source endpoints

POST/tools/nms_shared_status MCP tool nms_shared_status Read only

Status of the shared API endpoints of the client's data sources (e.g. Google, Meta), checked once for all clients from both regions.

Alarms

POST/tools/nms_list_alarms MCP tool nms_list_alarms Read only

Open alarms, worst first (all=true adds recently cleared ones). Filter by location_id, group_id or min_severity.

Field	Type	About
`location_id`	string	A location (nms_list_locations lists them)
`group_id`	string	A device group (nms_list_groups lists them)
`min_severity`	critical \| major \| minor \| warning \| normal
`all`	boolean
`limit`	integer

Events

POST/tools/nms_list_events MCP tool nms_list_events Read only

One day's events (UTC yyyy-mm-dd, default today).

Field	Type	About
`day`	string
`limit`	integer

Outages and availability

POST/tools/nms_list_outages MCP tool nms_list_outages Read only

Outages in a period (unix seconds since/until, or the shared date parameters as UTC days; default the last 30 days) and availability % per device or monitor; optional target or group_id. With compare also previous_availability per target.

Field	Type	About
`since`	integer
`until`	integer
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`target`	string
`group_id`	string	A device group (nms_list_groups lists them)

Metric over time

POST/tools/nms_metric_series MCP tool nms_metric_series Read only

One metric of a device or monitor (e.g. icmp.ms, cpu.pct, if.Gi1_0_1.in_bps) between start and end (unix seconds; default the last 24 hours). Full detail up to 48 hours, hourly avg/min/max beyond.

Field	Type	About
`target` required	string
`metric` required	string
`start`	integer
`end`	integer

Maintenance windows

POST/tools/nms_list_maintenance MCP tool nms_list_maintenance Read only

Maintenance windows and whether each is on now.

NMS settings

POST/tools/nms_get_settings MCP tool nms_get_settings Read only

Automatic monitoring of websites and data sources, retention.

Network overview

POST/tools/nms_topology MCP tool nms_topology Read only

The network gear (switches, routers, firewalls, access points), how it connects (LLDP/CDP) with status, and a connection list (device, port, port description, other end). Optional location_id.

Field	Type	About
`location_id`	string	A location (nms_list_locations lists them)

Site map

POST/tools/nms_site_map MCP tool nms_site_map Read only

Every device on one map, each on the switch port it is plugged into (from the switches' MAC tables), plus the devices that couldn't be placed. Optional location_id.

Field	Type	About
`location_id`	string	A location (nms_list_locations lists them)

Connected devices

POST/tools/nms_connected_devices MCP tool nms_connected_devices Read only

Everything seen on the network: MAC, IP, VLAN, switch and port, and whether it is monitored. unmonitored=true for only those not monitored yet. Optional location_id.

Field	Type	About
`location_id`	string	A location (nms_list_locations lists them)
`unmonitored`	boolean

UniFi controllers

POST/tools/nms_list_unifi MCP tool nms_list_unifi Read only

Connected UniFi controllers.

Top talkers

POST/tools/nms_flows_top MCP tool nms_flows_top Read only

From NetFlow/IPFIX/sFlow: top conversations, applications (protocol and port), sources and destinations, and bytes per interface, for one exporter (target, a device) or all, start/end unix seconds (default the last hour; over 48 hours needs a target).

Field	Type	About
`target`	string
`start`	integer
`end`	integer
`limit`	integer

Availability report

POST/tools/nms_availability_report MCP tool nms_availability_report Read only

One month's availability per device and monitor (month yyyy-mm, default last month; or any days with the shared date parameters), worst first, with outages and downtime; optional location_id or group_id. With compare each row adds previous availability and change_points (percentage points).

Field	Type	About
`month`	string
`range`	string	Date range: today, yesterday, this_week, last_week, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, last_12_months, or custom (with start and end). Whole days in the report's time zone; 'last N days' ends yesterday.
`start`	string	First day for range=custom (yyyy-mm-dd).
`end`	string	Last day for range=custom (yyyy-mm-dd, included).
`compare`	string or boolean	Compare with: none, previous (the period just before; calendar ranges compare the same days of the month/quarter/year before), year (same dates a year earlier) or custom (compare_start/compare_end).
`compare_start`	string	First compared day for compare=custom (yyyy-mm-dd).
`compare_end`	string	Last compared day for compare=custom (yyyy-mm-dd).
`match_weekday`	boolean	Line compared days up by day of the week.
`location_id`	string	A location (nms_list_locations lists them)
`group_id`	string	A device group (nms_list_groups lists them)

Alarm context (root cause)

POST/tools/nms_alarm_context MCP tool nms_alarm_context Read only

Everything around one alarm for finding its cause: the alarm, its device and checks, its neighbours on the map and their status, alarms at the same location within 30 minutes, the device's events that day, maintenance on now, and key measurements over the last 6 hours. Use it to explain an alarm's likely root cause.

Field	Type	About
`alarm_id` required	string	An alarm (nms_list_alarms lists them)

Trap and syslog rules

POST/tools/nms_list_event_rules MCP tool nms_list_event_rules Read only

The client's rules that turn traps and syslog lines into alarms or events (or ignore them).

Thresholds

POST/tools/nms_list_thresholds MCP tool nms_list_thresholds Read only

Limits on device measurements (e.g. cpu.pct > 90 for 3 readings) that raise alarms.

Acknowledge an alarm

POST/tools/nms_acknowledge_alarm MCP tool nms_acknowledge_alarm Changes data

Acknowledge an alarm (stops its escalation); ack=false takes the acknowledgement back.

Field	Type	About
`alarm_id` required	string	An alarm (nms_list_alarms lists them)
`ack`	boolean

Clear an alarm

POST/tools/nms_clear_alarm MCP tool nms_clear_alarm Changes data

Clear an alarm by hand (it is raised again if the problem is still there).

Field	Type	About
`alarm_id` required	string	An alarm (nms_list_alarms lists them)

Attribution

1 tool Answered by Metric Sensei Attribution while it is turned on for the client; no connection needed. Everyone in the client can read; tools that change something are for the client's admins.

Attribution realtime

POST/tools/attribution_realtime MCP tool attribution_realtime Read only

Who is on the client's website right now, as the Attribution tag sees them: active browsers in the last N minutes (default 30) and last 5 minutes, new vs returning, sessions and conversions per minute, top channels, sources, mediums, campaigns, landing pages, paid click IDs (gclid, fbclid...), countries and devices, conversions (form submits and orders the tag reports) and a feed of the latest touches and conversions. Source, medium, campaign and channel use the client's tag rules unless view=original. Nothing in the answer identifies a person.

Field	Type	About
`site_id`	string	The website (MS-XXXXXXXX); default the client's first
`minutes`	integer
`view`	mapped \| original

Offline Conversions

18 tools9 change data Answered by Metric Sensei Offline Conversions while it is turned on for the client; no connection needed. Everyone in the client can read; tools that change something are for the client's admins.

Offline conversions overview

POST/tools/conversions_overview MCP tool conversions_overview Read only

Conversions sent, skipped and failed per day and platform, the value sent, match coverage, active rules and anything that needs attention (failing destinations, paused sending, rules at their daily limit).

Field	Type	About
`days`	integer

What rules can use

POST/tools/conversions_catalog MCP tool conversions_catalog Read only

Event types, fields and operators for conditions, value modes, platforms, and the client's ad connections that can receive conversions.

List conversion rules

POST/tools/conversions_list_rules MCP tool conversions_list_rules Read only

The client's rules (draft, active, paused) with their destinations and last 7 days' counts, and the older mappings from Attribution > Conversions that are still sent.

Get a conversion rule

POST/tools/conversions_get_rule MCP tool conversions_get_rule Read only

One rule and its change history.

Field	Type	About
`rule_id` required	string	The rule (conversions_list_rules lists them)

Preview a conversion rule

POST/tools/conversions_preview_rule MCP tool conversions_preview_rule Read only

Dry run, nothing is sent: run a rule (rule_id, or a draft in rule) over the last days of stored events and show how many would be sent per destination, the total value, how many have something to match on, why the others wouldn't go, and a few sample conversions (hashes only).

Field	Type	About
`rule_id`	string	The rule (conversions_list_rules lists them)
`rule`	object	A conversion rule: {name, description?, trigger: {events: [event type], sources?: [data source name]}, conditions?: {match: all\|any, items: [{field, op, value?}]}, value?: {mode: record\|fixed\|multiply\|none, amount?, min?, max?, currency?}, hold_hours? (0-720), limits?: {daily_sends?, daily_value?}, destinations: [{platform, connection, account_id, action}]}. conversions_catalog lists event types, fields, operators, platforms and the client's connections.
`days`	integer

Save a conversion rule

POST/tools/conversions_save_rule MCP tool conversions_save_rule Changes data

Create a rule (no rule_id) or change one (send the version you read). New rules are drafts; changing an active rule keeps it active. Turning a draft on is done by a person on the admin page or the Admin API.

Field	Type	About
`rule` required	object	A conversion rule: {name, description?, trigger: {events: [event type], sources?: [data source name]}, conditions?: {match: all\|any, items: [{field, op, value?}]}, value?: {mode: record\|fixed\|multiply\|none, amount?, min?, max?, currency?}, hold_hours? (0-720), limits?: {daily_sends?, daily_value?}, destinations: [{platform, connection, account_id, action}]}. conversions_catalog lists event types, fields, operators, platforms and the client's connections.
`rule_id`	string	The rule (conversions_list_rules lists them)
`version`	integer

Pause a conversion rule

POST/tools/conversions_set_rule_status MCP tool conversions_set_rule_status Changes data

Pause a rule (status paused) or move it back to draft. Turning a rule on needs a person on the admin page.

Field	Type	About
`rule_id` required	string	The rule (conversions_list_rules lists them)
`status` required	paused \| draft

Delete a conversion rule

POST/tools/conversions_delete_rule MCP tool conversions_delete_rule Changes data

Delete a rule. Conversions it already sent stay in the log.

Field	Type	About
`rule_id` required	string	The rule (conversions_list_rules lists them)

Conversion send log

POST/tools/conversions_log MCP tool conversions_log Read only

What was sent, skipped (and why) or failed, newest first; filter by status, rule_id or platform.

Field	Type	About
`status`	sent \| skipped \| failed \| held \| test
`rule_id`	string	The rule (conversions_list_rules lists them)
`platform`	string
`limit`	integer
`cursor`	string

Send a failed conversion again

POST/tools/conversions_send_again MCP tool conversions_send_again Changes data

Retry one failed send from the log (its log_id).

Field	Type	About
`log_id` required	string

Send past events

POST/tools/conversions_backfill MCP tool conversions_backfill Changes data

Run active rules over stored events of the last days (at most 90). Events already sent are never sent again. Runs in the background; the log fills as it goes.

Field	Type	About
`rule_id`	string	The rule (conversions_list_rules lists them)
`days`	integer

Conversions change history

POST/tools/conversions_audit MCP tool conversions_audit Read only

Who changed which rule or setting, and when (before and after).

Field	Type	About
`limit`	integer
`cursor`	string

Conversions settings

POST/tools/conversions_settings MCP tool conversions_settings Read only

Sending on or paused for the whole client, daily limits, the Meta test event code, consent handling.

Change conversions settings

POST/tools/conversions_update_settings MCP tool conversions_update_settings Changes data

Change settings (only those given): paused, daily_sends, require_consent, test_event_code.

Field	Type	About
`settings` required	object

Do-not-send list

POST/tools/conversions_list_suppressions MCP tool conversions_list_suppressions Read only

People who asked not to be sent to ad platforms (only hashes are kept).

Field	Type	About
`limit`	integer

Add to the do-not-send list

POST/tools/conversions_add_suppression MCP tool conversions_add_suppression Changes data

Never send conversions for these people again: emails or phones (hashed here, never stored as text), or SHA-256 hashes. reason: opt_out, privacy_request or other.

Field	Type	About
`emails`	array of string
`phones`	array of string
`hashes`	array of string
`reason`	opt_out \| privacy_request \| other

Remove from the do-not-send list

POST/tools/conversions_remove_suppression MCP tool conversions_remove_suppression Changes data

Remove one entry (its hash) from the do-not-send list.

Field	Type	About
`hash` required	string

Suggest conversion rules

POST/tools/conversions_suggest_rules MCP tool conversions_suggest_rules Changes data

The conversions assistant: give the client's goal in plain words (e.g. 'bid for qualified leads worth more than $500'); it studies the client's events and proposes draft rules with previews and its reasoning. Drafts are saved, never turned on. Uses AI Services tokens.

Field	Type	About
`goal` required	string
`save_drafts`	boolean

The API/MCP Gateway, 722 tools. GET /openapi.json (signed in) is the contract for the tools you can use.