pinrag: Skill for Cursor

.cursor/skills/run-pinrag-local-mcp-tool/SKILL.md

run-pinrag-local-mcp-tool is a skill for Cursor from ndjordjevic/pinrag. It costs 110 tokens per session (1,016 once invoked), scanned A, original, MIT.

A set of instructions for using PinRAG through its local MCP server. PinRAG is a document-search system that lets an AI assistant find information in indexed PDFs, files, and web pages.

In plain words
What is it for?
Use it to add, search, list, or remove PinRAG documents, including indexing PDFs, files, and URLs.
Why use it?
It provides one approved way to manage and search the documents available to the assistant. It avoids replacing the connected MCP setup with unrelated scripts or command-line shortcuts.

Skill for Cursor

Written for Cursor: installed under .cursor/.

This is ndjordjevic/pinrag's own configuration. It tells Cursor how to work on pinrag itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything pinrag configures →

Reuse

Borrowing it

Nothing to install: this file belongs to ndjordjevic/pinrag. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/ndjordjevic/pinrag/main/.cursor/skills/run-pinrag-local-mcp-tool/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/ndjordjevic/pinrag

Made for: Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for run-pinrag-local-mcp-tool

README.md
[![agentmods](https://agentmods.dev/badge/skills/ndjordjevic/pinrag/run-pinrag-local-mcp-tool/github.svg)](https://agentmods.dev/skills/ndjordjevic/pinrag/run-pinrag-local-mcp-tool)
Your own site
<a href="https://agentmods.dev/skills/ndjordjevic/pinrag/run-pinrag-local-mcp-tool"><img src="https://agentmods.dev/badge/skills/ndjordjevic/pinrag/run-pinrag-local-mcp-tool/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for run-pinrag-local-mcp-tool

Your own site · 80×15
<a href="https://agentmods.dev/skills/ndjordjevic/pinrag/run-pinrag-local-mcp-tool"><img src="https://agentmods.dev/badge/skills/ndjordjevic/pinrag/run-pinrag-local-mcp-tool.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 110 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,016 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00110 $0.01016
Opus 5 $0.00055 $0.00508
Sonnet 5 $0.00022 $0.00203
Haiku 4.5 $0.00011 $0.00102

Measured 12d ago against content hash a533085b1dfa, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

run-pinrag-local-mcp-tool scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/skills/run-pinrag-local-mcp-tool/SKILL.md · 62 lines

How it starts

The opening of the file, as written. The whole thing — 62 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Run PinRAG local MCP tools (not Python)

Non-negotiable

  • Use call_mcp_tool with PinRAG’s MCP tools: add_document_tool, query_tool, list_documents_tool, remove_document_tool.
  • Do not implement indexing or querying with Python (python -c, ad-hoc scripts, LangChain/Chroma calls, or pinrag/uv run in the terminal) unless the user explicitly asks for scripts, debugging, or automation outside the editor MCP.
  • Do not skip MCP because “it’s faster to script”—the user’s editor and PINRAG_PERSIST_DIR are wired through the MCP server process.

How to find which PinRAG MCP is “active”

Cursor exposes one server id per mcp.json entry. The id you pass to call_mcp_tool is:

user- + the exact key of that entry in ~/.cursor/mcp.json (hyphens preserved).

Examples:

Typical mcp.json key call_mcp_tool server value
pinrag-dev user-pinrag-dev
io-github-ndjordjevic-pinrag user-io-github-ndjordjevic-pinrag
pinrag-pypi-from-link user-pinrag-pypi-from-link

Discovery (pick one):

  1. Workspace MCP descriptors (best): Under the Cursor project’s MCP folder (see system MCP instructions), look for folders mcps/user-*/tools/ that contain add_document_tool.json. The folder name (e.g. user-io-github-ndjordjevic-pinrag) is the server string for call_mcp_tool.
  2. ~/.cursor/mcp.json: Find entries whose command/args run PinRAG (pinrag, uvx with args containing --refresh and pinrag, or uv run … pinrag). Each top-level key under mcpServers maps to user-<that-key>.

If several PinRAG servers appear:

  • If the user names one (e.g. “use the marketplace / io-github pinrag”), use that key’s user-… id.
  • Otherwise use one server that has the tools (prefer the one they used recently or the least ambiguous name); if unsure, ask which MCP entry to use.

Before the first call: Read the tool descriptor JSON under mcps/<server>/tools/<tool>.json for required parameters (per MCP instructions).

Read the full file on GitHub · 62 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 62 lines · 110 tokens per session scan A a533085b1dfa

Subscribe to this mod's changes

run-pinrag-local-mcp-tool is a skill published in the GitHub repository ndjordjevic/pinrag (2 stars, last pushed 5mo ago), licensed MIT. It adds 110 tokens to every session and 1,016 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

RAG Chunking Strategy Advisor

Given a document type and retrieval goal, recommends the optimal chunking strategy for a RAG pipeline to minimize retrieval failures.

Notysoty/openagentskills · 31 tokens

convert-document-for-rag-ingestion

Convert a document to clean markdown suitable for chunking and embedding in a RAG pipeline.

iterationlayer/skills · 26 tokens

nutrient-ai-assistant

Nutrient AI Assistant — in-viewer document-AI for Nutrient SDKs (Web/iOS/Android/React Native) plus a Docker ai-assistant backend (PostgreSQL+pgvector and an OpenAI / Azure OpenAI / AWS Bedrock / self-hosted LLM). Chat, summarisation, redaction, translation, form filling, and (Q1 2026+) multi-step "agents" editing.…

PSPDFKit-labs/nutrient-skills · 157 tokens

mvp

Goal: Build an LLM-based RAG App Here is the MVP Implementation Plan.

Harmeet10000/skills · 0 tokens

grounded-rag-ingestion

Chunk a document into provenance-carrying JSONL ready for embedding via the Nutrient Data Extraction API (/extraction/parse, spatial output). Every chunk carries element type, page index, bounding box, confidence, and reading order, traceable to a specific page region. Use for grounded or auditable RAG, cited…

PSPDFKit-labs/nutrient-skills · 204 tokens

markitdown

Convert heterogeneous documents and selected URIs to Markdown with Microsoft MarkItDown for text analysis, search, and LLM/RAG ingestion. Covers safe local conversion, streams, Office/PDF/data formats, batch workflows, plugins, vision OCR, Azure extraction, and the official MCP server.

K-Dense-AI/scientific-agent-skills · 61 tokens