How do I install the pinrag mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `OPENROUTER_API_KEY`, `PINRAG_PERSIST_DIR`, `GITHUB_TOKEN`, `PINRAG_WEB_RATE_LIMIT_PER_HOST`, `PINRAG_YT_PROXY_HTTP_URL`, `PINRAG_YT_PROXY_HTTPS_URL`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Pinrag MCP Server — Tools & Setup

What is the Pinrag 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

What it actually does

Multi-format indexing — — PDF (.pdf), local files or directories, plain text (.txt), Discord export (.txt), YouTube (video or playlist URL, or video ID), GitHub repo (URL), web documentation sites (URL)
RAG with citations — — Answers cite source context: PDF page, YouTube timestamp, document name for plain text and Discord, chunk index for GitHub repos, source URL for web documentation
Document tags — — Tag documents at index time (e.g. AMIGA, PI_PICO) for filtered search
Metadata filtering — — query_tool supports document_id, tag, document_type, PDF page_min/page_max, and response_style (thorough or concise)
MCP tools — — add_document_tool, query_tool, list_documents_tool, remove_document_tool, set_document_tag_tool, list_collections_tool; optional collection on tools overrides PINRAG_COLLECTION_NAME for that call
MCP resources — — pinrag://documents (indexed documents) and pinrag://server-config (env vars and config); click in Cursor’s MCP panel to view

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Pinrag MCP Server

{
  "mcpServers": {
    "pinrag": {
      "command": "uvx",
      "args": [
        "--refresh",
        "pinrag"
      ],
      "env": {
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY",
        "PINRAG_PERSIST_DIR": "/absolute/path/to/your/pinrag-data"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
OPENROUTER_API_KEY	Declared in the maintainer’s client configuration.	Yes
PINRAG_PERSIST_DIR	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Pinrag to Multi.”
“Use Pinrag to Observability.”
“Use Pinrag to FlashRank.”

Frequently asked questions

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 Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Pinrag MCP Server

What is the Pinrag MCP Server?

What it actually does

More MCP options

How to install the Pinrag MCP Server

Configuration

Example prompts to try

Frequently asked questions

Alternatives to the Pinrag MCP Server

Filesystem

Context7

OpenOSINT

MCP Nomad

Boamp

Tree Sitter

Pinrag MCP Server

What is the Pinrag MCP Server?

What it actually does

More MCP options

How to install the Pinrag MCP Server

Configuration

Example prompts to try

Frequently asked questions

What does the pinrag mcp server do?

How do I install the pinrag mcp server?

What credentials does it need?

Alternatives to the Pinrag MCP Server

Filesystem

Context7

OpenOSINT

MCP Nomad

Boamp

Tree Sitter