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.