Pin RAG MCP Server

PinRAG is for when you want to learn about something and your materials are scattered - PDFs and ebooks, GitHub repos, YouTube videos, Discord discussions, and plain notes. You index those materials into one shared RAG index, then ask questions from Cursor, VS Code (GitHub Copilot), or any MCP-capable assistant and get answers with citations pointing back to pages, timestamps, files, or threads.

People connecting communication tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-04-10 · ★ 2 · #74 OF 99 MAINTAINED COMMUNICATION · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Pin RAG

before you install - you'll need

Set OPENROUTER_API_KEY, PINRAG_YT_PROXY_HTTP_URL, PINRAG_YT_PROXY_HTTPS_URL before connecting. PINRAG_PERSIST_DIR is optional or environment-specific per the README.

Claude Code

claude mcp add ndjordjevic-pinrag -- uvx pinrag

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ndjordjevic-pinrag": {
      "command": "uvx",
      "args": [
        "pinrag"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package pinrag - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.ndjordjevic is GitHub-verified and matches the repo owner

03 · What Pin RAG can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.9.27 · 2026-04-09

v0.9.27 - Core refactor, verbose MCP logging, and GitHub metadata cleanup · Moves query/indexing into pinrag.core, improves MCP observability, extends LLM/YouTube options, and removes GitHub file_path metadata from…

v0.9.26 · 2026-03-29

v0.9.26 · Default chat LLM is OpenRouter (openrouter/free); langchain-openrouter added. MCP server.json requires OPENROUTER_API_KEY (OpenAI key removed from manifest). OpenRouter app attribution is synced to…

v0.9.25 · 2026-03-28

v0.9.25 - MCP registry metadata cleanup · Trims the optional ANTHROPIC_API_KEY and PINRAG_YT_VISION_ENABLED entries from published server.json environmentVariables; both remain documented in the README and…

04 · Who maintains Pin RAG

PinRAG is maintained by ndjordjevic. It's the only MCP server we track from this author; the repo dates to Jan 2026.

05 · Facts

repository: github.com/ndjordjevic/pinrag
category: communication - ranked #74 of 99 actively-maintained communication servers as of 2026-08-25.
registry: io.github.ndjordjevic/pinrag (active, first published 2026-03-21 · 26 versions)
packages: pypi:pinrag

06 · Pin RAG FAQ

What is Pin RAG?

Is Pin RAG still maintained?

Yes - as of 2026-08-25, its last commit was 2026-04-10. We re-verify nightly.

How do I install Pin RAG?

Run `uvx pinrag`. The README documents 4 environment variables (OPENROUTER_API_KEY, PINRAG_PERSIST_DIR, PINRAG_YT_PROXY_HTTP_URL…) to set first. Set OPENROUTER_API_KEY, PINRAG_YT_PROXY_HTTP_URL, PINRAG_YT_PROXY_HTTPS_URL before connecting. PINRAG_PERSIST_DIR is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Pin RAG run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Pin RAG

Alternatives to Pin RAG

Maintained communication servers if Pin RAG isn't the fit.

Pairs well with

Servers that cover what Pin RAG doesn't - only shown when the pairing reason fits the companion.

More communication MCP servers · Nestr Dev MCP Server · Ethereum & EVM Message Signing · Registry Monitor · PumpFun Claims Bot · Openfuse MCP

More Python MCP servers · Neo4j GDS Agent · Neo4j Aura Manager · Neo4j Cypher · Neo4j Data Modeling · Neo4j Memory · see all