Skip to content
MCP server

PinRAG

MCP RAG: index PDFs, repos, YouTube, Discord, text; optional YouTube vision; query with…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.9.27
Listing updated
5 days ago

About PinRAG

PinRAG is an open-source MCP server. It runs locally on your machine and is started by your AI client.

MCP RAG: index PDFs, repos, YouTube, Discord, text; optional YouTube vision; query with citations.

Install

Run in a terminal

claude mcp add pinrag --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx pinrag

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pinrag": {
      "command": "uvx",
      "args": [
        "pinrag"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pinrag": {
      "command": "uvx",
      "args": [
        "pinrag"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pinrag": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pinrag"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pinrag": {
      "command": "uvx",
      "args": [
        "pinrag"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pinrag": {
      "command": "uvx",
      "args": [
        "pinrag"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENROUTER_API_KEYOpenRouter API key — required for the default chat LLM (PINRAG_LLM_PROVIDER defaults to openrouter). Get a key at openrouter.ai.Required
  • PINRAG_PERSIST_DIRAbsolute path to the Chroma vector store directory (recommended so indexes are not tied to the server process cwd).

Pricing

Open source

PinRAG FAQ

Is PinRAG free?

Yes. PinRAG is open source, so you can use and self-host it for free.

How do I add PinRAG to Claude Code?

Run this command in your terminal: claude mcp add pinrag --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx pinrag

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers