JSON-RPC response. HTTP 200 means the JSON-RPC call was processed, not that the tool succeeded.
Inspect result.isError if present:
true — tool failed; the message is in result.content[0].text, and result._meta.isInternalError may be true for internal or timeout-style failures.
See Tool errors (result.isError) in the overview above for full behavior.
JSON-RPC 2.0 success envelope for MCP tools/call (no top-level error field).
When the tool fails, HTTP status is still typically 200 and this object is returned with result.isError: true. Use that flag rather than HTTP status alone.
MCP tool result. Inspect isError for tool-level success or failure.
isError: true — the tool failed; content usually has one text item with a human-readable explanation. Typical causes:
Invalid arguments (e.g. empty prompt, invalid UUID for chat_id / insight_id where required).
Downstream errors (e.g. resource not found, timeout, cancelled request, or generic internal failure).
_meta.isInternalError — when present and true, the server classified the failure as internal or timeout-style. Omitted or false for most validation and not-found style errors.
This is not the same as a JSON-RPC protocol error: invalid method or malformed requests use the standard JSON-RPC error field instead of a tool result.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"GWI","colors":{"primary":"#de1a76","light":"#de1a76","dark":"#de1a76"},"logo":{"light":"https://mintcdn.com/gwi-c45e8f9c/lDVzA75IGIMfShVe/assets/logo/light.png?fit=max\u0026auto=format\u0026n=lDVzA75IGIMfShVe\u0026q=85\u0026s=a6bcd3ee7012836c15db595bc15fa6ba","dark":"https://mintcdn.com/gwi-c45e8f9c/lDVzA75IGIMfShVe/assets/logo/image.png?fit=max\u0026auto=format\u0026n=lDVzA75IGIMfShVe\u0026q=85\u0026s=8456c9777f2fba42bbe71ea2b3cc65e3"},"favicon":"https://mintcdn.com/gwi-c45e8f9c/lDVzA75IGIMfShVe/assets/favicon.png?fit=max\u0026auto=format\u0026n=lDVzA75IGIMfShVe\u0026q=85\u0026s=bc00d0ea761fb62c7b6f2faa5fbf85b7","navbar":{"links":[],"primary":{"type":"button","label":"Book demo","href":"https://www.gwi.com/book-demo?hsCtaTracking=7c82d7ee-619d-4733-a627-993ccfc14df4%7C48400de7-7d3e-4ebf-bc0a-ee97f4420759"}},"footer":{"socials":{"x":"https://x.com/gwidotcom","instagram":"https://www.instagram.com/gwidotcom","linkedin":"https://www.linkedin.com/company/gwidotcom"}},"integrations":{},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gwi-c45e8f9c","hasAudioNarration":false,"actualSubdomain":"gwi-c45e8f9c","customDomains":["api.globalwebindex.com"],"gitSource":{"type":"github","owner":"globalwebindex","repo":"api-documentation","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae32027fa750f9207823097","collectionId":"afe0d2b5-d69e-4646-b4c7-aa858913c2eb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae32027fa750f9207823097"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae32027fa750f9207823097","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Platform API","count":117},{"language":"default","tag":"Getting started","count":55},{"language":"default","tag":"Reference","count":53},{"language":"default","tag":"Spark MCP","count":42},{"language":"default","tag":"Integration Guide","count":24},{"language":"default","tag":"Spark API","count":15},{"language":"default","tag":"Quickstarts","count":14},{"language":"default","tag":"Spark in AI assistants","count":12},{"language":"default","tag":"GWI Overview","count":10},{"language":"default","tag":"Audiences","count":9}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@charset \"UTF-8\";@font-face{font-family:'Faktum';src:url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/Faktum-Thin.woff2) format('woff2'),url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/Faktum-Thin.woff) format('woff');font-weight:100;font-style:normal;font-display:fallback}@font-face{font-family:'Faktum';src:url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/Faktum-ThinItalic.woff2) format('woff2'),url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/Faktum-ThinItalic.woff) format('woff');font-weight:100;font-style:italic;font-display:fallback}@font-face{font-family:'Faktum';src:url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/Faktum-ExtraLight.woff2) format('woff2'),url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/Faktum-ExtraLight.woff) format('woff');font-weight:200;font-style:normal;font-display:fallback}@font-face{font-family:'Faktum';src:url(/assets/fonts/Faktum-Bold.woff2) format('woff2'),url(/assets/fonts/Faktum-Bold.woff) format('woff');font-weight:700;font-style:normal;font-display:fallback}@font-face{font-family:'PalmerLake-Print';src:url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/PalmerLake-Print.woff2) format('woff2'),url(https://304927.fs1.hubspotusercontent-na1.net/hubfs/304927/2020_theme/fonts/PalmerLake-Print.woff) format('woff');font-weight:400;font-style:normal;font-display:block}#content h1,#page-title{font-weight:700;font-style:normal}#content h1,#content h2,#content h3,#page-title{font-family:'Faktum',sans-serif}"}],"page":{"pagePath":"spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls","slug":"/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls","pageMetadata":{"openapi":"post /v1/spark-api/mcp","title":"Execute GWI MCP tool calls","description":"This endpoint handles MCP tool calls through JSON-RPC. Supported tools:\n\n**1. chat_gwi** - Query audience insights\n- Returns main response, insights with IDs, sources, and chat ID\n- Use for initial queries and follow-ups\n\n**2. explore_insight_gwi** - Get detailed statistics\n- Returns percentages, sample sizes, and index scores\n- Use with insight IDs from chat_gwi responses\n\n**3. list_datasets** - List available datasets\n- Used to get the dataset codes that can be passed to chat_gwi\n- Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations\n- Returns an empty `datasets` array when the caller has no dataset access\n\n**4. search_audiences** - Search available audiences\n- Returns matching audience entries with IDs, metadata, and dataset availability\n- Supports optional dataset filtering, exclusion IDs, and result limits\n","href":"/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"This endpoint handles MCP tool calls through JSON-RPC. Supported tools:\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"1. chat_gwi\"\n }), \" - Query audience insights\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Returns main response, insights with IDs, sources, and chat ID\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Use for initial queries and follow-ups\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"2. explore_insight_gwi\"\n }), \" - Get detailed statistics\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Returns percentages, sample sizes, and index scores\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Use with insight IDs from chat_gwi responses\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"3. list_datasets\"\n }), \" - List available datasets\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Used to get the dataset codes that can be passed to chat_gwi\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Returns an empty \", _jsx(_components.code, {\n children: \"datasets\"\n }), \" array when the caller has no dataset access\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"4. search_audiences\"\n }), \" - Search available audiences\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Returns matching audience entries with IDs, metadata, and dataset availability\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Supports optional dataset filtering, exclusion IDs, and result limits\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /v1/spark-api/mcp","title":"Execute GWI MCP tool calls","description":"This endpoint handles MCP tool calls through JSON-RPC. Supported tools:\n\n**1. chat_gwi** - Query audience insights\n- Returns main response, insights with IDs, sources, and chat ID\n- Use for initial queries and follow-ups\n\n**2. explore_insight_gwi** - Get detailed statistics\n- Returns percentages, sample sizes, and index scores\n- Use with insight IDs from chat_gwi responses\n\n**3. list_datasets** - List available datasets\n- Used to get the dataset codes that can be passed to chat_gwi\n- Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations\n- Returns an empty `datasets` array when the caller has no dataset access\n\n**4. search_audiences** - Search available audiences\n- Returns matching audience entries with IDs, metadata, and dataset availability\n- Supports optional dataset filtering, exclusion IDs, and result limits\n","href":"/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/gwi-c45e8f9c/7eece02f639a8407/intercom.js"],"openApiReferenceData":{"operation":{"operationId":"mcpToolCall","tags":["MCP Tools"],"summary":"Execute GWI MCP tool calls","description":"This endpoint handles MCP tool calls through JSON-RPC. Supported tools:\n\n**1. chat_gwi** - Query audience insights\n- Returns main response, insights with IDs, sources, and chat ID\n- Use for initial queries and follow-ups\n\n**2. explore_insight_gwi** - Get detailed statistics\n- Returns percentages, sample sizes, and index scores\n- Use with insight IDs from chat_gwi responses\n\n**3. list_datasets** - List available datasets\n- Used to get the dataset codes that can be passed to chat_gwi\n- Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations\n- Returns an empty `datasets` array when the caller has no dataset access\n\n**4. search_audiences** - Search available audiences\n- Returns matching audience entries with IDs, metadata, and dataset availability\n- Supports optional dataset filtering, exclusion IDs, and result limits\n","security":["93c52b1f-6be0-4c96-a6cd-16edf53e44e1"],"requestBody":"c0f13e00-ca8d-41d9-a50c-84fcad9a0dbe","responses":{"200":"91e3d5d2-7f6b-481d-9791-14eb6cfcfc6a","401":"585e01bf-ad42-408b-9cff-bd1e32005a19"},"method":"post","type":"path","servers":["e23d3e22-388e-4866-8485-b39df59caa98"],"path":"/v1/spark-api/mcp","baseUrlOptions":["https://api.globalwebindex.com"],"title":"Execute GWI MCP tool calls","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"chat_gwi","description":"Query audience insights:\n- Returns main response, insights with IDs, sources, and chat ID\n- Use for initial queries and follow-ups\n","required":["jsonrpc","id","method","params"],"example":{"jsonrpc":"2.0","id":"req-123","method":"tools/call","params":{"name":"chat_gwi","arguments":{"prompt":"What marketing channels work best for Audi drivers in the US?"}}},"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"description":"JSON-RPC version","isRequired":true,"uniqueKey":"oneOf.0.jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Unique request identifier","example":"req-123","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"method":{"type":"string","enum":["tools/call"],"description":"Method name for MCP tool calls","isRequired":true,"uniqueKey":"oneOf.0.method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string","enum":["chat_gwi"],"description":"Tool name","isRequired":true,"uniqueKey":"oneOf.0.params.name","typeLabel":"enum\u003cstring>"},"arguments":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","description":"Natural language question about audience behavior, preferences, or market insights. Be specific about the audience, market, or behavior you're interested in.","example":"What marketing channels work best for Audi drivers in the US?","isRequired":true,"uniqueKey":"oneOf.0.params.arguments.prompt","typeLabel":"string"},"chat_id":{"type":"string","description":"Optional. Include this to continue a previous conversation. Must be a valid UUID returned from a previous chat_gwi response; do not fabricate or reformat the value.","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","example":"835aa1f0-cc30-4575-8829-557e03a29f76","uniqueKey":"oneOf.0.params.arguments.chat_id","typeLabel":"string"},"dataset_code":{"type":"string","description":"Optional. Dataset code fetched from list_datasets.\nIgnored when dataset_codes is provided.\n","example":"ds-core","uniqueKey":"oneOf.0.params.arguments.dataset_code","typeLabel":"string"},"dataset_codes":{"type":"array","description":"Optional. Dataset codes fetched from list_datasets.\nThe selected values must belong to the same dataset tree (a root and its children).\nTakes precedence over dataset_code when both are provided.\n","items":{"type":"string","uniqueKey":"oneOf.0.params.arguments.dataset_codes.items.[INDEX]","typeLabel":"string"},"example":["ds-core","ds-work"],"uniqueKey":"oneOf.0.params.arguments.dataset_codes","typeLabel":"string[]"},"limit":{"type":"integer","description":"Optional. Maximum insights to return per query (1-20).\nSet when the user asks for a specific number; omit otherwise.\n","default":10,"minimum":1,"maximum":20,"example":8,"uniqueKey":"oneOf.0.params.arguments.limit","typeLabel":"integer"},"docked_audiences":{"type":"array","description":"Optional. Platform audience UUIDs to scope insights (max 10).\nUse IDs from search_audiences (audiences[].id) or UUIDs the user provided.\nWhen dataset_code or dataset_codes is provided, every audience must be compatible with that dataset.\nMultiple UUIDs must belong to the same dataset tree.\n","items":{"type":"string","format":"uuid","uniqueKey":"oneOf.0.params.arguments.docked_audiences.items.[INDEX]","typeLabel":"string\u003cuuid>"},"maxItems":10,"example":["00000000-0000-0000-0000-000000000001","00000000-0000-0000-0000-000000000002"],"uniqueKey":"oneOf.0.params.arguments.docked_audiences","typeLabel":"string\u003cuuid>[]"}},"isRequired":true,"uniqueKey":"oneOf.0.params.arguments","typeLabel":"object"}},"isRequired":true,"uniqueKey":"oneOf.0.params","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"chat_gwi · object"},{"type":"object","title":"explore_insight_gwi","description":"Get detailed statistics:\n- Returns percentages, sample sizes, and index scores\n- Use with insight IDs from chat_gwi responses\n","required":["jsonrpc","id","method","params"],"example":{"jsonrpc":"2.0","id":"req-456","method":"tools/call","params":{"name":"explore_insight_gwi","arguments":{"insight_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}}},"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"description":"JSON-RPC version","isRequired":true,"uniqueKey":"oneOf.1.jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Unique request identifier","example":"req-456","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"method":{"type":"string","enum":["tools/call"],"description":"Method name for MCP tool calls","isRequired":true,"uniqueKey":"oneOf.1.method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string","enum":["explore_insight_gwi"],"description":"Tool name","isRequired":true,"uniqueKey":"oneOf.1.params.name","typeLabel":"enum\u003cstring>"},"arguments":{"type":"object","required":["insight_id"],"properties":{"insight_id":{"type":"string","description":"The unique identifier of an insight from a chat_gwi response.\nMust be a valid UUID that was returned in a previous chat_gwi call.\n\nThis will return detailed statistics including:\n- Exact percentages for each answer\n- Sample sizes for statistical validity\n- Index scores (comparison to general population)\n","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","isRequired":true,"uniqueKey":"oneOf.1.params.arguments.insight_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.params.arguments","typeLabel":"object"}},"isRequired":true,"uniqueKey":"oneOf.1.params","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"explore_insight_gwi · object"},{"type":"object","title":"list_datasets","description":"List available datasets:\n- Used to get the dataset codes that can be passed to chat_gwi\n- Returns folders plus nested dataset nodes so clients can identify valid root/child combinations\n- Returns an empty `datasets` array when the caller has no dataset access\n","required":["jsonrpc","id","method","params"],"example":{"jsonrpc":"2.0","id":"req-datasets-1","method":"tools/call","params":{"name":"list_datasets"}},"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"isRequired":true,"uniqueKey":"oneOf.2.jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.id","typeLabel":"string"},"method":{"type":"string","enum":["tools/call"],"isRequired":true,"uniqueKey":"oneOf.2.method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","required":["name"],"properties":{"name":{"type":"string","enum":["list_datasets"],"description":"Tool name","isRequired":true,"uniqueKey":"oneOf.2.params.name","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"oneOf.2.params","typeLabel":"object"}},"uniqueKey":"oneOf.2","typeLabel":"list_datasets · object"},{"type":"object","title":"search_audiences","description":"Search available audiences:\n- Returns matching audiences with IDs and metadata\n- Requires a free-text query\n- Supports optional dataset filtering and exclusion IDs\n","required":["jsonrpc","id","method","params"],"example":{"jsonrpc":"2.0","id":"req-audience-search-1","method":"tools/call","params":{"name":"search_audiences","arguments":{"query":"pet owners","dataset_codes":["ds-core"],"limit":10}}},"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"isRequired":true,"uniqueKey":"oneOf.3.jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.id","typeLabel":"string"},"method":{"type":"string","enum":["tools/call"],"isRequired":true,"uniqueKey":"oneOf.3.method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"type":"string","enum":["search_audiences"],"description":"Tool name","isRequired":true,"uniqueKey":"oneOf.3.params.name","typeLabel":"enum\u003cstring>"},"arguments":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Required free-text audience search query.","example":"pet owners","isRequired":true,"uniqueKey":"oneOf.3.params.arguments.query","typeLabel":"string"},"dataset_codes":{"type":"array","description":"Optional dataset codes fetched from list_datasets to scope search.","items":{"type":"string","uniqueKey":"oneOf.3.params.arguments.dataset_codes.items.[INDEX]","typeLabel":"string"},"example":["ds-core"],"uniqueKey":"oneOf.3.params.arguments.dataset_codes","typeLabel":"string[]"},"exclude_audience_ids":{"type":"array","description":"Optional audience UUIDs to exclude from results.","items":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","uniqueKey":"oneOf.3.params.arguments.exclude_audience_ids.items.[INDEX]","typeLabel":"string"},"example":["82d06fe7-b933-42f7-bd83-2d47b065fdcd"],"uniqueKey":"oneOf.3.params.arguments.exclude_audience_ids","typeLabel":"string[]"},"limit":{"type":"integer","description":"Optional maximum number of results to return.","minimum":1,"maximum":100,"example":10,"uniqueKey":"oneOf.3.params.arguments.limit","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"oneOf.3.params.arguments","typeLabel":"object"}},"isRequired":true,"uniqueKey":"oneOf.3.params","typeLabel":"object"}},"uniqueKey":"oneOf.3","typeLabel":"search_audiences · object"}],"uniqueKey":"","typeLabel":"chat_gwi · object | explore_insight_gwi · object | list_datasets · object | search_audiences · object"},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":"req-123","method":"tools/call","params":{"name":"chat_gwi","arguments":{"prompt":"What marketing channels work best for Audi drivers in the US?"}}}}},"exampleType":"generated"}},"description":"JSON-RPC request for any supported MCP tool","required":true,"exampleType":"generated"},"responses":{"91e3d5d2-7f6b-481d-9791-14eb6cfcfc6a":{"description":"JSON-RPC response. HTTP 200 means the JSON-RPC call was processed, not that the tool succeeded.\n\nInspect `result.isError` if present:\n\n- `true` — tool failed; the message is in `result.content[0].text`, and `result._meta.isInternalError` may be `true` for internal or timeout-style failures.\n\nSee **Tool errors (`result.isError`)** in the overview above for full behavior.\n","content":{"application/json":{"schema":{"type":"object","description":"JSON-RPC 2.0 success envelope for MCP `tools/call` (no top-level `error` field).\n\nWhen the tool fails, HTTP status is still typically **200** and this object is returned with `result.isError: true`. Use that flag rather than HTTP status alone.\n","required":["jsonrpc","id","result"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"isRequired":true,"uniqueKey":"jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Request identifier echoed back","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"result":{"type":"object","description":"MCP tool result. Inspect `isError` for tool-level success or failure.\n\n**`isError: true`** — the tool failed; `content` usually has one `text` item with a human-readable explanation. Typical causes:\n\n- **Invalid arguments** (e.g. empty `prompt`, invalid UUID for `chat_id` / `insight_id` where required).\n- **Downstream errors** (e.g. resource not found, timeout, cancelled request, or generic internal failure).\n\n**`_meta.isInternalError`** — when present and `true`, the server classified the failure as internal or timeout-style. Omitted or `false` for most validation and not-found style errors.\n\nThis is **not** the same as a JSON-RPC protocol error: invalid `method` or malformed requests use the standard JSON-RPC `error` field instead of a tool `result`.\n","required":["content"],"properties":{"content":{"type":"array","items":{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"result.content.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","description":"Tool response if successful. When `result.isError` is `true`, it is the error message (exact wording may vary; do not rely on it for branching except for documented validation cases).","isRequired":true,"uniqueKey":"result.content.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"result.content.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.content","typeLabel":"object[]"},"isError":{"type":"boolean","description":"Tool-level failure indicator. `true` means the tool did not return a successful result; read `content[0].text` (when present) for details. Optional `_meta.isInternalError` refines internal failures.","uniqueKey":"result.isError","typeLabel":"boolean"},"_meta":{"type":"object","description":"Optional MCP result metadata.","properties":{"isInternalError":{"type":"boolean","description":"When `true`, indicates an internal or timeout-style failure path at the server. May be omitted for other error types.","uniqueKey":"result._meta.isInternalError","typeLabel":"boolean"}},"uniqueKey":"result._meta","typeLabel":"object"}},"isRequired":true,"uniqueKey":"result","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":"\u003cstring>","result":{"content":[{"type":"text","text":"\u003cstring>"}],"isError":true,"_meta":{"isInternalError":true}}}}},"exampleType":"generated"},"chat_gwi_response":{"examples":{"response":{"title":"response","value":{"jsonrpc":"2.0","id":"req-123","result":{"content":[{"type":"text","text":"# Data Analysis Result\n\n## Main Response\nBased on GWI data, Audi drivers in the US show distinct preferences...\n\nChat ID: 835aa1f0-cc30-4575-8829-557e03a29f76\n\n## Insights\nEach insight below is identified by a unique ID:\n\n- **Insight ID**: a1b2c3d4-e5f6-7890-abcd-ef1234567890\n **Content**: 72% of Audi drivers prefer digital advertising channels\n\n- **Insight ID**: b2c3d4e5-f6a7-8901-bcde-f23456789012\n **Content**: Social media engagement is 45% higher than average\n\n## Sources\n**Topics**: Automotive, Digital Marketing\n**Datasets**: GWI Core (gwi_core)\n**Locations**: United States\n**Time periods**: Q4 2023\n"}]}}}},"exampleType":"examples"},"explore_insight_response":{"examples":{"response":{"title":"response","value":{"jsonrpc":"2.0","id":"req-456","result":{"content":[{"type":"text","text":"# Glossary for your understanding:\nAudience: the group of people participating in the survey\nQuestion: the question being asked\nAnswer: the answer to the question\nPercentage: of the audience that selected this answer\nSample: number of respondents from the audience\nIndex: How likely it is for members of the audience to choose this answer compare to all internet users. Ex. 142 -> more, 90 -> less\n\n# Data to process\n\nAudience: Audi drivers in the United States\n\n## Attributes\n\n ## Processing Instructions\n When responding to users about this data:\n 1. Reference specific insights by their IDs when relevant\n 2. Consider the source information for context\n 3. Note the time periods when discussing trends\n 4. If referring to specific datasets, include both the name and code if available\n"}]}}}},"exampleType":"examples"},"explore_insight_gwi_success":{"examples":{"response":{"title":"response","value":{"jsonrpc":"2.0","id":2,"result":{"content":[{"type":"text","text":"# Glossary for your understanding:\nAudience: the group of people participating in the survey\nQuestion: the question being asked\nAnswer: the answer to the question\nPercentage: of the audience that selected this answer\nSample: number of respondents from the audience\nIndex: How likely it is for members of the audience to choose this answer compared to all internet users (100 is the average). Ex. 142 -> 42% more likely, 90 -> 10% less likely\n\n- Question: Which digital advertising channels do you engage with?\n- Answer: Search engine ads\n- Percentage: 68.50%\n- Sample: 1523\n- Index: 132.00\n\n# Responding guidelines\n- Present a summary of the audience\n- Present the question\n- For each answer, present the percentage, sample size and index and explain their meaning clearly\n"}]}}}},"exampleType":"examples"},"tool_error_invalid_arguments":{"examples":{"response":{"title":"response","value":{"jsonrpc":"2.0","id":"req-validation-1","result":{"isError":true,"content":[{"type":"text","text":"could not validate input: chat prompt is required"}]}}}},"exampleType":"examples"},"tool_error_internal":{"examples":{"response":{"title":"response","value":{"jsonrpc":"2.0","id":"req-internal-1","result":{"isError":true,"_meta":{"isInternalError":true},"content":[{"type":"text","text":"something went wrong while processing request"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"585e01bf-ad42-408b-9cff-bd1e32005a19":{"description":"Unauthorized - Invalid or missing bearer token","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Invalid or missing bearer token","uniqueKey":"message","typeLabel":"string"},"code":{"type":"integer","example":401,"uniqueKey":"code","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"Invalid or missing bearer token","code":401}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"93c52b1f-6be0-4c96-a6cd-16edf53e44e1":{"BearerAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Format: Bearer YOUR_TOKEN","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"e23d3e22-388e-4866-8485-b39df59caa98":{"url":"https://api.globalwebindex.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Format: Bearer YOUR_TOKEN","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Authorization","type":"string","description":"Format: Bearer YOUR_TOKEN","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi/spark-mcp/spark-mcp.json"},"subdomain":"gwi-c45e8f9c","siteName":"GWI","title":"Execute GWI MCP tool calls - GWI","navMaps":{"firstHrefInVersion":{"v1":{"href":"/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls","matchLevel":0},"v2beta":{"href":"/spark-mcp/v2beta/changelog","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T13:00:21.152Z","originalFileLocation":"spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This endpoint handles MCP tool calls through JSON-RPC. Supported tools: 1. chat_gwi - Query audience insights - Returns main response, insights with IDs, sources, and chat ID - Use for initial queries and follow-ups 2. explore_insight_gwi - Get detailed statistics - Returns percentages, sample sizes, and index scores - Use with insight IDs from chat_gwi responses 3. list_datasets - List available datasets - Used to get the dataset codes that can be passed to chat_gwi - Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations - Returns an empty datasets array when the caller has no dataset access 4. search_audiences - Search available audiences - Returns matching audience entries with IDs, metadata, and dataset availability - Supports optional dataset filtering, exclusion IDs, and result limits\">\u003cmeta data-mint-head name=\"application-name\" content=\"GWI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Execute GWI MCP tool calls - GWI\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint handles MCP tool calls through JSON-RPC. Supported tools: 1. chat_gwi - Query audience insights - Returns main response, insights with IDs, sources, and chat ID - Use for initial queries and follow-ups 2. explore_insight_gwi - Get detailed statistics - Returns percentages, sample sizes, and index scores - Use with insight IDs from chat_gwi responses 3. list_datasets - List available datasets - Used to get the dataset codes that can be passed to chat_gwi - Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations - Returns an empty datasets array when the caller has no dataset access 4. search_audiences - Search available audiences - Returns matching audience entries with IDs, metadata, and dataset availability - Supports optional dataset filtering, exclusion IDs, and result limits\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GWI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gwi-c45e8f9c.mintlify.app/_mintlify/api/og/v2?division=MCP+Tools\u0026amp;title=Execute+GWI+MCP+tool+calls\u0026amp;description=This+endpoint+handles+MCP+tool+calls+through+JSON-RPC.+Supported+tools%3A%0A%0A**1.+chat_gwi**+-+Query+audience+insights%0A-+Returns+main+response%2C+insights+with+IDs%2C+s\u0026amp;theme=f78a94cf9ffe31b08d06a0cd\u0026amp;signature=a5d75cefc7fa910a12d1016f4a2731595699bbf62cad32d7f2f57115d69f8043\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Execute GWI MCP tool calls - GWI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint handles MCP tool calls through JSON-RPC. Supported tools: 1. chat_gwi - Query audience insights - Returns main response, insights with IDs, sources, and chat ID - Use for initial queries and follow-ups 2. explore_insight_gwi - Get detailed statistics - Returns percentages, sample sizes, and index scores - Use with insight IDs from chat_gwi responses 3. list_datasets - List available datasets - Used to get the dataset codes that can be passed to chat_gwi - Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations - Returns an empty datasets array when the caller has no dataset access 4. search_audiences - Search available audiences - Returns matching audience entries with IDs, metadata, and dataset availability - Supports optional dataset filtering, exclusion IDs, and result limits\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gwi-c45e8f9c.mintlify.app/_mintlify/api/og/v2?division=MCP+Tools\u0026amp;title=Execute+GWI+MCP+tool+calls\u0026amp;description=This+endpoint+handles+MCP+tool+calls+through+JSON-RPC.+Supported+tools%3A%0A%0A**1.+chat_gwi**+-+Query+audience+insights%0A-+Returns+main+response%2C+insights+with+IDs%2C+s\u0026amp;theme=f78a94cf9ffe31b08d06a0cd\u0026amp;signature=a5d75cefc7fa910a12d1016f4a2731595699bbf62cad32d7f2f57115d69f8043\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/gwi-c45e8f9c/-ok9rsKwuEFjmZbD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GWI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#de1a76\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.globalwebindex.com/#organization\",\"name\":\"GWI\",\"url\":\"https://api.globalwebindex.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gwi-c45e8f9c/lDVzA75IGIMfShVe/assets/logo/light.png?fit=max\u0026auto=format\u0026n=lDVzA75IGIMfShVe\u0026q=85\u0026s=a6bcd3ee7012836c15db595bc15fa6ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.globalwebindex.com/docs#website\",\"name\":\"GWI\",\"url\":\"https://api.globalwebindex.com/docs\",\"publisher\":{\"@id\":\"https://api.globalwebindex.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls#webpage\",\"url\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls\",\"name\":\"Execute GWI MCP tool calls\",\"description\":\"This endpoint handles MCP tool calls through JSON-RPC. Supported tools: 1. chat_gwi - Query audience insights - Returns main response, insights with IDs, sources, and chat ID - Use for initial queries and follow-ups 2. explore_insight_gwi - Get detailed statistics - Returns percentages, sample sizes, and index scores - Use with insight IDs from chat_gwi responses 3. list_datasets - List available datasets - Used to get the dataset codes that can be passed to chat_gwi - Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations - Returns an empty datasets array when the caller has no dataset access 4. search_audiences - Search available audiences - Returns matching audience entries with IDs, metadata, and dataset availability - Supports optional dataset filtering, exclusion IDs, and result limits\",\"dateModified\":\"2026-10-07T13:00:21.152Z\",\"isPartOf\":{\"@id\":\"https://api.globalwebindex.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Spark MCP\",\"item\":\"https://api.globalwebindex.com/docs/spark-mcp/changelog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Execute GWI MCP tool calls\",\"item\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls#apireference\",\"headline\":\"Execute GWI MCP tool calls\",\"name\":\"Execute GWI MCP tool calls\",\"description\":\"This endpoint handles MCP tool calls through JSON-RPC. Supported tools: 1. chat_gwi - Query audience insights - Returns main response, insights with IDs, sources, and chat ID - Use for initial queries and follow-ups 2. explore_insight_gwi - Get detailed statistics - Returns percentages, sample sizes, and index scores - Use with insight IDs from chat_gwi responses 3. list_datasets - List available datasets - Used to get the dataset codes that can be passed to chat_gwi - Returns hierarchical folder and dataset nodes so clients can identify valid root/child combinations - Returns an empty datasets array when the caller has no dataset access 4. search_audiences - Search available audiences - Returns matching audience entries with IDs, metadata, and dataset availability - Supports optional dataset filtering, exclusion IDs, and result limits\",\"url\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls\",\"mainEntityOfPage\":{\"@id\":\"https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls#webpage\"},\"dateModified\":\"2026-10-07T13:00:21.152Z\",\"publisher\":{\"@id\":\"https://api.globalwebindex.com/#organization\"},\"isPartOf\":{\"@id\":\"https://api.globalwebindex.com/docs#website\"}}]}\u003c/script>","siteName":"GWI","nav":{"global":null,"tabs":[{"tab":"Welcome","pages":[{"title":"Welcome","href":"/welcome"}]},{"tab":"GWI Overview","pages":[{"title":"GWI Overview","href":"/overview/gwi"}]},{"tab":"Spark in AI assistants","pages":[{"title":"Spark in AI assistants","href":"/spark-in-ai-assistants/introduction"}]},{"tab":"Spark API","pages":[{"title":"Spark API","href":"/spark-api/getting-started/introduction"}]},{"tab":"Spark MCP","versions":[{"version":"v1","default":true,"tag":"Current","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/spark-mcp/getting-started/introduction"},{"title":"Prerequisites","href":"/spark-mcp/getting-started/prerequisites"},{"title":"Authorization","href":"/spark-mcp/getting-started/authorization"},{"group":"Integration Guide","pages":[{"title":"Overview","href":"/spark-mcp/integration-guide/overview"},{"title":"MCP Server","href":"/spark-mcp/integration-guide/mcp-api"},{"title":"MCP Remote","href":"/spark-mcp/integration-guide/mcp-remote"},{"group":"Claude","pages":[{"title":"Custom connector","href":"/spark-mcp/integration-guide/claude/custom-connector"},{"title":"Desktop extension","href":"/spark-mcp/integration-guide/claude/desktop-extension"}]},{"group":"ChatGPT","pages":[{"title":"Custom connector","href":"/spark-mcp/integration-guide/chatgpt/custom-connector"}]},{"title":"Codex CLI","href":"/spark-mcp/integration-guide/codex/guide"},{"title":"Copilot Studio","href":"/spark-mcp/integration-guide/copilot-studio/custom-connector"},{"title":"Gemini Enterprise","href":"/spark-mcp/integration-guide/gemini-enterprise/v1"},{"title":"Google Gemini CLI","href":"/spark-mcp/integration-guide/gemini-cli/guide"},{"title":"Cursor","href":"/spark-mcp/integration-guide/cursor/guide"},{"title":"Slack-Slackbot ","href":"/spark-mcp/integration-guide/slack/slack"}]}]},{"group":"Spark MCP","pages":[{"title":"Changelog","description":"Version history and release notes for the Spark MCP Server","href":"/spark-mcp/changelog"},{"group":"Reference","pages":[{"group":"MCP Tools","pages":[{"openapi":"post /v1/spark-api/mcp","title":"Execute GWI MCP tool calls","href":"/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls"}]}]}]}]},{"version":"v2beta","tag":"Beta","pages":[{"title":"v2beta","href":"/spark-mcp/v2beta/changelog"}]}]},{"tab":"Platform API","pages":[{"title":"Platform API","href":"/platform-api/getting-started/introduction"}]},{"tab":"Dictionary","pages":[{"title":"Dictionary","href":"/dictionary/dictionary"}]}]},"title":"Execute GWI MCP tool calls - GWI","buildId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","deploymentId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-2jF_ccbi.js","utils-NNMVb_sb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DdtBhtt6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D1OxL5O8.js","snippetPresets-DDC-KAXp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BOnTqOyQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-EEWI6FIO.js","shallow-fGZcWzm2.js","getApiPlaygroundDisplay-B3B8qEvw.js","CodeSnippet-BG9nsSU4.js","CodeSnippets-BlRACLKl.js","Page-FtoC8lZ9.js","getPastedJson-COV-Kgnr.js","icon-BXu3lasn.js","MethodPill-DGMUqJKh.js","DuplicateIcon-JEUJDHz_.js","createIcon-BDFucJ34.js","DynamicMarkdown-34OtG_BH.js","SectionHeading-tBbRD59j.js","axios-vUo_bRtp.js","Markdown-SoRz2nk2.js","clsx-BOmkPVIU.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DN0dCbTw.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BcsLYcfW.js"]}