Cuiar
Sign inDownload

MCP Server + Cuiar

One URL for any MCP client.

  • Streamable HTTP
  • OAuth 2.1 with PKCE
  • Every Cuiar plan
Set it up Get Cuiar

Your client is not on this list? If it speaks MCP, it can drive Cuiar. Add the URL and sign in on cuiar.com.

Your model gets 22 tools: workspaces, tabs, page steps, vault sign-in, routines and the Cuiar agent itself. Your AI plan pays for the model, and Cuiar does the browser work.

A protocol view. The client sends tools/list, and 22 tool names light up in a grid. Then it calls snapshot, and an accessibility tree comes back with refs. A click on ref e14 follows.

Setup

Three ways to connect.

Each way needs the Cuiar app open and signed in on your computer.

  1. 1

    Remote, with OAuth

    Add the URL as a remote server. Cuiar supports dynamic client registration and PKCE, so the client registers itself and opens cuiar.com.

    https://mcp.cuiar.com/mcp
  2. 2

    Remote, with an API key

    For a client that sends headers and has no OAuth. Make a key with the mcp scope, then send it as a Bearer token.

    {
  "mcpServers": {
    "cuiar": {
      "url": "https://mcp.cuiar.com/mcp",
      "headers": { "Authorization": "Bearer cuiar_..." }
    }
  }
}
  3. 3

    Local, over stdio

    For a client that starts only local servers. Install the CLI and sign in, then point the client at cuiar mcp.

    {
  "mcpServers": {
    "cuiar": { "command": "cuiar", "args": ["mcp"] }
  }
}

Other ways to connect

  • Make the key

    On the account page, or with the CLI. Cuiar shows each key one time only.

    cuiar keys create my-client --scope mcp

  • VS Code

    VS Code uses the top key servers and opens the browser on the first connect.

    .vscode/mcp.json
    {
  "servers": {
    "cuiar": { "type": "http", "url": "https://mcp.cuiar.com/mcp" }
  }
}

Route

OAuth needs no install and no key.

With remote OAuth, the client keeps a one-hour access token and renews it. There is nothing to install and no key to store.

Remote MCPmcp.cuiar.com/mcp
Best fit
OAuth 2.1, or a Bearer key with the mcp scope. Every plan.
Local MCPcuiar mcp
Works
cuiar mcp forwards to the remote server. Needs cuiar login.
REST APIapi.cuiar.com/v1
Works
POST /v1/rpc runs one tool call with a key. Pro and Team.
Routineson a schedule
Works
create_routine, list_routines and delete_routine are MCP tools.

Example tasks

Try these first

  • 01

    Snapshot and click

    “Open the city's waste collection calendar, take a snapshot, pick my street in the list and read me the next two pickup dates.”

    navigate, snapshot, click, wait_for.

  • 02

    Sign in from the vault

    “Sign in to my mobile carrier account and tell me how much data is left this month.”

    sign_in. The password never reaches the model.

  • 03

    Hand off a whole task

    “Use run_task in my Home workspace: compare the schedules and prices of a beginner pottery course at four studios in my city. Book nothing.”

    run_task uses Cuiar credits.

  • 04

    Make a routine

    “Create a routine every weekday at 07:00 Europe/Berlin that reads the city's road works page and emails me only when a new closure is on my route to work.”

    create_routine.

  • 05

    Work in a new workspace

    “Create a workspace client-acme, open it, sign in to Acme's project board, take a screenshot of the current sprint, then close the tab.”

    create_workspace, open_workspace, screenshot, close_tab.

The tools

The server lists the same tools whether or not the app is open. Browser tools need the app.

ToolWhat it does
list_workspacesList the workspaces with their system, proxy and status.
create_workspaceMake a workspace with a new device. Optional system and proxy.
open_workspace, close_workspaceOpen a workspace, optionally at a URL, or close all its windows.
navigateGo to a URL in a tab.
snapshotRead the page as an accessibility tree. Each element has a ref.
click, type, press_key, scrollAct on elements from the last snapshot.
wait_forWait until text shows, or for a time.
screenshotTake a screenshot of the visible page or the full page.
list_tabs, close_tabList or close the tabs of a workspace.
evaluateRun a JavaScript expression in the page.
sign_inSign in with a saved password. The password stays in the vault.
run_taskGive a whole task to the Cuiar agent. Odyssey mode needs Pro or Team. Uses credits.
create_routine, list_routines, delete_routineRun a task on a schedule, with the result by email.
account, devicesShow the plan and credits, and the computers where Cuiar is open.

Good to know

The app is not open
Open Cuiar and sign in on the computer that runs it. Browser tools answer only while the app is open.
No sign-in window
Run your client's login again, for example /mcp, claude mcp login cuiar or codex mcp login cuiar.
More than one computer
Send the header x-cuiar-device with a device name or ID from the devices tool.
run_task refused
The plan or the credits do not cover it. The step tools still work.

Templates to run from MCP Server

All templates

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

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