Guide
Add document search to Kiro
After this, Kiro can answer from your own documents and quote the page it read. Kiro has a CLI for the entry, and the flags split the command from its arguments.
1. Give Kiro the tool
Paste this into a Kiro session and let it work:
Fetch https://retrievr.io/install and follow it.The key goes to ~/.config/retrievr/credentials without being printed, and the MCP server to ~/.config/retrievr/mcp.mjs.
2. Register the server
One command, with the command and its arguments as separate flags — --args takes the server path, not a node line:
kiro-cli mcp add --name retrievr --scope global \
--command node --args /home/you/.config/retrievr/mcp.mjs--scope global makes the tool available in every workspace; leave it out to keep it to this one. The path is absolute because the arguments reach node without a shell, so ~ is not expanded — echo $HOME prints the prefix to use.
That writes into ~/.kiro/settings/mcp.json. If you would rather edit the file directly, the entry it produces is the usual block:
{
"mcpServers": {
"retrievr": {
"command": "node",
"args": ["/home/you/.config/retrievr/mcp.mjs"]
}
}
}The shape is checked against Kiro’s MCP documentation.
3. Check it loaded
Open a new session and ask for the tool list. retrievr should be there with five: retrievr_search, retrievr_documents, retrievr_upload, retrievr_upload_status and retrievr_delete_document.
4. Ask it something
Add a document from your library — the first five need no payment — then ask:
In the policy, what does it say about cancellation?
Which of my documents mentions the warranty?Each passage carries its page, character range and licence, so the answer can be checked rather than trusted. The service is always ready and answers in well under a second.
When the tool does not appear
Scope is the usual cause. An entry added without --scope global belongs to the workspace it was added in, so a session in another folder has no retrievr and nothing is broken. Re-add it with the flag, or open the workspace you registered it in.
If the flags were given as one string — --args "node /path/mcp.mjs" — Kiro sees a single argument that is two words, and the server exits on start. --command takes node; --args takes the path.
What it costs
$0.01 per query, charged when it is accepted; uploading and indexing are free. The full price list, or the same guide for pi or Cursor.