# Ref Tools MCP

Ref Tools MCP is a Model Context Protocol (MCP) server that connects AI coding tools and agents to documentation for APIs, services, and libraries. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6600/ref-tools-mcp

## Description

Ref Tools MCP is a Model Context Protocol (MCP) server that connects AI coding tools and agents to documentation for APIs, services, and libraries. It performs fast, token-efficient agentic search to provide exactly the context a developer or agent needs, helping code generation stay accurate and up to date.

## Platform availability

Available on 0 of 10 platforms.

## Health score

48/100 (Fair), based on 5 of 5 factors.
- Maintained: 75 (last commit 15 days ago)
- Popular: 61 (1,186 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 20 (16 GB minimum RAM, runs on ARM)
- Security check: 20 (1 serious finding, 6 minor, CI)

## Security check

1 serious finding: Uses shell-quote 1.10.0, which has a known critical vulnerability.
Automated checks on commit f5feb82, 26 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/ref-tools/ref-tools-mcp
- Docker Hub: https://hub.docker.com/r/mcp/ref-tools-mcp
- Official website: http://ref.tools

## Common questions

### What credential must be configured before Ref Tools MCP can search documentation?

Replace the API key placeholder with a real Ref API key from ref.tools/keys. Without a valid key, Ref cannot authenticate and its documentation search tools will not work.

### How do I choose the correct Ref team when using OAuth sign-in?

If you belong to multiple teams, add scope=user or scope=t-team_id to the Ref URL. This stops Ref from guessing the wrong account or team.

### How do I confirm the Ref MCP connection is working in Amp?

Run amp mcp doctor after adding the MCP. It catches typos or missing keys before you rely on Ref.

### Does the server aim to limit the amount of documentation context sent to the model?

Yes, it performs fast, token-efficient agentic search to provide only the documentation context an agent needs.

---
Source: Our Local Host (https://ourlocalhost.com/app/6600/ref-tools-mcp), the self-hosted and open-source app directory.
