Ragmap

Try it:https://ragmap-api.web.app/browse/Start here:https://github.com/khalidsaidi/ragmap/discussions/17

Features:Registry-compatible API;semantic + keyword search(whenOPENAI_API_KEYis set, e.g. from env or your deployment’s secret manager); categories andragScore; filter byhasRemote,reachable(probe-checked for streamable-http/SSE),citations,localOnly,transport,minScore,categories.Human browse UIatragmap-api.web.app/browse— search, filter, copy Cursor/Claude config. MCP tools:rag_find_servers,rag_get_server,rag_list_categories,rag_explain_score.

curl -s "https://ragmap-api.web.app/rag/top?hasRemote=true&reachable=true&reachableMaxAgeHours=24&serverKind=retriever&limit=25" | jq .

curl -s "https://ragmap-api.web.app/rag/search?q=rag&hasRemote=true&reachable=true&reachableMaxAgeHours=24&limit=10" | jq .

curl -s "https://ragmap-api.web.app/rag/install?name=ai.filegraph%2Fdocument-processing" | jq .

curl -s "https://ragmap-api.web.app/rag/stats" | jq .

curl -s "https://ragmap-api.web.app/api/stats" | jq .

%%{init: {"theme":"base","themeVariables":{"primaryColor":"#ffffff","primaryTextColor":"#000000","primaryBorderColor":"#000000","lineColor":"#000000","secondaryColor":"#ffffff","tertiaryColor":"#ffffff","clusterBkg":"#ffffff","clusterBorder":"#000000","edgeLabelBackground":"#ffffff"},"flowchart":{"curve":"linear","nodeSpacing":75,"rankSpacing":70}}}%% flowchart TB %% Concept-only diagram (product value; no deployment/framework/datastore details) classDef mono fill:#ffffff,stroke:#000000,color:#000000,stroke-width:1px; subgraph Inputs[" "] direction LR subgraph Query["Agent-native interface"] direction TB Users["Agents + humans"]:::mono subgraph Tooling["Tool call"] direction LR Criteria["Routing constraints<br/>domain, privacy, citations,<br/>freshness, auth, limits"]:::mono Tools["MCP tools<br/>rag_find_servers<br/>rag_get_server<br/>rag_list_categories<br/>rag_explain_score"]:::mono end Users --> Criteria --> Tools end subgraph Subregistry["Subregistry (read-only)"] direction TB subgraph Ingest["Ingest"] direction LR Sources["Upstream MCP registries<br/>(official + optional)"]:::mono Sync["Sync + normalize<br/>(stable schema)"]:::mono Catalog["Enriched catalog<br/>(servers + versions)"]:::mono Sources --> Sync --> Catalog end subgraph Enrich["Enrich (adds value)"] direction LR Cap["Structured metadata<br/>domain: docs|code|web|mixed<br/>retrieval: dense|sparse|hybrid (+rerank)<br/>freshness: static|continuous (max lag)<br/>grounding: citations|provenance<br/>privacy/auth: local|remote + req|optional<br/>limits: top_k|rate|max ctx"]:::mono Trust["Trust signals (lightweight)<br/>status, reachability,<br/>schema stability, reports"]:::mono end Catalog --> Cap Catalog --> Trust end end subgraph Selection["Selection (the added value)"] direction LR Router["Router<br/>match + rank + explain"]:::mono Ranked["Ranked candidates<br/>+ reasons + connect info"]:::mono Retrieval["Chosen retrieval MCP server(s)<br/>(do retrieval)"]:::mono Router --> Ranked --> Retrieval end Tools --> Router Catalog --> Router %% Keep the layout without adding a third visible "box" around Inputs. style Inputs fill:#ffffff,stroke:#ffffff,stroke-width:0px

- apps/api: REST API + MCP registry-compatible endpoints + ingestion worker
- apps/mcp-remote: Remote MCP server (Streamable HTTP)
- packages/mcp-local: Local MCP server (stdio)
- packages/shared: Zod schemas + shared types
- docs: docs + Firebase Hosting static assets

cp .env.example .env corepack enable pnpm -r install pnpm -r dev

Optional: setOPENAI_API_KEYin.env(see.env.example) to enablesemantic searchlocally;GET /healthwill show"embeddings": true.

API:http://localhost:3000MCP remote:http://localhost:4000/mcp

curl -X POST http://localhost:3000/internal/ingest/run \ -H "Content-Type: application/json" \ -H "X-Ingest-Token: $INGEST_TOKEN" \ -d '{"mode":"full"}'

claude mcp add --transport http ragmap https://<your-mcp-domain>/mcp

- GET /embed— embeddable “Search RAG MCP servers” widget (iframe; query params:q,limit)
- GET /health(includesembeddings: true|falsewhen semantic search is on/off)
- GET /readyz
- GET /v0.1/servers
- GET /v0.1/servers/:serverName/versions
- GET /v0.1/servers/:serverName/versions/:version(supportslatest)
- GET /rag/search
- GET /rag/top(default sorted recommendations;limitmax50)
- GET /rag/install
- GET /rag/stats
- GET /rag/categories
- GET /api/stats(public usage aggregates; no PII)
- GET /api/usage-graph(HTML chart of usage)
- POST /internal/ingest/run(protected)

For hostedragmap-api.web.app,/internal/*routes are not exposed publicly.

- q(string)
- categories(comma-separated)
- minScore(0-100)
- transport(stdioorstreamable-http)
- registryType(string)
- hasRemote(trueorfalse— only servers with a remote endpoint)
- reachable(true— only servers that were recently probe-checked as reachable via streamable-http/SSE)
- reachableMaxAgeHours(optional, only withreachable=true— keep only results checked within N hours)
- citations(true— only servers that mention citations/grounding in metadata)
- localOnly(true— only stdio, no remote)

API_BASE_URL=https://ragmap-api.web.app ./scripts/smoke-public.sh MCP_URL=https://ragmap-api.web.app/mcp ./scripts/smoke-mcp.sh

- docs/DISCOVERY-LINK-CONVENTION.md— optionaldiscoveryServicein server.json so clients can show “Discover more”
- docs/AGENT-USAGE.md—for agents:discovery, REST API, MCP install (no human intervention)
- docs/DEPLOYMENT.md
- docs/OVERVIEW.md
- docs/DATA_MODEL.md
- docs/PRIVACY.md
- docs/PUBLISHING.md
- docs/GLAMA-CHECKLIST.md
- docs/GLAMA-DOCKERFILE.md
- scripts/glama-score-status.sh— print public Glama score flags (inspectable/release/usage)

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Lightning-fast RAG for AI agents. 4-layer fusion (vector, BM25, graph, metadata), ONNX Runtime, sub-200ms search, no PyTorch.

RAG Search over your content powered by Inkeep

Production-ready RAG out of the box to search and retrieve data from your own documents.

An MCP server providing semantic search capabilities for APLCart data.

MCP server for Christian scholarship and research — scripture, Greek/Hebrew word data, cross-references, patristic texts, and semantic search,

A self-hosted MCP server that indexes documentation from various sources and serves it to AI Agents with semantic search.

Access and search EPUB ebook collections using semantic vector search.

Provides full-text and semantic search over structured and unstructured data using Azure Cognitive Search.

Search a personal knowledge vault using hybrid semantic and keyword matching.

local-first semantic search in Lojban dictionaries