Skip to main content

​
[0.4.0] - 2026-07-15

Both MCP servers are updated:
  • standard MCP (/v1/spark-api/mcp)
  • ChatGPT MCP (/v1/spark-api/openai/mcp)

​
Added

  • search_audiences tool for searching saved/platform audiences by free-text query; optional dataset_codes, exclude_audience_ids, and limit (1–100)

​
Changed

  • chat_gwi / search: supports optional dataset_codes to query a root dataset together with one or more of its add-on studies (values must belong to the same dataset tree)
  • chat_gwi / search: supports optional docked_audiences to scope insights to platform audience UUIDs (max 10; use IDs from search_audiences)
  • chat_gwi / search: when both dataset_code and dataset_codes are provided, dataset_codes takes precedence and dataset_code is ignored
  • chat_gwi / search: when both dataset_code and dataset_codes are omitted, the default dataset available to the user is used (previously hard-coded to ds-core)
  • list_datasets: returns hierarchical folders and nested dataset nodes so clients can identify valid root/child combinations
  • explore_insight_gwi / fetch: response now includes the origin datasets of the corresponding insight
  • explore_insight_gwi: attribute output now includes Universe Size alongside question, answer, percentage, sample, and index — the estimated number of real-world internet users within the audience
  • fetch: response now includes structured metadata with an attributes array (question, answer, percentage, sample, universe_size, index) plus timeframe_groups, location_groups, audiences, and datasets for the source insight
  • search and fetch now return typed structured results instead of JSON encoded inside content text blocks; clients that already parse the tool result payload need no changes, but clients reading raw text MAY switch to the structured result

​
[0.3.0] - 2026-07-07

Both MCP servers are updated:
  • standard MCP (/v1/spark-api/mcp)
  • ChatGPT MCP (/v1/spark-api/openai/mcp)

​
Changed

  • chat_gwi / search: supports optional limit to set the maximum number of insights returned per call (1–20; default 10)

​
[0.2.0] - 2026-03-11

​
Added

  • list_datasets tool for listing available GWI datasets; use to discover dataset codes for chat_gwi
  • chat_gwi: optional dataset_code argument to specify which dataset to query; default: ds-core

​
[0.1.0] - 2025-12-01

​
Added

  • chat_gwi tool for gathering insights about audiences based on GWI data
  • explore_insight_gwi for exploring detailed information about the insight statistics
  • OAuth2 support for secure authentication

​
Changed

  • Initial release of the Spark MCP