Developers

MCP server.

Give your AI app a browser with separate workspaces. It can read pages, act in them, run tasks and schedule routines.

Connect

The server URL is https://mcp.cuiar.com/mcp. It uses Streamable HTTP and works on every plan.

The first time, your AI app opens cuiar.com. Sign in and select Allow. The app then works as you until you disconnect it on your account page.

The browser tools work in the Cuiar app on your computer, so the app must be open and signed in. The account and routine tools work without it.Download Cuiar.

Claude

On claude.ai, Claude Desktop and Claude mobile:

  1. Open Customize, then Connectors, and select Add custom connector.
  2. Enter the name Cuiar and the URL https://mcp.cuiar.com/mcp. If Claude asks for the OAuth client, select Use Claude's published identity. Select Add.
  3. Select Connect and allow Cuiar on cuiar.com.

On a Team or Enterprise plan, an owner adds the connector in Organization settings, Connectors. Then each member selects Connect.

ChatGPT

  1. Open chatgpt.com/plugins, select +, then Add custom MCP server.
  2. Enter the name Cuiar. Under Connection, select Public endpoint and enter https://mcp.cuiar.com/mcp. For authentication, select OAuth.
  3. Select I understand and want to continue, then Create as a plugin.
  4. Connect and allow Cuiar on cuiar.com.

Claude Code

claude mcp add --transport http cuiar https://mcp.cuiar.com/mcp

Then type /mcp in Claude Code, select cuiar and authenticate.

Cursor

Add Cuiar to Cursor, or put this in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cuiar": { "url": "https://mcp.cuiar.com/mcp" }
  }
}

Cursor shows Needs login next to the server. Select it and allow Cuiar.

VS Code

Add Cuiar to VS Code, or run:

code --add-mcp '{"name":"cuiar","type":"http","url":"https://mcp.cuiar.com/mcp"}'

For one project, put this in .vscode/mcp.json:

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

VS Code asks you to sign in when the server starts.

API key

A client that sends headers can use an API key instead of OAuth. Make a key with the mcp scope on youraccount page:

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

A client that starts local servers can use the CLI: cuiar mcp. See the developer docs.

OAuth

For developers of MCP clients. Cuiar follows the MCP authorization specification.

Protected resource
https://mcp.cuiar.com/.well-known/oauth-protected-resource
Authorization server
https://api.cuiar.com/.well-known/oauth-authorization-server
Client registration
Dynamic registration at /oauth/register, or a client ID metadata document (an https client_id).
Client types
Public (none), or confidential (client_secret_post, client_secret_basic).
PKCE
S256 only.
Resource
https://mcp.cuiar.com/mcp
Scope
mcp
Redirect URIs
https, http on 127.0.0.1 or localhost with any port, or an app scheme.
Tokens
The access token works for 1 hour. The refresh token works for 90 days and changes at each use. A refresh token used twice ends the connection.
Revocation
https://api.cuiar.com/oauth/revoke

Tools

Each tool tells your AI app if it only reads or if it can change something. Tools that act on a page work as you, on sites where you are signed in, so your AI app can ask you first.

account
Show the plan and the credits left.
Reads
devices
List the computers where Cuiar is open now.
Reads
list_routines
List the routines with their schedule and next run.
Reads
create_routine
Run a task on a schedule. The result goes to you by e-mail.
Changes
delete_routine
Delete a routine.
Changes
list_workspaces
List the workspaces with their system, proxy and status.
Reads
create_workspace
Make a workspace with a new device.
Changes
open_workspace
Open a workspace, optionally at a URL.
Changes
close_workspace
Close all windows of a workspace.
Changes
navigate
Open a URL, or go back, forward or reload.
Changes
snapshot
Read the part of the page in view, with a ref for each element.
Reads
read_page
Read the page's text in parts, or its links.
Reads
click
Click an element or a point.
Changes
hold
Press and hold an element or a point for a set time.
Changes
hover
Move the pointer over an element.
Changes
type
Type text into a field.
Changes
press_key
Press a key or a shortcut.
Changes
select
Choose an option, or set a checkbox or switch.
Changes
drag
Drag an element or a point and drop it.
Changes
scroll
Scroll the page or an element.
Changes
upload_file
Put files into a file field.
Changes
downloads
List the recent downloads, or read one.
Reads
dialog
Answer an alert, a confirm or a prompt.
Changes
wait_for
Wait for a text, a URL or some seconds.
Reads
extract
Read repeated items, such as search results, as JSON.
Changes
screenshot
Take a screenshot.
Reads
save_pdf
Save the page as a PDF file.
Changes
evaluate
Run JavaScript in the page.
Changes
storage
Read or change cookies, localStorage or sessionStorage.
Changes
clipboard
Read or write the clipboard.
Changes
tabs
List, open, switch to or close tabs.
Changes
viewport
Set or read the zoom and the window size.
Changes
sign_in
Sign in to the site with a login from your vault. The AI app never sees the password.
Changes
run_task
Give a whole task to the Cuiar agent. It uses credits.
Changes

Questions or problems: support@cuiar.com. How Cuiar uses your data:privacy policy.