home / mcp / ragmap mcp server

RAGMap MCP Server

Provides discovery, routing, and access to RAG-focused MCP servers for efficient retrieval tasks.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "khalidsaidi-ragmap": {
      "url": "https://<your-mcp-domain>/mcp",
      "headers": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

RAGMap provides a subregistry of MCP servers focused on RAG use cases, offering discovery, routing, and a remote MCP server interface so you can locate and connect to the most suitable retrieval tool for your task.

How to use

You interact with RAGMap by first discovering candidates that can perform retrieval, then selecting the best match for your constraints. Use the HTTP API to browse servers, check availability, and inspect scores and metadata. Once you identify a server, you connect your agent to it and perform the retrieval step within your RAG workflow.

Key operations you’ll use include filtering by remote availability, reachability, and performance scores, inspecting server categories, and understanding why a particular server was chosen via reasoned explanations. The system exposes endpoints for listing servers, their versions, and categories, plus a search interface to find servers that match your needs.

How to install

Prerequisites: you need Node.js and a package manager to run the local MCP server and the ingestion tooling. Ensure you have a working environment for JavaScript/TypeScript development and a suitable runtime for the chosen installation path.

Install the local MCP server and run it in your environment using the provided commands.

Additional notes

Two primary installation paths are provided. You can run a local stdio MCP server for development or connect to a remote MCP server via HTTP. The local flow includes a reusable package that can be executed with a simple command, or you can run the local dev script from the monorepo to start the server in development mode.

Available tools

rag_find_servers

Discover retrieval MCP servers that match specified constraints and preferences.

rag_get_server

Retrieve detailed information about a specific MCP server, including versions and capabilities.

rag_list_categories

List available categories of MCP servers to help narrow down the search space.

rag_explain_score

Explain why a server was selected, including ranking criteria and rationale.