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:
- Open Customize, then Connectors, and select Add custom connector.
- Enter the name
Cuiarand the URLhttps://mcp.cuiar.com/mcp. If Claude asks for the OAuth client, select Use Claude's published identity. Select Add. - 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
- Open chatgpt.com/plugins, select +, then Add custom MCP server.
- Enter the name
Cuiar. Under Connection, select Public endpoint and enterhttps://mcp.cuiar.com/mcp. For authentication, select OAuth. - Select I understand and want to continue, then Create as a plugin.
- Connect and allow Cuiar on cuiar.com.
Claude Code
claude mcp add --transport http cuiar https://mcp.cuiar.com/mcpThen 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.