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

# Remote MCP

> Connect Claude, ChatGPT, Codex, Cursor or any MCP client to Valyu's hosted server for search across the web and specialised indexes built for knowledge work, plus DeepResearch

Search from Claude, ChatGPT, Codex, Cursor or any MCP client. Plus DeepResearch, for full cited reports.

Live, real-time web search that returns the full page rather than a snippet, alongside specialised indexes built for knowledge work: open and paywalled academic journals including [Wiley](/guides/wiley-hls), SEC filings and company fundamentals, market data, clinical trials and drug databases, economic indicators, patents, case law, financial news and prediction markets. One call searches both.

```
https://mcp.valyu.ai/mcp?valyuApiKey=YOUR_API_KEY
```

<Note>
  **\$10 free credits (\$20 with a work email)** when you sign up at
  [Valyu](https://platform.valyu.ai). No card required.
</Note>

## Connect

<Tabs>
  <Tab title="Claude">
    **Settings → Connectors → Add custom connector**, paste your URL with the key on it, then **Connect**.

    To sign in instead of using a key, paste `https://mcp.valyu.ai/mcp` and Claude will prompt you.
  </Tab>

  <Tab title="ChatGPT">
    **Settings → Connectors → Create**, paste your URL with the key on it.

    To sign in instead of using a key, paste `https://mcp.valyu.ai/mcp` and ChatGPT will prompt you.
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http valyu "https://mcp.valyu.ai/mcp?valyuApiKey=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="Cursor, Codex, others">
    ```json theme={null}
    {
      "mcpServers": {
        "valyu": {
          "type": "http",
          "url": "https://mcp.valyu.ai/mcp?valyuApiKey=YOUR_API_KEY"
        }
      }
    }
    ```
  </Tab>

  <Tab title="OpenAI Responses API">
    ```python theme={null}
    resp = client.responses.create(
        model="gpt-5",
        tools=[{
            "type": "mcp",
            "server_label": "valyu",
            "server_url": "https://mcp.valyu.ai/mcp",
            "authorization": "YOUR_API_KEY",
            "require_approval": "never",
        }],
        input="What are the latest FDA approvals for GLP-1 drugs?",
    )
    ```
  </Tab>
</Tabs>

## Authentication

**Put your API key on the URL.** This is the simplest way in and works in every client, including those that cannot set headers:

```
https://mcp.valyu.ai/mcp?valyuApiKey=YOUR_API_KEY
```

Get a key at [platform.valyu.ai](https://platform.valyu.ai/user/account/apikeys), or copy your personalised URL, already filled in, from the platform.

If your client can set headers, `Authorization: Bearer YOUR_API_KEY` or `X-API-Key: YOUR_API_KEY` also work, and keep the key out of logged URLs.

**Or sign in with Valyu.** Claude, ChatGPT and Claude Code can run a sign-in flow instead, so no key is pasted into the client. Paste the URL without the key and the client will prompt you.

## Tools

| Tool | What it does |
| - | - |
| `valyu_search` | Search the web and every proprietary dataset in one call |
| `valyu_datasources` | The live dataset catalogue, searchable in plain language |
| `valyu_contents` | Read one or more URLs as clean markdown, with an optional page screenshot |
| `valyu_deepresearch` | Start a research task that writes a cited report |
| `valyu_deepresearch_status` | Check a task, or collect the finished report |
| `valyu_deepresearch_control` | Steer, answer a checkpoint, share, cancel or delete |

Just ask in natural language. "Tesla's latest 10-K risk factors", "clinical trials for CAR-T therapy in lymphoma", "US CPI compared to a year ago". The assistant picks the tool.

## Getting good results

* **Ask for what you want, plainly.** Routing is automatic across the live web and every specialised index your plan covers, and that is the right call for most questions.
* **Name the source if you have one.** "Search arxiv.org for…" or "in SEC filings…" scopes the search. Filings are indexed by section, so ask for the company, form and item together: "Apple 10-K Item 1A risk factors".
* **Say "latest" rather than giving a date.** Date filters are exact and unforgiving; a data series is stamped at the start of the period it covers, so a window can hide the newest release.
* **DeepResearch when you want a report.** It works as a research agent, planning, searching, reading and writing over minutes to hours, so ask for it by name when a finished cited report is what you want.

## Migrating from the previous server

The previous server exposed eleven tools, including a separate search tool per vertical. Those are now one `valyu_search` with real parameters.

The old tools - `valyu_academic_search`, `valyu_financial_search`, `valyu_sec_search`, `valyu_bio_search`, `valyu_economics_search`, `valyu_patents`, `valyu_company_research`, `valyu_datasources_categories` - are hidden from the tool list but **still work when called by name**, so existing integrations keep running. List them with `?tools=legacy` on the URL.

<Warning>
  The old tools are removed on **1 December 2026**. Move to `valyu_search` and `valyu_datasources` before then.
</Warning>

## Pricing

Usage is billed to the organisation the credential belongs to, on the same usage-based pricing as the Valyu API. Free credits work across every source; premium and proprietary sources need a subscription. See [pricing](https://docs.valyu.ai/pricing).

<CardGroup cols={2}>
  <Card title="Get an API key" icon="key" href="https://platform.valyu.ai/user/account/apikeys">
    Free credits, no card
  </Card>

  <Card title="Data sources" icon="database" href="https://platform.valyu.ai/data-sources">
    Every dataset you can search
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.