Skip to main content

​
Overview

The GWI MCP server can be integrated with Google Gemini CLI to enable agents to access GWI consumer insights data inside the CLI. The integration supports two authentication modes: Reference: Google Gemini CLI MCP official documentation

​
Prerequisites

Before continuing with the integration, please follow the instructions to install npm and gemini CLI:

​
OAuth mode

  1. Run the following command to add the GWI MCP server: 
    gemini mcp add "GWI Spark" https://api.globalwebindex.com/v1/spark-api/mcp \
-t http \
-s user
    Note: this will add an entry on the ~/.gemini/settins.json. If you want to use gemini-cli in project level please use -s project which will update the {WORKSPACE}/.gemini/settings.json Both of these can also be edited manually.
  2. Execute gemini 
    gemini
  3. Validate that the mcp server was added, by prompting 
    > /mcp list

    Configured MCP servers:

🔴 GWI Spark - Disconnected (OAuth not authenticated)
  4. Initiate the OAuth flow 
    > /mcp auth GWI Spark
  5. You’ll be redirected to the GWI sign-in page. Use your GWI credentials to sign in. If you don’t have a GWI login, click Sign up to create one Gemini-cli MCP member signin
  6. After successful signin, you need to allow access to Gemini CLI Gemini-cli MCP member signin
  7. Then return to gemini and validate that the mcp server is connected 
    > /mcp

    Configured MCP servers:

🟢 GWI Spark - Ready (2 tools)
  Tools:
  - chat_gwi
  - explore_insight_gwi
  8. Start using the GWI Spark

​
Spark API token mode

This mode is available for users that have a Spark API token available.
  1. Run the following command to add the GWI MCP server: 
    gemini mcp add "GWI Spark" https://api.globalwebindex.com/v1/spark-api/mcp \
-t http \
-s user \
-H "Authorization: Bearer <SPARK_API_TOKEN>"
    Note: this will add an entry on the ~/.gemini/settins.json. If you want to use gemini-cli in project level please use -s project which will update the {WORKSPACE}/.gemini/settings.json Both of these can also be edited manually.
  2. Execute gemini 
    gemini
  3. Validate that the mcp server was added, by prompting 
    > /mcp

    Configured MCP servers:

🟢 GWI Spark - Ready (2 tools)
  Tools:
  - chat_gwi
  - explore_insight_gwi
  4. Start using the GWI Spark