ref-tools-mcp
local MCP serverref-tools-mcp is a local MCP server: Token efficient search for coding agents over public and private documentation. Install it from npm as ref-tools-mcp.
Installation
Terminal
claude mcp add ref-tools-mcp -e REF_API_KEY=... -- npx -y ref-tools-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"ref-tools-mcp": {
"command": "npx",
"args": [
"-y",
"ref-tools-mcp"
],
"env": {
"REF_API_KEY": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Node.js 18+ (runs with npx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
REF_API_KEY
Summary
Token efficient search for coding agents over public and private documentation.
ref-tools-mcp vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| ref-tools-mcp | 1,176 | Local | Yes | npm |
| ref-tools-mcp | 1,176 | Hosted | No | None |
| ref-tools-ref-tools-mcp | 1,176 | Hosted | Yes | None |
| Repomix | 29K | Local | No | npm |
| jCodemunch MCP | 2,716 | Local | No | pypi |
Questions
It reads one environment variable: REF_API_KEY. Set them in your MCP config before starting the server.
Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
ref-tools-mcp is a local MCP server distributed as the npm package ref-tools-mcp.
Run: claude mcp add ref-tools-mcp -e REF_API_KEY=... -- npx -y ref-tools-mcp
Run: codex mcp add ref-tools-mcp --env REF_API_KEY=... -- npx -y ref-tools-mcp
Similar MCP servers
NameStars
- ref-tools-mcptools.ref/ref-tools-mcp1,176
- ref-tools-ref-tools-mcpai.smithery/ref-tools-ref-tools-mcp1,176
- Repomixio.github.yamadashy/repomix29K
- jCodemunch MCPio.github.jgravelle/jcodemunch-mcp2,716
- fastCRWio.github.us/fastcrw1,079
- Hex Lineio.github.levnikolaevich/hex-line-mcp565
- misakanetio.github.Ikalus1988/misakanet514
- contextio.github.neuledge/context412