ref-tools/ref-tools-mcp

latest · 3.0.1

Token efficient search for coding agents over public and private documentation.

GitHub: ref-tools/ref-tools-mcp
npm: ref-tools-mcp
MCP registry: io.github.ref-tools/ref-tools-mcp

Install

Needs an env var: REF_API_KEY — replace the <placeholders> with your values.

claude mcp add io-github-ref-tools-ref-tools-mcp --env REF_API_KEY=<REF_API_KEY> -- npx ref-tools-mcp

/mcp confirms it's connected.

Install

Or add it manually in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "io-github-ref-tools-ref-tools-mcp": {
      "command": "npx",
      "args": [
        "ref-tools-mcp"
      ],
      "env": {
        "REF_API_KEY": "<REF_API_KEY>"
      }
    }
  }
}

In claude_desktop_config.json (Settings → Developer → Edit Config), then restart:

{
  "mcpServers": {
    "io-github-ref-tools-ref-tools-mcp": {
      "command": "npx",
      "args": [
        "ref-tools-mcp"
      ],
      "env": {
        "REF_API_KEY": "<REF_API_KEY>"
      }
    }
  }
}

Config entry, any MCP client:

{
  "command": "npx",
  "args": [
    "ref-tools-mcp"
  ],
  "env": {
    "REF_API_KEY": "<REF_API_KEY>"
  }
}

Community score

Community60/ 100

from web signals · no reviews yet · 1 mention · 2 reactions (community v3)

Web signals (ecosystem baseline)60/100 · 100% of the weight

Used it? Rate v3.0.1

No reviews yet — be the first.

What the web says

Ecosystem baseline60/ 100

Objective public usage & activity (formula v3) — the community score's web-signals input, and its own sort.

GitHubsource ↗

GitHub stars · 10 days ago: ★ 1.2K
Last commit · 10 days ago: 7 days ago
Issue close rate · 10 days ago: 69%
License · 10 days ago: MIT

Packages

No package-registry data collected yet.

Listed on

Not yet found on other registries or list sites.

Mentions

Quotes1

Docker image doesn't work with Docker MCP Gateway (TRANSPORT=http hardcoded) ↗
Hi Team I was trying to use the Ref MCP server through Docker MCP Toolkit/Gateway (the new Docker Desktop feature for managing MCP servers), and ran into an issue where it just times out every time. What's happening Docker MCP Gateway expec…
GitHub issue · @mikecfisher · 2 reactions · 100% positive

Docs & liveness

No liveness or verification signals yet.

Version history1

3.0.1release date unknown

Badge for your README

Shows this page's community score and its sample, kept current, and links readers here to review.

[![rateme12 community score](https://api.rateme12.com/servers/7c04a0f3-fcdc-4c34-b900-8a46e5907989/badge.svg)](https://rateme12.com/servers/7c04a0f3-fcdc-4c34-b900-8a46e5907989)

Details

Transport: stdio
Status: listed
Source: Imported from the MCP registry
Repository: source ↗