
PinRAG
You index scattered learning materials into one RAG corpus, then query from Cursor, VS Code, or any MCP client. It handles PDFs, GitHub repos, YouTube videos (with optional vision that merges on-screen code and diagrams into transcript chunks), Discord exports, and web docs. Built on LangChain and Chroma with local Nomic embeddings. Five tools cover add, query, list, remove, and tag operations. Query filters by document ID, tag, type, or PDF page range. Citations point to page numbers, timestamps, file names, or URLs. Runs via uvx with OpenRouter by default, but you can swap in OpenAI, Anthropic, or Cerebras. Supports FlashRank reranking, multi-query expansion, and LangSmith tracing through env vars.
- GitHub stars
- 1
- tools
- 5
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Apr 9, 2026
Tools
5 toolsPublic tool metadata for what this MCP can expose to an agent.
query_toolNatural-language question; optional filters narrow retrieval ("" / omit when unused).
Natural-language question; optional filters narrow retrieval ("" / omit when unused).
No parameter schema in public metadata yet.
add_document_toolIndex locals (PDF, plain or Discord .txt, directories), YouTube (video URL, playlist URL, or bare id), GitHub URLs (scheme optional), or web documentation sites (any http(s) URL).
Index locals (PDF, plain or Discord .txt, directories), YouTube (video URL, playlist URL, or bare id), GitHub URLs (scheme optional), or web documentation sites (any http(s) URL).
No parameter schema in public metadata yet.
list_documents_toolReturns documents, total_chunks, persist_directory, collection_name, and document_details (tags, titles, counts, aggregated bytes when present, upload_timestamp, etc.).
Returns documents, total_chunks, persist_directory, collection_name, and document_details (tags, titles, counts, aggregated bytes when present, upload_timestamp, etc.).
No parameter schema in public metadata yet.
remove_document_toolDeletes every chunk for document_id.
Deletes every chunk for document_id.
No parameter schema in public metadata yet.
set_document_tag_toolSets or replaces the tag on every indexed chunk for one document.
Sets or replaces the tag on every indexed chunk for one document.
No parameter schema in public metadata yet.
Sponsors
Configuration
OPENROUTER_API_KEY*secretOpenRouter API key — required for the default chat LLM (PINRAG_LLM_PROVIDER defaults to openrouter). Get a key at openrouter.ai.
PINRAG_PERSIST_DIRAbsolute path to the Chroma vector store directory (recommended so indexes are not tied to the server process cwd).
Readme
Details
- Repository
- github.com/ndjordjevic/pinrag
- Categories
- AI & LLM Tools, Communication & Messaging, Search & Web Crawling, Media & Entertainment
- Package
pinrag- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active