Claude MarketplacesSubmit
ref-tools avatar

Ref Tools Ref Tools Mcp

ref-tools/ref-tools-mcp

Ref Tools MCP provides AI coding agents and tools with efficient access to API and service documentation through semantic search and intelligent content extraction. The server offers two primary tools: a search function that finds relevant documentation pages while filtering out previously returned results within a session, and a read function that extracts the most contextually relevant sections from documentation pages based on search history. This approach minimizes token usage and context rot by delivering precisely targeted documentation excerpts rather than full pages, enabling agents to iteratively refine searches and gather only the information needed for successful code generation.

GitHub stars
1.1K
tools
2
auth
Secret needed
transport
HTTP
last updated
Oct 28, 2025
View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

ref_search_documentationSearch for documentation on the web or github as well from private resources like repos and pdfs. Use Ref 'ref_read_url' to read the content of a url.1 params

Search for documentation on the web or github as well from private resources like repos and pdfs. Use Ref 'ref_read_url' to read the content of a url.

Parameters* required
querystring
Query for documentation. Should include programming language and framework or library names. Searches public only docs by default, include ref_src=private to search a user's private docs.
ref_read_urlRead the content of a url as markdown. The EXACT url from a 'ref_search_documentation' result should be passed to this tool.1 params

Read the content of a url as markdown. The EXACT url from a 'ref_search_documentation' result should be passed to this tool.

Parameters* required
urlstring
The URL of the webpage to read.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

Documentation for your agent smithery badge Website License npm version

Ref MCP

A ModelContextProtocol server that gives your AI coding tool or agent access to documentation for APIs, services, libraries etc. It's your one-stop-shop to keep your agent up-to-date on documentation in a fast and token-efficient way.

For more see info ref.tools

Agentic search for exactly the right context

Ref's tools are designed to match how models search while using as little context as possible to reduce context rot. The goal is to find exactly the context your coding agent needs to be successful while using minimum tokens.

View the full README on GitHub

Details

Repository
github.com/ref-tools/ref-tools-mcp
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from ref-tools