From d62bea1cf657c920bbfe18033f16d2b28582e0af Mon Sep 17 00:00:00 2001 From: Khalid Saidi Date: Sat, 28 Feb 2026 23:52:40 -0800 Subject: [PATCH 1/2] docs: add badges, try-it links, and start-here discussion template --- README.md | 5 ++++ docs/discussions/start-here.md | 51 ++++++++++++++++++++++++++++++++++ docs/releases/v1.0.0.md | 2 ++ 3 files changed, 58 insertions(+) create mode 100644 docs/discussions/start-here.md diff --git a/README.md b/README.md index 5a3a3dc..de7151c 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,12 @@ # RAGMap (RAG MCP Registry Finder) +[![Release](https://img.shields.io/github/v/release/khalidsaidi/ragmap?display_name=tag&sort=semver)](https://github.com/khalidsaidi/ragmap/releases/latest) +[![Deploy](https://github.com/khalidsaidi/ragmap/actions/workflows/deploy.yml/badge.svg)](https://github.com/khalidsaidi/ragmap/actions/workflows/deploy.yml) +[![monitor-freshness](https://github.com/khalidsaidi/ragmap/actions/workflows/monitor-freshness.yml/badge.svg)](https://github.com/khalidsaidi/ragmap/actions/workflows/monitor-freshness.yml) [![Glama](https://glama.ai/mcp/servers/@khalidsaidi/ragmap/badge)](https://glama.ai/mcp/servers/@khalidsaidi/ragmap) +**Try it:** https://ragmap-api.web.app/browse/ + RAGMap is a lightweight MCP Registry-compatible subregistry + MCP server focused on **RAG-related MCP servers**. It: diff --git a/docs/discussions/start-here.md b/docs/discussions/start-here.md new file mode 100644 index 0000000..f88272c --- /dev/null +++ b/docs/discussions/start-here.md @@ -0,0 +1,51 @@ +# Start here: Ragmap (What it is + how to use it) + +Ragmap helps you discover MCP servers, especially retrievers/RAG servers, with **reachability you can trust**. + +**Try it:** https://ragmap-api.web.app/browse/ + +## What Ragmap is +- A discovery + trust layer for MCP servers. +- It ingests upstream registry data, enriches it for RAG use cases, and continuously probes remotes. +- It exposes: + - `/rag/top` for smart defaults. + - `/rag/search` for discovery. + - `/rag/install` for copy/paste install configs. + - `/rag/stats` for freshness + coverage visibility. + +## The one trust concept to know +If you want "reachable recently" results, use: + +- `reachable=true&reachableMaxAgeHours=24` + +This avoids "reachable at some unknown time" and instead means: **reachable and checked within the last N hours**. + +## Quickstart (copy/paste) +### Top reachable retrievers (checked within 24h) + +```bash +curl -s "https://ragmap-api.web.app/rag/top?hasRemote=true&reachable=true&reachableMaxAgeHours=24&serverKind=retriever&limit=25" | jq . +``` + +### Search with trust filter + +```bash +curl -s "https://ragmap-api.web.app/rag/search?q=rag&hasRemote=true&reachable=true&reachableMaxAgeHours=24&limit=10" | jq . +``` + +### Get install config (URL-encoded name) + +```bash +curl -s "https://ragmap-api.web.app/rag/install?name=ai.filegraph%2Fdocument-processing" | jq . +``` + +### Inspect freshness + coverage + +```bash +curl -s "https://ragmap-api.web.app/rag/stats" | jq . +``` + +## Where to post what (so we can respond fast) +- Bug: include the exact URL + query params you ran, and the JSON output. +- Feature request: describe the user story ("as an agent builder...") + what success looks like. +- New server suggestion: link to the server repo/registry entry and what category it belongs in. diff --git a/docs/releases/v1.0.0.md b/docs/releases/v1.0.0.md index 4777ba9..9b423ce 100644 --- a/docs/releases/v1.0.0.md +++ b/docs/releases/v1.0.0.md @@ -1,5 +1,7 @@ # Ragmap v1.0.0 - Reachability You Can Trust +**Try it:** https://ragmap-api.web.app/browse/ + Ragmap is a discovery + trust layer for MCP servers focused on retrieval/RAG. This release solidifies "reachable" as a meaningful signal, adds actionable install output, and introduces freshness-aware querying so results stay trustworthy. ## Highlights From 7e58f34574d6f6efd09e10ac587ed206a8a364d3 Mon Sep 17 00:00:00 2001 From: Khalid Saidi Date: Sun, 1 Mar 2026 00:14:48 -0800 Subject: [PATCH 2/2] docs: polish release/discussion formatting --- docs/discussions/start-here.md | 1 + docs/releases/v1.0.0.md | 1 + 2 files changed, 2 insertions(+) diff --git a/docs/discussions/start-here.md b/docs/discussions/start-here.md index f88272c..b6614c2 100644 --- a/docs/discussions/start-here.md +++ b/docs/discussions/start-here.md @@ -8,6 +8,7 @@ Ragmap helps you discover MCP servers, especially retrievers/RAG servers, with * - A discovery + trust layer for MCP servers. - It ingests upstream registry data, enriches it for RAG use cases, and continuously probes remotes. - It exposes: + - `/rag/top` for smart defaults. - `/rag/search` for discovery. - `/rag/install` for copy/paste install configs. diff --git a/docs/releases/v1.0.0.md b/docs/releases/v1.0.0.md index 9b423ce..917e89d 100644 --- a/docs/releases/v1.0.0.md +++ b/docs/releases/v1.0.0.md @@ -2,6 +2,7 @@ **Try it:** https://ragmap-api.web.app/browse/ + Ragmap is a discovery + trust layer for MCP servers focused on retrieval/RAG. This release solidifies "reachable" as a meaningful signal, adds actionable install output, and introduces freshness-aware querying so results stay trustworthy. ## Highlights