{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vd5uweaavz86","handle":"micro-rag-mcp","url":"https://wellknown.network/agents/micro-rag-mcp","links":{"self":"https://wellknown.network/agents/micro-rag-mcp/record.json","html":"https://wellknown.network/agents/micro-rag-mcp","markdown":"https://wellknown.network/agents/micro-rag-mcp/record.md","api":"https://wellknown.network/api/v1/agents/micro-rag-mcp","status":"https://wellknown.network/api/v1/agents/micro-rag-mcp/status","claim":"https://wellknown.network/agents/micro-rag-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/micro-rag-mcp/claim.json","badge":"https://wellknown.network/agents/micro-rag-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/micro-rag-mcp/history","tools":"https://wellknown.network/api/v1/agents/micro-rag-mcp/tools"},"ard":{"identifier":"urn:air::server:micro-rag-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"micro-rag-mcp","summary":"Minimal local RAG MCP server for document folders","description":"# micro-rag-mcp: Minimal local RAG MCP server\n\nMinimal, local Retrieval Augmented Generation indexing and search MCP server for folders of documents. Designed for multiple instances via uvx with different data folders. Stores a persistent FAISS index under each data folder in an index directory.\n\n## Goals\n- Minimal and elegant: a single stdio MCP server process with two tools: search and reindex\n- Local only: no network calls; works offline once models are downloaded\n- Fast startup: incremental indexing by file mtime with content checksum verification\n- Low footprint: sentence-transformers all-MiniLM-L6-v2, FAISS IndexFlatIP, numpy\n\n## Default behavior\n- Embeddings: sentence-transformers all-MiniLM-L6-v2\n- File types: .txt, .md, .pdf, .docx\n- Chunking: 1000 characters, 200 overlap, paragraph aware\n- Similarity: cosine via L2 normalized vectors and FAISS IndexFlatIP\n- Index location: <data_folder>/index\n- Startup: scan files and apply incremental changes to the index\n- Concurrency: simple file lock index.lock to serialize reindex operations\n- Logging: human logs to stderr; tool results are structured\n\n## Multi-instance support\n\n- You can run multiple independent MCP server instances by specifying different `--title` and `--inst` arguments for each process.\n- Both `--title` and `--inst` are **required**.\n- The `--title` is used as the FastMCP server name.\n- The `--inst` is passed verbatim as the FastMCP instructions (can be a sentence, multi-line, etc).\n- The default index location remains `<data_folder>/index` for all instances unless you override with `--index-folder`.\n\n### Example MCP config with two instances\n\n```json\n{\n  \"mcpServers\": {\n    \"team_alpha\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"micro-rag-mcp@0.1.4\",\n        \"--data-folder\", \"/docs/teamA\",\n        \"--title\", \"Secret Islands\",\n        \"--inst\", \"Team Alpha read-only mode with nightly refresh\"\n      ]\n    },\n    \"team_beta\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"micro-rag-mcp…","publisher":null,"homepage":null,"repository":null,"version":"0.1.7","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:micro-rag-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"micro-rag-mcp","registry":"pypi","observedAt":"2026-11-03T17:26:14.191Z","publishedAt":"2025-10-17T15:39:40.553885Z","latestVersion":"0.1.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"micro-rag-mcp","url":"https://pypi.org/project/micro-rag-mcp/","firstSeenAt":"2026-09-10T06:22:59.549Z","fetchedAt":"2026-11-03T17:25:44.398Z","normalizedAt":"2026-11-03T17:25:44.398Z"}]},"firstSeenAt":"2026-09-10T06:22:59.549Z","updatedAt":"2026-11-03T17:26:14.191Z"}