Skip to main content
Glama

Refresh report widgets

refresh_report
Idempotent

Re-fetch every data widget on a report with its current config and the report date range, saving the results. Pass datasource_id to refresh only the widgets fed by one datasource — what you do after linking or unlinking it. Returns immediately; the fetches run in the background — call get_widget_data with source_id set to this report to read the numbers as they land.

Input Schema

NameRequiredDescriptionDefault
report_idYesReport ID (from list_reports)
datasource_idNoOnly widgets fed by this datasource (id from datasources)

Output Schema

NameRequiredDescriptionDefault
dataNoAcknowledgement that the refresh was accepted. The fetches run in the background — read the numbers with get_widget_data as they land.
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. Changed7 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"
      +]
    • removedInput schema / properties / id
      Removed value: -{
      -  "description": "Report ID (from list_reports)",
      -  "type": "string"
      -}
    • addedInput schema / properties / report_id
      Added value: +{
      +  "description": "Report ID (from list_reports)",
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "id"
      -]New value: +[
      +  "report_id"
      +]
    • 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": "Acknowledgement that the refresh was accepted. The fetches run in the background — read the numbers with get_widget_data as they land."
      +    },
      +    "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.4/5.0
Behavior5/5

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

Adds substantially beyond the annotations by disclosing that the call is asynchronous: 'Returns immediately; the fetches run in the background.' It also explains the persistence side effect (results are saved) and the correct follow-up path, telling the agent to call get_widget_data with source_id set to this report. This is exactly the kind of behavior an annotation like idempotentHint cannot convey.

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

Conciseness5/5

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

Three sentences, front-loaded with the core action, then the optional-parameter branch, then the async return behavior and next step. Every sentence carries information the agent needs and nothing is repeated.

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?

For a two-parameter mutation with an output schema present, the description covers the side effect (saving results), the async model, and the correct follow-up tool. An agent has everything needed to invoke it and handle the result correctly without further discovery.

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 both parameters are already documented, but the description still earns credit by adding meaning the schema lacks: datasource_id narrows the refresh to only widgets fed by that datasource, and it is the step to run after link/unlink. report_id receives no additional explanation beyond the schema, keeping this at a 4 rather than 5.

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

Purpose4/5

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

The description opens with a specific verb and resource: 'Re-fetch every data widget on a report with its current config and the report date range, saving the results.' That is far more precise than the title alone. It stops short of 5 because a sibling named refresh_widgets exists and is never mentioned, leaving the agent to infer the difference between the two refresh operations.

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 gives a concrete trigger for the optional parameter: 'Pass datasource_id to refresh only the widgets fed by one datasource — what you do after linking or unlinking it.' That is real when-to-use guidance. It does not address when to choose this over refresh_widgets, and gives no exclusions or prerequisites, so it falls short of fully explicit routing.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources