Ref - Up-To-Date Docs

Ref - Up-To-Date Docs MCP Server

Ref powerful search tool connets your coding tools with documentation context. It includes an up-to-date index of public documentation and it can ingest your private documentation (eg. GitHub repos, PDFs) as well.

What is an MCP Server?

MCP Info

Attribute	Details
Docker Image	mcp/ref-tools-mcp
Author	ref-tools
Repository	https://github.com/ref-tools/ref-tools-mcp

Image Building Info

Attribute	Details
Dockerfile	https://github.com/ref-tools/ref-tools-mcp/blob/83970a35627785a0589ae2dbe5510b4a3dd04146/Dockerfile
Commit	`83970a35627785a0589ae2dbe5510b4a3dd04146`
Docker Image built by	Docker Inc.
Docker Scout Health Score	Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/ref-tools-mcp --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	MIT License

Available Tools (2)

Tools provided by this Server	Short Description
`ref_read_url`	A tool that fetches content from a URL and converts it to markdown for easy reading with Ref.
`ref_search_documentation`	A powerful search tool to check technical documentation.

Tools Details

Tool: `ref_read_url`

A tool that fetches content from a URL and converts it to markdown for easy reading with Ref.

This is powerful when used in conjunction with the ref_search_documentation or ref_search_web tool that return urls of relevant content.

Parameters	Type	Description
`url`	`string`	The URL of the webpage to read.

Tool: `ref_search_documentation`

A powerful search tool to check technical documentation. Great for finding facts or code snippets. Can be used to search for public documentation on the web or github as well from private resources like repos and pdfs.

Parameters	Type	Description
`query`	`string`	Query to search for relevant documentation. This should be a full sentence or question.
`keyWords`	`array` optional	A list of keywords to use for the search like you would use for grep
`source`	`string` optional	Defaults to 'all'. 'public' is used when the user is asking about a public API or library. 'private' is used when the user is asking about their own private repo or pdfs. 'web' is use only as a fallback when 'public' has failed.

Use this MCP Server

{
  "mcpServers": {
    "ref": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REF_API_KEY",
        "mcp/ref-tools-mcp"
      ],
      "env": {
        "REF_API_KEY": "ref-abcdefghi123"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?