Skip to content
MCP server

Ref Tools MCP

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

Runs locallyStatus and history
Pricing
Open source
Runs
Locally
Version
3.0.1
Listing updated
4 days ago

About Ref Tools MCP

Ref Tools MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add ref-tools-mcp --env REF_API_KEY='<REF_API_KEY>' -- npx -y ref-tools-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • REF_API_KEYYour API key for RefRequired

Pricing

Open source

Ref Tools MCP FAQ

Is Ref Tools MCP free?

Yes. Ref Tools MCP is open source, so you can use and self-host it for free.

How do I add Ref Tools MCP to Claude Code?

Run this command in your terminal: claude mcp add ref-tools-mcp --env REF_API_KEY='<REF_API_KEY>' -- npx -y ref-tools-mcp