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

# Install the Web Tools MCP

> Connect Cursor, VS Code, Claude Code, Codex, and other MCP clients to Modellix Web Search and Web Fetch at https://tool.modellix.ai/mcp.

Modellix Web Tools MCP is a remote Streamable HTTP server at `https://tool.modellix.ai/mcp`. It exposes Web Search and Web Fetch to MCP clients. Send `POST` requests only; the server does not use GET SSE and does not require `Mcp-Session-Id`.

<Note>
  This is not the [Modellix Docs MCP](/ways-to-use/mcp). The **Connect to
  Cursor** / **Connect to VS Code** items in the page contextual menu install
  `https://docs.modellix.ai/mcp`. Use the buttons and configs on this page for
  Tools MCP.
</Note>

## What You Get

After the client lists tools, you should see:

<Columns cols={2}>
  <Card title="Web Search" icon="search" href="/api/web-search">
    Tool name `modellix-ai/web-search`. Search the public web and return ranked
    results. Request fields and pricing live on the API page.
  </Card>

  <Card title="Web Fetch" icon="globe" href="/api/web-fetch">
    Tool name `modellix-ai/web-fetch`. Extract readable content from public HTTP
    or HTTPS URLs. Request fields and pricing live on the API page.
  </Card>
</Columns>

See [Tools Overview](/tools/overview) for SKUs and rates. Query history with [Get Tool Logs](/api/get-tool-logs).

## Prerequisites

<Steps>
  <Step title="Get an API Key">
    Create a key in the [Modellix console](https://modellix.ai/console/api-key).
    Keep it in the MCP client or a secrets store. Do not put it in frontend
    code, public repos, or logs.
  </Step>

  <Step title="Choose a Stable End-User ID">
    Every call requires `X-Mdlx-User-Id`: 8–128 characters of letters, digits,
    `-`, or `_`. Use a stable business ID such as `user_12345678`. Do not use
    nicknames, email, phone numbers, or a new random value per request.
  </Step>
</Steps>

Required headers:

| Header           | Required | Value                                                            |
| ---------------- | -------- | ---------------------------------------------------------------- |
| `Authorization`  | Yes      | `Bearer <MODELLIX_API_KEY>`                                      |
| `X-Mdlx-User-Id` | Yes      | Stable end-user ID                                               |
| `Content-Type`   | Yes      | `application/json` (clients usually set this)                    |
| `Accept`         | Yes      | `application/json, text/event-stream` (clients usually set this) |

## Install

Replace `YOUR_MODELLIX_API_KEY` and `your-end-user-id` before you use the server.

<Warning>
  One-click install embeds placeholders. Open the client MCP settings afterward
  and replace the API Key and `X-Mdlx-User-Id`.
</Warning>

<Tabs>
  <Tab title="Cursor" icon="mouse-pointer-2">
    <PreviewButton href="cursor://anysphere.cursor-deeplink/mcp/install?name=modellix-tools&config=eyJ1cmwiOiJodHRwczovL3Rvb2wubW9kZWxsaXguYWkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfTU9ERUxMSVhfQVBJX0tFWSIsIlgtTWRseC1Vc2VyLUlkIjoieW91ci1lbmQtdXNlci1pZCJ9fQ==">
      Install in Cursor
    </PreviewButton>

    Or add the server by hand:

    <Steps>
      <Step title="Open MCP Settings">
        Press <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (
        <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> on Windows), search
        for **Open MCP settings**, then click **Add custom MCP**.
      </Step>

      <Step title="Add Modellix Tools">
        ```json theme={null}
        {
          "mcpServers": {
            "modellix-tools": {
              "url": "https://tool.modellix.ai/mcp",
              "headers": {
                "Authorization": "Bearer YOUR_MODELLIX_API_KEY",
                "X-Mdlx-User-Id": "your-end-user-id"
              }
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code" icon="code">
    <PreviewButton href="https://vscode.dev/redirect/mcp/install?name=modellix-tools&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ftool.modellix.ai%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20YOUR_MODELLIX_API_KEY%22%2C%22X-Mdlx-User-Id%22%3A%22your-end-user-id%22%7D%7D">
      Install in VS Code
    </PreviewButton>

    Or create `.vscode/mcp.json`:

    ```json theme={null}
    {
      "servers": {
        "modellix-tools": {
          "type": "http",
          "url": "https://tool.modellix.ai/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_MODELLIX_API_KEY",
            "X-Mdlx-User-Id": "your-end-user-id"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code" icon="terminal">
    ```bash theme={null}
    claude mcp add --transport http modellix-tools https://tool.modellix.ai/mcp \
      --header "Authorization: Bearer YOUR_MODELLIX_API_KEY" \
      --header "X-Mdlx-User-Id: your-end-user-id"
    ```

    Confirm with `claude mcp list`. The entry needs `"type": "http"` if you edit `.mcp.json` by hand.
  </Tab>

  <Tab title="Codex" icon="terminal">
    In `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.modellix-tools]
    url = "https://tool.modellix.ai/mcp"
    http_headers = { "Authorization" = "Bearer YOUR_MODELLIX_API_KEY", "X-Mdlx-User-Id" = "your-end-user-id" }
    ```

    Run `codex mcp list` to confirm the server is registered.
  </Tab>

  <Tab title="Other Clients">
    Any MCP client that supports remote Streamable HTTP and custom headers can use this config. Field names vary by host; the URL and headers stay the same.

    ```json theme={null}
    {
      "mcpServers": {
        "modellix-tools": {
          "type": "http",
          "url": "https://tool.modellix.ai/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_MODELLIX_API_KEY",
            "X-Mdlx-User-Id": "your-end-user-id"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Verify

Reload the client, then ask which tools are available. You should see `modellix-ai/web-search` and `modellix-ai/web-fetch`.

If the client returns `401`, check the API Key. If it returns `400`, check `X-Mdlx-User-Id`. Keep `request_id` from the tool result when you contact support.