Cuiar
Sign inDownload

Gemini + Cuiar

One search, seen from three markets.

  • Gemini CLI, agy or the app
  • httpUrl, serverUrl or a custom app
  • Works with gemini -p
Set it up Get Cuiar

Search results and prices change with the country, the cookies and the account. Give Gemini three Cuiar workspaces, one per market, each with its own proxy.

Gemini then reads each market as a local visitor. It reads your ad dashboards with the saved logins, and Odyssey does the long research.

Three search pages fan out, one for each market workspace: Germany, France and the US. In each, a bar marks the rank of the user's brand: third, seventh and first.

Setup

Three Gemini tools, three ways in.

Pick the one you use. Since 18 June 2026, Gemini CLI serves paid API keys and enterprise licenses. Personal Google accounts use Antigravity CLI.

  1. 1

    Gemini CLI

    Run this in your shell, then start gemini. The browser opens the cuiar.com sign-in. /mcp auth cuiar signs in again.

    gemini mcp add --transport http --scope user cuiar https://mcp.cuiar.com/mcp
  2. 2

    Or edit settings.json

    Use httpUrl. The key url means SSE, and Cuiar serves streamable HTTP.

    ~/.gemini/settings.json
    {
  "mcpServers": {
    "cuiar": { "httpUrl": "https://mcp.cuiar.com/mcp" }
  }
}
  3. 3

    Antigravity CLI

    agy registers itself with Cuiar and signs in on its own. /mcp shows the status.

    ~/.gemini/config/mcp_config.json
    {
  "mcpServers": {
    "cuiar": { "serverUrl": "https://mcp.cuiar.com/mcp" }
  }
}
  4. 4

    Gemini app

    On gemini.google.com, open Settings, Connected Apps, Custom apps, Add a custom app. Enter the URL and sign in on cuiar.com. It then works in the mobile app too.

Other ways to connect

  • An API key in Gemini CLI

    Use a key with the mcp scope.

    gemini mcp add --transport http --scope user \
  --header "Authorization: Bearer cuiar_..." cuiar https://mcp.cuiar.com/mcp

  • Headless runs

    With -p, Gemini CLI refuses tool calls that need a confirmation. Mark the server as trusted.

    ~/.gemini/settings.json
    {
  "mcpServers": {
    "cuiar": { "httpUrl": "https://mcp.cuiar.com/mcp", "trust": true }
  }
}

Route

One URL for the terminal and the phone.

Gemini CLI, Antigravity CLI and the Gemini app all speak remote MCP with OAuth. Gemini's own steps use no Cuiar credits.

Remote MCPmcp.cuiar.com/mcp
Best fit
httpUrl in Gemini CLI, serverUrl in agy, a custom app in the Gemini app.
Local MCPcuiar mcp
Works
Gemini CLI and agy only.
CLIcuiar exec
Works
Gemini CLI runs cuiar with run_shell_command.
Routineson a schedule
Works
Gemini CLI has no scheduler. A Cuiar routine runs the daily check in the app. agy has /schedule.

Example tasks

Market research with real visitors

  • 01

    Rank per market

    “Make three Cuiar workspaces, de-market, fr-market and us-market, each with a proxy in its country. In each, search waterproof running shoes, record the top 10 results and the ads, and show where our brand ranks.”

    create_workspace takes a proxy URL.

  • 02

    Build a price table

    “In my Retail workspace, open the Trailrunner 2 pages of these six shops. Read price, stock, shipping cost and delivery time, and give me a table to paste into Google Sheets.”

  • 03

    Group bad reviews

    cuiar --permission read-only "Collect each 1- and 2-star review from the last 30 days on our G2, Capterra and Trustpilot pages. Group them by topic and quote three per topic."

  • 04

    Flag ad overspend

    cuiar routines create "Ad check" --schedule "0 8 * * 1-5" --time-zone Europe/Berlin \
  "Sign in to Google Ads and Meta Ads Manager. Read yesterday's spend per campaign and flag each campaign more than 20% over its daily budget."

    The vault signs in. The result comes by email.

  • 05

    Map a category

    cuiar --odyssey --permission read-only "Research the pricing pages of the 12 main tools in our category. Record plans, prices, limits and each change since July, with links."

    Odyssey is on Pro and Team.

Good to know

Gemini app limits
Custom apps need age 18 or more, the US, a personal Google Account, English and Keep Activity on. Gemini asks you before each write action.
No extension
Cuiar has no Gemini CLI extension. Use gemini mcp add.

Templates to run from Gemini

All templates

Each template page shows the run_task or create_routine call to give Gemini.

  • ShoppingAsks first

    Buy a gift from a wedding registry

    An item from the registry that fits your budget, with a gift note. The payment waits for your approval.

    You start it: When you start it
    • Any online store

  • Shopping

    List the orders I can still return

    Each recent purchase with its last return date and the return cost, the nearest deadline first.

    You start it: When you start it
    • Gmail
    • Any online store
    • Google Sheets

  • Shopping

    Check if a sale price is a real deal

    The price history and other stores' prices, and whether the discount is real.

    You start it: When you start it
    • Amazon
    • Google Shopping
    • Any website

  • Shopping

    Compare a grocery basket across stores

    Your list priced at each store with all fees, and the cheapest store for the whole basket.

    You start it: When you start it
    • Instacart
    • Walmart
    • Any online store
    • +1 more: Google Sheets

  • TravelAsks first

    Book train tickets for a trip

    The best trains for your times, with the cheapest fare and seats. The booking waits for your approval.

    You start it: When you start it
    • Trainline
    • Any booking site
    • Google Drive

  • TravelAsks first

    Book a restaurant table at my destination

    Well-rated places near you that fit your taste, with free tables. The booking waits for your approval.

    You start it: When you start it
    • OpenTable
    • Google Maps
    • Tripadvisor
    • +1 more: Google Calendar

More agents

All AI agents

Start on the Free plan.

The MCP server, the vault and unlimited routines are free. Steps that your own agent takes use no Cuiar credits.

Get CuiarDeveloper docs