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

# MCP server

> Give your agent every Helve tool with one connection.

Helve is a Model Context Protocol server at `https://helve.dev/mcp`. Connect it once and Claude Code, Cursor, Codex, Gemini CLI, VS Code, or any client that supports header authentication gets `search_tools`, `call_tool`, `request_tool`, `search`, `extract`, and `transcribe` backed by your key. Usage is metered and appears in the dashboard with source `mcp`.

The dashboard's **Connect MCP** button on the API keys tab produces these commands with your key filled in. Unauthenticated `initialize` and `tools/list` requests are supported for client and registry discovery; `tools/call` requires a valid `Authorization: Bearer sk_live_…` key.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http helve https://helve.dev/mcp \
>   --header "Authorization: Bearer sk_live_…"
> ```

> [tab] Cursor
>
> Add to `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "helve": {
>       "url": "https://helve.dev/mcp",
>       "headers": { "Authorization": "Bearer sk_live_…" }
>     }
>   }
> }
> ```

> [tab] Codex
>
> ```bash theme={null}
> export HELVE_API_KEY="sk_live_…"
> codex mcp add helve --url https://helve.dev/mcp --bearer-token-env-var HELVE_API_KEY
> ```

> [tab] Gemini CLI
>
> ```bash theme={null}
> gemini mcp add --transport http \
>   --header "Authorization: Bearer sk_live_…" helve https://helve.dev/mcp
> ```

> [tab] VS Code
>
> Add to `settings.json`:
>
> ```json theme={null}
> "mcp": {
>   "servers": {
>     "helve": {
>       "type": "http",
>       "url": "https://helve.dev/mcp",
>       "headers": { "Authorization": "Bearer sk_live_…" }
>     }
>   }
> }
> ```

## What the tools accept

The MCP tools take the same parameters as the HTTP endpoints, so everything in [Search](https://docs.helve.dev/tools/search.md), [Extract](https://docs.helve.dev/tools/extract.md), and [Transcription](https://docs.helve.dev/tools/transcription.md) applies. An agent can set `provider: "fusion"` for a hard question and `provider: "brave"` for a cheap keyword lookup in the same session.

## Transport

The server is stateless and follows the 2026 Streamable HTTP specification. Each request carries the bearer key; no session cookies, no OAuth dance. Clients that require OAuth rather than header auth, such as claude.ai's hosted connectors, are not yet supported.


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