> ## Documentation Index
> Fetch the complete documentation index at: https://api.globalwebindex.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Remote

## Overview

Choose the MCP remote when you want to use GWI data in existing MCP client applications like Claude Desktop, Cursor, or other tools with built-in MCP support. This is ideal for:

* Claude Desktop app users and other MCP-compatible applications
* Users who want to use GWI data without writing code

The MCP remote is an **npm** package that runs locally on your machine and acts as a bridge between MCP clients and the Spark API.
This is available on:

* **GitHub**: [mcp-remote](https://github.com/geelen/mcp-remote)
* **NPM**: [mcp-remote](https://www.npmjs.com/package/mcp-remote)

## How to use

1. Install [Node.js](https://nodejs.org) for accessing `npx` on your machine. Please use one of the following methods to install for your OS:

   * using [package managers](https://nodejs.org/en/download/package-manager/all) ([macOs](https://nodejs.org/en/download/package-manager/all#macos), [windows](https://nodejs.org/en/download/package-manager/all#windows-1))
   * using the installers from the [official nodejs download page](https://nodejs.org/en/download)

2. Validate `npx` exists in your system

   ```bash theme={null}
   npx -v
   # should print the npx version ex. 10.7.0
   ```

3. Use the following configuration for your MCP client:
   ```json theme={null}
   {
     "mcpServers": {
       "gwi_spark_ai": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://api.globalwebindex.com/v1/spark-api/mcp",
           "--header",
           "Authorization:${AUTH_HEADER}"
         ],
         "env": {
           "AUTH_HEADER": "Bearer YOUR_GWI_TOKEN_HERE"
         }
       }
     }
   }
   ```