rtrvr.ai
DocsChrome / Cloud / API / MCP
Search docs⌘ K

Guide

Getting Started

Everything you need to go from zero to your first automation in under five minutes: on the Chrome Extension, Cloud, or API.

READ6 MIN
rtrvr.ai Overview

Retriever AI collects data, fills forms, and completes steps across websites. Describe your task in plain language. It reads the page structure to find links, fields, and buttons, then uses them to carry out your instructions.

01

Free Mode and paid plans

Free Mode includes supported AI models and Cloud browser time for tasks you start in the extension or Cloud dashboard. No AI API key or paid AI subscription is required. Sponsored cards and a daily fair-use allowance apply. Your account shows the current allowance and reset time. When you reach it, wait for the reset, use your own AI provider, or choose a paid plan. Your provider may charge for its usage.

New accounts receive 100 one-time welcome credits for paid usage. They are separate from the recurring Free Mode allowance. One schedule that runs once a day or less often, in the Cloud or in your Chrome, is included, paid from the daily allowance. More schedules, faster schedules, triggers, cookie sync, API runs, rtrvr's agent over MCP, and WhatsApp tasks require a paid plan. Browser tools that let your own AI drive your Chrome over MCP are free on every plan. Data enrichment and managed proxies can use credits separately.

On the free plan, Cloud API calls made with an API key, the MCP Cloud tools (cloud_agent, cloud_scrape, and agent or scrape when they run in Cloud), and WhatsApp tasks need a paid plan, as does running rtrvr's agent in your Chrome through API or MCP. Free Mode covers the tasks you start in the extension or Cloud dashboard. On a paid plan, API, MCP, and WhatsApp runs use credits for the resources they consume. Free Mode involves sponsored content in both the Chrome extension and Cloud, as described in the Terms and Privacy Notice. Compare plans, read the Free Mode terms, or see the Privacy Notice.

02

Three Ways to Use rtrvr.ai

Start in the extension or Cloud dashboard with Free Mode. Choose the API when your own software starts the task. Schedules, triggers, Cookie Sync, API runs, the MCP Cloud tools, WhatsApp tasks, and running rtrvr's agent in your Chrome through API or MCP require a subscription. Browser tools that let your own AI drive your Chrome over MCP are free on every plan.

PlatformBest ForGet Started
Chrome ExtensionInteractive browsing, authenticated sites, building & testing workflowsInstall from Chrome Web Store → Open side panel (Ctrl/⌃+R)
Cloud24/7 headless execution, high-volume batches, always-on monitoringExport workflows from the extension → rtrvr.ai/cloud
HTTP API & MCPBackend integration, CI/CD, Claude.ai, programmatic controlPOST to mcp.rtrvr.ai or the /agent endpoint → see API docs
03

Quick Start: Chrome Extension

  • 01

    Open the side panel: Windows Ctrl+R / Mac ⌃+R

  • 02

    Type a natural-language request, or use shortcuts: @ for tools, # for tabs, / for saved shortcuts

  • 03

    Watch the AI execute in real-time across one or many tabs: give feedback if needed

  • 04

    When a task works, save it as a Shortcut, Schedule, or Trigger for instant reuse

04

Quick Start: API

bash
curl -X POST "https://api.rtrvr.ai/agent" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": "Go to example.com and extract the main heading", "urls": ["https://example.com"] }'
05

How the Agent Works

rtrvr.ai isn't a single AI model: it's a sophisticated orchestration system. A Planning Agent receives your request, breaks it into steps, and delegates to 20+ specialized sub-agents. Each sub-agent is an expert at a specific capability.

Sub-AgentResponsibility
Action AgentClicks, typing, navigation, form interactions
Extraction AgentStructured data extraction from the DOM
Crawl AgentPagination, multi-page discovery, link following
PDF / File AgentRead PDFs, fill forms, create documents, handle uploads
Sheet AgentRead from / write to Google Sheets in parallel
Tool AgentCall MCP servers, custom JavaScript functions, external APIs
06

Models & Bring Your Own Key

Free Mode includes the supported models shown in Model Settings. You do not need your own AI subscription or API key to start. Paid plans unlock additional managed models and features; your account shows the current choices.

Save credits by bringing your own key: the "Add your LLM API" flow accepts keys from any major provider: OpenAI GPT models, Google Gemini, Meta Model API (Muse Spark), DeepSeek, OpenRouter models (MiniMax, Hunyuan, and more), or your own local/custom endpoint. You can also sign in with your ChatGPT plan directly. Keys are stored encrypted and work in cloud runs too. For Gemini specifically, typing /add-gemini-key in the extension walks you through getting a free key from Google AI Studio. If your own provider errors mid-task, the run falls back to a platform model so it completes: covered by Free Mode on the free plan while today's allowance lasts, billed in credits otherwise. Your key runs the model, so nothing deducts from the free plan's daily Free Mode allowance.

07

Files & PDFs

Drag and drop files into the chat or attach them via the toolbar. The agent has specialized capabilities for PDFs: reading content, filling form fields, and generating new documents. It can also upload attached files to web pages when prompted (e.g., "fill this job application and upload my resume").

Files the agent downloads go through Chrome's normal download flow, so in the extension they land in your browser's Downloads folder: open chrome://downloads to find them (the run's result lists each one). In cloud runs they're backed up to your Files. If a task saves several files and some are missing, Chrome probably blocked the extra automatic downloads: click the blocked-downloads icon in the address bar, choose "Always allow", and re-run. Details in Web agent → Files & PDFs.

08

Context Tips

Everything in your chat (messages, files, images) becomes context for the AI. Keeping context clean leads to better results.

  • 01

    Start fresh chats for new tasks: stale context can confuse the planner

  • 02

    Only enable the MCP/custom tools you actually need for the current task

  • 03

    Use Personal Context in settings to store persistent info (resume, company details) the agent remembers across all chats

  • 04

    Click the ✨ Enhance button (Cmd/Ctrl+P) to have a specialized model rewrite your prompt for clarity before sending

09

Getting Help

Stuck on a website or need guidance? Reach out via support@rtrvr.ai or join the active Discord community at rtrvr.ai/discord.

YOUR NEXT RUN

Run the example on a real site.

Use Chrome for the page in front of you. Use Cloud when the run should continue on a schedule or across many pages.