Execute GWI MCP tool calls

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

POST /v1/spark-api/mcp

Execute GWI MCP tool calls

cURL

curl --request POST \
  --url https://api.globalwebindex.com/v1/spark-api/mcp \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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?"
    }
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": "<string>",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "<string>"
      }
    ],
    "isError": true
  }
}

Authorizations

Authorization · string · header · required

Format: Bearer YOUR_TOKEN

Body

application/json

JSON-RPC request for any supported MCP tool

chat_gwi

explore_insight_gwi

list_datasets

Query audience insights:

• Returns main response, insights with IDs, sources, and chat ID
• Use for initial queries and follow-ups

jsonrpc · enum<string> · required

JSON-RPC version

Available options: 2.0

id · string · required

Unique request identifier

Example:

"req-123"

method · enum<string> · required

Method name for MCP tool calls

Available options: tools/call

params · object · required

Show child attributes

Response

200

application/json

Successful response with insights

jsonrpc · enum<string> · required

Available options: 2.0

id · string · required

Request identifier echoed back

result · object · required

Show child attributes