> ## Documentation Index
> Fetch the complete documentation index at: https://beta-docs-prod.indices.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

The Indices MCP server lets your AI agents perform tasks across the web. Connect it to any MCP-compatible agent in minutes.

**MCP endpoint:** `https://mcp.indices.io`

**Authentication:** All requests require an `Authorization: Bearer <API_KEY>` header. Generate an API key in [the dashboard](https://platform.indices.io/api-keys).

***

## Installation

### Quick setup (recommended)

Use [`add-mcp`](https://github.com/neondatabase/add-mcp) to configure Indices across all your installed agents at once. In a terminal, run:

```bash theme={null}
npx add-mcp https://mcp.indices.io --header "Authorization: Bearer <API_KEY> --all -g -y"
```

`add-mcp` detects which agents you have installed (Claude Code, Cursor, VS Code, Gemini CLI, Codex, and [more](https://github.com/neondatabase/add-mcp)) and updates their config files automatically.

**Skill:** Optionally, install the [Indices skill](https://github.com/indicesio/skills) to teach coding agents how to use Indices: `npx skills add indicesio/skills --all --global`

***

### Manual Setup

#### Claude Code

In a terminal, run:

```bash theme={null}
claude mcp add indices-mcp https://mcp.indices.io --transport http --header "Authorization: Bearer <API_KEY>"
```

For more information, see the [Claude Code MCP documentation](https://code.claude.com/docs/en/mcp#authenticate-with-remote-mcp-servers).

#### Claude Desktop

For Claude Desktop, go to **Settings → Developer → Edit Config** and add:

```json theme={null}
{
  "mcpServers": {
    "indices-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.indices.io",
        "--header",
        "Authorization: Bearer <API_KEY>"
      ]
    }
  }
}
```

For more details, see the [Claude remote MCP documentation](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).

#### Cursor

Add to `~/.cursor/mcp.json` or `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "indices-mcp": {
      "url": "https://mcp.indices.io",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

For more details, see the [Cursor MCP documentation](https://cursor.com/docs/context/mcp).

#### VS Code (Copilot)

Add to your `settings.json`:

```json theme={null}
{
  "mcp": {
    "servers": {
      "indices-mcp": {
        "type": "http",
        "url": "https://mcp.indices.io",
        "headers": {
          "Authorization": "Bearer <API_KEY>"
        }
      }
    }
  }
}
```

For more details, see the [VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

#### Gemini CLI

Add to `~/.gemini/settings.json`:

```json theme={null}
{
  "mcpServers": {
    "indices-mcp": {
      "httpUrl": "https://mcp.indices.io",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

For more details, see the [Gemini CLI MCP documentation](https://geminicli.com/docs/tools/mcp-server/).

#### ChatGPT

Go to **Settings → Connectors → Advanced Settings**, enable Developer Mode, then create a connector:

* **Name:** `indices-mcp`
* **URL:** `https://mcp.indices.io`
* **Authentication:** Add the header `Authorization: Bearer <API_KEY>`

For more details, see [OpenAI's MCP apps documentation](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt-beta).

#### OpenAI Codex CLI

Add to `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.indices-mcp]
url = "https://mcp.indices.io"

[mcp_servers.indices-mcp.headers]
Authorization = "Bearer <API_KEY>"
```

For more details, see the [Codex MCP documentation](https://developers.openai.com/codex/mcp/).

#### Other agents

Use the Streaming HTTP transport with URL `https://mcp.indices.io`. Ensure outbound requests include the `Authorization: Bearer <API_KEY>` header. If your client doesn't support custom headers, use [`mcp-remote`](https://github.com/geelen/mcp-remote) to proxy requests. See the [MCP documentation](https://modelcontextprotocol.io/docs/develop/connect-local-servers) for general guidance.

***

## Example

With a task set up to retrieve AI events from [Luma](https://luma.com/ai), you can then ask your agent:

> *Can you get a list of Luma events happening today?*

```
Found 9 Luma events happening in London today (October 2, 2025):

  Morning:
  - Annual Town Hall (7:30 AM) — The Trampery Old Street
  - AEO LDN October: Discover How To Rank in AI Searches (8:00 AM) — Crypt on the Green

  Afternoon:
  - M&A Round Table: A data-led approach (12:30 PM) — Malmaison London
  - Me, Myself & AI: Workshop on How to Use AI (4:00 PM) — Bluebird City

  Evening:
  - Agentic Happy Hours after MCP Dev Summit (5:00 PM)
  - AI Engineer London Meetup #7 (5:00 PM)
  - MCP Happy Hour by goose (5:30 PM) — 18 Old Bailey
```

<Accordion title="Image of response in Claude Code">
  <img src="https://mintcdn.com/ayu-ba4d74dc/53HYlvs876810Z55/images/luma-claude-code.png?fit=max&auto=format&n=53HYlvs876810Z55&q=85&s=a06010e2ba3e906afab45c991817b511" alt="Luma events happening today, retrieved via Indices" width="1206" height="1208" data-path="images/luma-claude-code.png" />
</Accordion>