Skip to main content
Glama

Oviond

by com.oviond.api
OverviewDiscussionsAdmin

Describe datasource

describe_datasource
Read-only

Describe a datasource the way the report builder sees it, in one call: its data views, the advanced settings each view requires, its default view and defaults, and its metric and dimension catalogs with the flags that decide what can be combined — single (must be the only dimension), requires_metric (only offered once that metric is picked), deprecated, custom. A metric or dimension is only valid inside its own data_view. Use this before add_data_widget or update_data_widget.

Input Schema

NameRequiredDescriptionDefault
data_viewNoScope the response to one data view, e.g. ACCOUNT
datasource_idYesDatasource alias (from datasources), e.g. ga4, gadw, fb-ads

Output Schema

NameRequiredDescriptionDefault
dataNoThe datasource's data views, and for each one its metrics, its dimensions with their flags, and the advanced settings a query has to supply. A metric is only valid inside its own view — read this before configuring a widget.
successYesTrue when the call succeeded.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "jira",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul",
-  "amplitude",
-  "harvest",
-  "zoho-crm",
-  "clockify",
-  "adtraction",
-  "shopify",
-  "copper",
-  "help-scout-docs",
-  "close-crm",
-  "simplesat",
-  "help-scout-mailbox"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "jira",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude",
+  "harvest",
+  "zoho-crm",
+  "clockify",
+  "adtraction",
+  "shopify",
+  "copper",
+  "help-scout-docs",
+  "close-crm",
+  "simplesat",
+  "help-scout-mailbox"
+]
  2. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul",
-  "amplitude",
-  "harvest",
-  "zoho-crm",
-  "clockify",
-  "adtraction",
-  "shopify",
-  "copper"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "jira",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude",
+  "harvest",
+  "zoho-crm",
+  "clockify",
+  "adtraction",
+  "shopify",
+  "copper",
+  "help-scout-docs",
+  "close-crm",
+  "simplesat",
+  "help-scout-mailbox"
+]
  3. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul",
-  "amplitude",
-  "harvest",
-  "zoho-crm",
-  "clockify",
-  "adtraction",
-  "shopify"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude",
+  "harvest",
+  "zoho-crm",
+  "clockify",
+  "adtraction",
+  "shopify",
+  "copper"
+]
  4. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul",
-  "amplitude",
-  "harvest",
-  "zoho-crm",
-  "clockify",
-  "adtraction"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude",
+  "harvest",
+  "zoho-crm",
+  "clockify",
+  "adtraction",
+  "shopify"
+]
  5. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul",
-  "amplitude",
-  "harvest"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude",
+  "harvest",
+  "zoho-crm",
+  "clockify",
+  "adtraction"
+]
  6. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul",
-  "amplitude"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude",
+  "harvest"
+]
  7. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup",
-  "make",
-  "freshdesk",
-  "chart-mogul"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul",
+  "amplitude"
+]
  8. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex",
