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

TableJSON 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

TableJSON 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",
-  "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"
+]
  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"
-]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"
+]
  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"
-]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"
+]
  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"
-]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"
+]
  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"
-]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"
+]
  6. 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."
  7. 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"
+}
  8. First observed

TDQS

A4.4/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 safety is covered by structured data. The description adds genuine behavioral context beyond that: it lists the returned flag semantics (`single`, `requires_metric`, `deprecated`, `custom`) and the constraint that a metric/dimension is only valid inside its own `data_view` — a rule an agent could easily violate. It does not discuss pagination or response size, but for a read-only introspection tool this is strong.

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?

Front-loaded with the core purpose, then the payload contents, then the usage pointer last — a sensible order. It is dense and clause-heavy, packing the flag list into one run-on sentence, but every clause carries meaning and nothing is superfluous.

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

Completeness5/5

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

An output schema exists, so return values need not be spelled out, yet the description still previews the shape of the response (views, defaults, catalogs) so the agent knows what to expect. Combined with the read-only annotations, nothing needed to call this correctly is missing.

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

Parameters3/5

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

Schema coverage is 100%, so both parameters are already documented in the schema; the baseline is 3. The description implies that `data_view` scopes the response and that the datasource alias selects the source, but adds no syntax or format detail beyond what the schema already states.

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?

States a specific verb (Describe) and resource (datasource) and then enumerates exactly what the response contains: data views, `advanced` settings, default view, and metric/dimension catalogs with their combinability flags. This clearly separates it from siblings like `datasources` (listing) and `datasource_resources` without requiring schema inspection.

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

Usage Guidelines5/5

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

Explicitly routes the agent: "Use this before add_data_widget or update_data_widget," naming the two downstream tools it feeds. That is a concrete when-to-use signal tied to specific siblings, which is more than most definitions provide.

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