Server facts
ref-tools-mcp
Project
- Author
- ref-tools
- Repository
- github.com/ref-tools/ref-tools-mcp
- Website
- ref.tools
- License
- MIT
- Category
- Developer Tools
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.