Skip to main content
Glama

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

Setup

There are two options for setting up Ref as an MCP server, either via the streamable-http server (experimental) or local stdio server.

This repo contains the legacy stdio server.

"Ref": { "command": "npx", "args": [ "-y", "mcp-remote@0.1.0-0", "https://api.ref.tools/mcp", "--header=x-ref-api-key:<sign up to get an api key>" ] } }

stdio

"Ref": { "command": "npx", "args": ["ref-tools-mcp"], "env": { "REF_API_KEY": <sign up to get an api key> } }

As of April 2025, MCP supports streamable HTTP servers. Ref implements this but not all clients support it yet so the most reliable approach is to use mcp-remote as a local proxy. If you know your client supports streamable HTTP servers, feel free to use https://api.ref.tools/mcp directly.

Note for former alpha users: REF_ALPHA config is still supported. You'll be notified if you need to update.

Tools

Ref MCP server provides all the documentation related tools for your agent needs.

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:

  • query (required): Query to search for relevant documentation. This should be a full sentence or question.
  • keyWords (optional): A list of keywords to use for the search like you would use for grep.
  • source (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.

Note: When source is set to 'web', this tool will perform web search to find relevant information online.

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 tool that returns urls of relevant content.

Parameters:

  • url (required): The URL of the webpage to read.

Development

npm install npm run dev

Running with Inspector

For development and debugging purposes, you can use the MCP Inspector tool. The Inspector provides a visual interface for testing and monitoring MCP server interactions.

Visit the Inspector documentation for detailed setup instructions.

To test locally with Inspector:

npm run inspect

Or run both the watcher and inspector:

npm run dev

Local Development

  1. Clone the repository
  2. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. For development with auto-rebuilding:
npm run watch

License

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Ref

  1. Setup
    1. Streamable HTTP (recommended)
    2. stdio
  2. Tools
    1. ref_search_documentation
    2. ref_read_url
  3. Development
    1. Running with Inspector
    2. Local Development
  4. License

    Related MCP Servers

    View all related MCP servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ref-tools/ref-tools-mcp'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server