Skip to main content

​
About Ref’s MCP Server

Ref runs as a streamable HTTP server that implements the Model Context Protocol (MCP). This means you can connect to Ref’s documentation search capabilities from any MCP-compatible client without installing additional packages locally.

​
Authentication

Ref’s API accepts authentication in two ways:
  1. As a header: x-ref-api-key: YOUR_API_KEY
  2. As a query parameter: ?apiKey=YOUR_API_KEY
The streamable HTTP endpoint is available at https://api.ref.tools/mcp. You can find your API key at ref.tools/keys

​
Installation Guides

Choose your coding environment below to get started:

Cursor

Connect Cursor to up-to-date and token-efficient documentation.

Claude Code

Connect Claude Code to up-to-date and token-efficient documentation.

VS Code

Connect VS Code to up-to-date and token-efficient documentation.

Windsurf

Connect Windsurf to up-to-date and token-efficient documentation.

Cline

Connect Cline to up-to-date and token-efficient documentation.

Roo Code

Connect Roo Code to up-to-date and token-efficient documentation.

Goose

Connect Goose to up-to-date and token-efficient documentation.

Augment

Connect Augment to up-to-date and token-efficient documentation.

ChatGPT

Connect ChatGPT to up-to-date and token-efficient documentation.

OpenCode

Connect OpenCode to up-to-date and token-efficient documentation.

Codex CLI

Connect Codex CLI to up-to-date and token-efficient documentation.

Gemini CLI

Connect Gemini CLI to up-to-date and token-efficient documentation.