-  "clickup"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup",
+  "make",
+  "freshdesk",
+  "chart-mogul"
+]
  9. Changed1 schema field changed
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle",
-  "surnex"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex",
+  "clickup"
+]
  10. Changed4 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • changedInput schema / properties / datasource_id / enum
      Previous value: -[
-  "advanced-web-ranking",
-  "ac",
-  "adroll",
-  "ahrefs",
-  "basecamp",
-  "brightlocal",
-  "call-rail",
-  "drip",
-  "keywords",
-  "sendin-blue",
-  "sendgrid",
-  "moosend",
-  "mailer-lite",
-  "pingdom",
-  "uptime-robot",
-  "piwik-pro",
-  "wordpress",
-  "pabbly-connect",
-  "ment",
-  "twilio",
-  "switchy",
-  "vimeo",
-  "pinterest",
-  "pinterest-ads",
-  "gtres",
-  "paypal",
-  "gps",
-  "gs",
-  "CUSTOM_IMPORT",
-  "CUSTOM_DATA",
-  "CALCULATION",
-  "GOALS",
-  "str",
-  "wistia",
-  "ca-mon",
-  "convertkit",
-  "woocommerce",
-  "xero",
-  "matomo",
-  "go-high-level",
-  "wcs",
-  "bing-webmaster-tools",
-  "pipedrive",
-  "salesforce",
-  "tiktok",
-  "tiktok-ads",
-  "twr",
-  "twr-ads",
-  "spf",
-  "ytbe",
-  "google-local-services-ads",
-  "klaviyo",
-  "gsh",
-  "ga4",
-  "lkdin-ads",
-  "lkdin-pg",
-  "mlchmp",
-  "inst-ads",
-  "inst",
-  "fb-ads",
-  "fb-pg",
-  "gmb",
-  "serpstat",
-  "hubspot",
-  "gadw",
-  "sem-rush",
-  "se-ranking",
-  "microsoft-ads",
-  "plausible",
-  "snapchat-ads",
-  "amazon-advertising",
-  "microsoft-clarity",
-  "serp-watch",
-  "vbout",
-  "moz",
-  "chatgpt-ads",
-  "omnisend",
-  "airtable",
-  "nozzle"
-]New value: +[
+  "advanced-web-ranking",
+  "ac",
+  "adroll",
+  "ahrefs",
+  "basecamp",
+  "brightlocal",
+  "call-rail",
+  "drip",
+  "keywords",
+  "sendin-blue",
+  "sendgrid",
+  "moosend",
+  "mailer-lite",
+  "pingdom",
+  "uptime-robot",
+  "piwik-pro",
+  "wordpress",
+  "pabbly-connect",
+  "ment",
+  "twilio",
+  "switchy",
+  "vimeo",
+  "pinterest",
+  "pinterest-ads",
+  "gtres",
+  "paypal",
+  "gps",
+  "gs",
+  "CUSTOM_IMPORT",
+  "CUSTOM_DATA",
+  "CALCULATION",
+  "GOALS",
+  "str",
+  "wistia",
+  "ca-mon",
+  "convertkit",
+  "woocommerce",
+  "xero",
+  "matomo",
+  "go-high-level",
+  "wcs",
+  "bing-webmaster-tools",
+  "pipedrive",
+  "salesforce",
+  "tiktok",
+  "tiktok-ads",
+  "twr",
+  "twr-ads",
+  "spf",
+  "ytbe",
+  "google-local-services-ads",
+  "klaviyo",
+  "gsh",
+  "ga4",
+  "lkdin-ads",
+  "lkdin-pg",
+  "mlchmp",
+  "inst-ads",
+  "inst",
+  "fb-ads",
+  "fb-pg",
+  "gmb",
+  "serpstat",
+  "hubspot",
+  "gadw",
+  "sem-rush",
+  "se-ranking",
+  "microsoft-ads",
+  "plausible",
+  "snapchat-ads",
+  "amazon-advertising",
+  "microsoft-clarity",
+  "serp-watch",
+  "vbout",
+  "moz",
+  "chatgpt-ads",
+  "omnisend",
+  "airtable",
+  "nozzle",
+  "surnex"
+]
    • removedOutput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • changedOutput schema / properties / success / description
      Previous value: -"True when the call succeeded. A failure comes back as an error result instead."New value: +"True when the call succeeded."
  11. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "data": {
+      "description": "The datasource's data views, and for each one its metrics, its dimensions with their flags, and the advanced settings a query has to supply. A metric is only valid inside its own view — read this before configuring a widget."
+    },
+    "success": {
+      "description": "True when the call succeeded. A failure comes back as an error result instead.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "success"
+  ],
+  "type": "object"
+}
  12. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description adds real behavioral value beyond that: the shape of the response (views, defaults, catalogs) and the critical validity rule that 'a metric or dimension is only valid inside its own `data_view`,' which prevents invalid combinations. It does not mention auth needs or data freshness, keeping it below a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the core action and tightly packed with return-field detail; every clause carries information. The single long clause enumerating flags is dense but justified, and the usage instruction lands last where an agent will see it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description need not describe return values, yet it does so in a way that adds semantic rules (per-data-view validity, flag meanings) rather than restating structure. Combined with the explicit prerequisite for add/update_data_widget, an agent has enough to call and interpret this correctly; only error/empty-result behavior is unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description adds domain meaning the schema cannot: it explains that metrics/dimensions are scoped to a `data_view`, which clarifies why and when to pass the optional `data_view` parameter. The `datasource_id` alias semantics are still left to the schema, so it is above baseline rather than exhaustive.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Describe a datasource') and then enumerates exactly what the call returns — data views, required `advanced` settings, default view/defaults, and metric/dimension catalogs with combination flags. This distinguishes it from the sibling `datasources` (which lists aliases) and `connected_datasources`, so an agent can pick it without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly prescribes when to call it: 'Use this before add_data_widget or update_data_widget,' which names concrete downstream tools and a sequencing rule. It stops short of stating when NOT to use it or contrasting it with `datasources`/`datasource_resources`, so it is clear context without full when/when-not coverage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Oviond toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources