ref-tools-mcp

Ref Tools MCP Server

Ref brings API, service, and library documentation into coding-agent workflows. Its search and reading tools cover public and private sources, using session history to filter repeated results and focus retrieved content.

Server facts

ref-tools-mcp

Project

Author
ref-tools
Website
ref.tools
License
MIT

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
1,182
Last commit
Data as of

Tags

  • Documentation
  • docs
  • llm
  • mcp

Overview

Documentation lookup in Ref follows a search-and-read workflow for coding agents working with APIs, services, and libraries. The ref_search_documentation tool accepts a question or sentence and locates technical material, including facts and code examples, across the web, GitHub, and private repositories or PDFs. Agents can then pass a returned URL to ref_read_url to retrieve its content as Markdown. This supports both direct lookups and investigations where an agent revises its question after reading an initial source.

Ref uses MCP session history to shape subsequent retrieval. Similar searches within a session omit results already returned, allowing an agent to explore further while changing its query. Page reading also uses that history to select relevant sections rather than returning an entire documentation page. This repository contains the legacy Node-based stdio implementation; the documentation recommends a separate streamable HTTP option. For OpenAI deep research clients, the documentation tools are exposed under the names search and fetch. The project is MIT-licensed.

ref-tools-mcp setup notes

  • ref-tools-mcp records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers