Ref MCP

Name: Ref MCP
Author: ref-tools

@ref-tools

代码仓库主页

关于 Ref MCP

Helping coding agents never make mistakes working with public or private libraries without wasting the context window.

#documentation #docs #llm #mcp

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

ref-tools

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "Ref": {
      "command": "npx",
      "args": [
        "ref-tools-mcp@latest"
      ],
      "env": {
        "REF_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Ref MCP?

Ref MCP is a Model Context Protocol server that gives your AI coding tool or agent access to documentation for APIs, services, and libraries. It is designed for developers using LLM-based coding agents who need fast, token‑efficient access to up‑to‑date documentation.

How to use Ref MCP?

Install via npm (npx ref-tools-mcp) or connect via the streamable HTTP server at api.ref.tools/mcp. Use the tools ref_search_documentation (with a query string) and ref_read_url (with a URL) to search and fetch documentation.

Key features of Ref MCP

Deduplicates search results within a session.
Returns only the most relevant 5k tokens per page.
Reduces context rot by minimizing irrelevant tokens.
Supports both streamable HTTP and stdio transports.
Works as a documentation source for OpenAI deep research.
Tracks search trajectory across MCP sessions.

Use cases of Ref MCP

Querying API documentation for a specific endpoint.
Fetching library usage examples with minimal token cost.
Keeping an AI coding agent updated on multi‑step workflows.
Reducing costs by pulling only relevant parts of large docs.
Supporting research workflows that need repeated refined searches.

FAQ from Ref MCP

What exactly does Ref MCP do?

It provides two tools: ref_search_documentation searches for relevant documentation based on a natural language query, and ref_read_url fetches the content of a URL, converting it to markdown and returning the most relevant portion (up to 5k tokens).

How do I get an API key?

What transports does Ref MCP support?

Two transport options: streamable HTTP (recommended) and local stdio. The HTTP server URL is https://api.ref.tools/mcp?apiKey=YOUR_API_KEY; the stdio command is npx ref-tools-mcp@latest with the environment variable REF_API_KEY.

How does Ref MCP minimize token usage?

It deduplicates repeated search results in a session and fetches only the most relevant 5k token portion of a page based on the agent’s search history, avoiding the common problem of pulling 20k+ irrelevant tokens from large documentation pages.

Why is minimizing token context important for AI agents?

More context can make models less accurate (context rot), and extra tokens cost money—for example, 6k irrelevant tokens in a step using Claude Opus can waste ~$0.09 per step, adding up across multiple steps.