# Nemo Retriever MCP

> Use when a task needs to search or add documents through NeMo Retriever MCP.

- Skill: `nvidia/nemo-retriever-mcp` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx get-skill add nvidia/nemo-retriever-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nvidia/nemo-retriever-mcp/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: NVIDIA (https://skillmd.com/u/nvidia), verified publisher
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/nvidia/nemo-retriever-mcp

---


# NeMo Retriever MCP

Use the NeMo Retriever MCP tools exposed under `retriever` instead
of the `retriever` CLI.

The server exposes MCP tools, not MCP resources. Do not call
`list_mcp_resources` to discover documents or decide whether Retriever is
available; an empty MCP resource list is expected.

## Workflow

- Use `query` to search documents already available to Retriever.
- Never ingest documents that are already searchable, including documents in a
  prebuilt index.
- Use `ingest_documents` only when required documents are not yet searchable
  and server-readable paths are explicitly available. Do not assume that paths
  visible to the agent are also readable by the Retriever server.
- After ingestion completes, use `query` to retrieve evidence from the added
  documents.
- Start with `top_k=5` and `format="hits"`. Request more only when the first
  successful response does not contain enough evidence to answer the task.
- Read evidence hits from the tool response and ground your answer in them.
- Preserve available document identifiers such as `document_id`, `source_id`,
  or `pdf_basename`, along with page numbers, when the task requests citations
  or structured output.
- If `query` fails, inspect the error and retry with corrected parameters or a
  shorter equivalent query. If it still fails, report the error before using
  another retrieval method.

