Cotlet is an MCP server published by dev.cotlet, hosted at cotlet.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 40 tools, including cotlet_whoami, cotlet_apps, cotlet_request_apps, cotlet_balance, cotlet_refresh_button.
Cotlet's own tools: a cloud browser signed in as the user, account, credits and calls.
1,987 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task and sign-in link. Free. Needs the user's Cotlet API key or sign-in.
No parameters.
{
"name": "cotlet_whoami",
"title": "Cotlet: who am I",
"description": "The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task and sign-in link. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: who am I",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| app | string | Only this app, e.g. skool. |
{
"name": "cotlet_apps",
"title": "Cotlet: apps I can use",
"description": "The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: apps I can use",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser. Access says nothing about whether a task works there: check that in the browser. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| apps * | array | App slugs, e.g. ["skool", "substack"]. |
| use_case | string | What the user wants the agent to do in these apps, in their words. |
{
"name": "cotlet_request_apps",
"title": "Cotlet: request access to apps",
"description": "Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser. Access says nothing about whether a task works there: check that in the browser. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"required": [
"apps"
],
"properties": {
"apps": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "App slugs, e.g. [\"skool\", \"substack\"]."
},
"use_case": {
"type": "string",
"maxLength": 1000,
"description": "What the user wants the agent to do in these apps, in their words."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: request access to apps",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}The user's current credit balance. Free. Needs the user's Cotlet API key or sign-in.
No parameters.
{
"name": "cotlet_balance",
"title": "Cotlet: credit balance",
"description": "The user's current credit balance. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: credit balance",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Shows the user a button that refreshes Cotlet in their AI app. Call it once when a Cotlet answer says your Cotlet tool list is older than the server's. Free, read-only.
No parameters.
{
"name": "cotlet_refresh_button",
"title": "Refresh button",
"description": "Shows the user a button that refreshes Cotlet in their AI app. Call it once when a Cotlet answer says your Cotlet tool list is older than the server's. Free, read-only.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Refresh button",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.
| Parameter | Type | Description |
|---|---|---|
| call_id * | string | call_id from the earlier call |
{
"name": "cotlet_get_call",
"title": "Cotlet: check a call",
"description": "Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.",
"inputSchema": {
"type": "object",
"required": [
"call_id"
],
"properties": {
"call_id": {
"type": "string",
"description": "call_id from the earlier call"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: check a call",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL takes one stored file (a failed PUT can be sent again). Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| name | string | File name, e.g. photo.jpg. |
| content_type | string | MIME type, e.g. image/jpeg. |
{
"name": "cotlet_upload_file",
"title": "Cotlet: upload a file for a tool",
"description": "Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {\"file_id\": \"...\"}. Up to 25 MB, the URL takes one stored file (a failed PUT can be sent again). Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "File name, e.g. photo.jpg."
},
"content_type": {
"type": "string",
"description": "MIME type, e.g. image/jpeg."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: upload a file for a tool",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to report: do the task in the browser. A feature the user asks for goes as feature_request. A report promises nothing: tell the user it was sent, never that something will be built or fixed, or when. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| app | any | App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'. |
| kind * | string | bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user asked for. missing_feature: a step the task needed that you tried and could not do, in the browser or with a tool. other: anything else. |
| tool | any | Tool or endpoint name, e.g. 'skool_list_members'. |
| title * | string | One line, e.g. 'skool_list_members stops after 50 members'. |
| client | any | Agent or tool sending this, e.g. 'Claude Code'. |
| call_id | any | call_id of the call that went wrong, if any. |
| description * | string | What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets. |
Starts the user's Cloud Browser (a real Chrome on Cotlet, where the user is signed in to their sites) and opens `url`. Call it first. The URL goes to the site's open tab, else to a new tab, so the user's own tabs stay. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| url | string | A public http or https address, e.g. https://example.com. |
{
"name": "cotlet_browser_open",
"title": "Open the browser",
"description": "Starts the user's Cloud Browser (a real Chrome on Cotlet, where the user is signed in to their sites) and opens `url`. Call it first. The URL goes to the site's open tab, else to a new tab, so the user's own tabs stay. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Open the browser",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| url | string | A public http or https address, e.g. https://example.com. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| history | string | Instead of `url`. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_navigate",
"title": "Go to a page",
"description": "Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"history": {
"enum": [
"back",
"forward"
],
"type": "string",
"description": "Instead of `url`."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Go to a page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside one element (a dialog, a form, a list). Never returns field values, cookies or storage.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| element | integer | Read only inside this element. |
{
"name": "cotlet_browser_read",
"title": "Read the page",
"description": "The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside one element (a dialog, a form, a list). Never returns field values, cookies or storage.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Read only inside this element."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Read the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| kind | string | Only elements of this kind. Default: any. |
| text * | string | Words to look for, any case. |
{
"name": "cotlet_browser_find",
"title": "Find on the page",
"description": "Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"kind": {
"enum": [
"link",
"button",
"field",
"any"
],
"type": "string",
"description": "Only elements of this kind. Default: any."
},
"text": {
"type": "string",
"maxLength": 200,
"description": "Words to look for, any case."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find on the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
{
"name": "cotlet_browser_screenshot",
"title": "See the page",
"description": "A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
}
},
"additionalProperties": false
},
"annotations": {
"title": "See the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| inside | integer | Scroll inside this element, not the page. |
| element | integer | Scroll until this element is in view. |
| screens | number | Viewport heights, for down and up. Default: 0.8. |
| direction | string | Default: down. |
{
"name": "cotlet_browser_scroll",
"title": "Scroll the page",
"description": "Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"inside": {
"type": "integer",
"minimum": 1,
"description": "Scroll inside this element, not the page."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element is in view."
},
"screens": {
"type": "number",
"maximum": 10,
"description": "Viewport heights, for down and up. Default: 0.8.",
"exclusiveMinimum": 0
},
"direction": {
"enum": [
"down",
"up",
"top",
"bottom"
],
"type": "string",
"description": "Default: down."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Scroll the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that would open a new tab opens in this one. Buttons that pay or buy, and sign-in and account pages, are refused.
| Parameter | Type | Description |
|---|---|---|
| x | number | Instead of `element`: pixels from the left of the screenshot. |
| y | number | With `x`: pixels from the top of the screenshot. |
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| button | string | right opens the page's own context menu. Default: left. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| double | boolean | Double-click. |
| element | integer | The element's number from the last read or step answer. |
Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| x | number | Instead of `element`: pixels from the left of the screenshot. |
| y | number | With `x`: pixels from the top of the screenshot. |
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| element | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_hover",
"title": "Point at the page",
"description": "Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Point at the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| to * | object | An element number, or x and y of the screenshot. |
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| from * | object | An element number, or x and y of the screenshot. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_drag",
"title": "Drag on the page",
"description": "Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"description": "An element number, or x and y of the screenshot.",
"additionalProperties": false
},
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"from": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"description": "An element number, or x and y of the screenshot.",
"additionalProperties": false
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Drag on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells and editors that read does not number (Google Sheets, Docs), click the place first; there a tab in `text` presses Tab and a line break Enter, so one call fills a table. Answers the page after it: the elements and text in view, with the same numbers. A password or code the user gave you goes in like any text; card fields are refused.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| text * | string | The text to type. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| slowly | boolean | Key by key, for a search or address field whose suggestions do not appear. |
| submit | boolean | Press Enter after typing, e.g. to search. |
| element | integer |
Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button after. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| fields * | array | The fields in the order a person fills them. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_fill_form",
"title": "Fill in a form",
"description": "Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button after. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"fields"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"element",
"value"
],
"properties": {
"value": {
"type": [
"string",
"boolean"
],
"description": "Text, option, or true/false."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"maxItems": 30,
"minItems": 1,
"description": "The fields in the order a person fills them."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Fill in a form",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| option * | string | The option. |
| element * | integer | The element's number from the last read or step answer. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_select",
"title": "Choose from a list",
"description": "Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"element",
"option"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Choose from a list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| key * | string | One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or one character such as a or 5. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| repeat | integer | Times to press it. Default 1. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
Puts files into file field or upload button `element`: each file is {"url": "https://..."} or {"file_id": "..."} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| files * | array | The files. |
| element * | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_upload",
"title": "Upload a file",
"description": "Puts files into file field or upload button `element`: each file is {\"url\": \"https://...\"} or {\"file_id\": \"...\"} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"element",
"files"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public file URL."
},
"file_id": {
"type": "string",
"description": "A file uploaded to Cotlet."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1,
"description": "The files."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Upload a file",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| url | string | A public http or https address, e.g. https://example.com. |
| element | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_download",
"title": "Download a file",
"description": "Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Download a file",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or storage; a filled field's value reads [hidden by Cotlet]. Example: return [...document.querySelectorAll('h2')].map(h => h.innerText)
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| script * | string | A function body that returns. |
{
"name": "cotlet_browser_evaluate",
"title": "Run a script on the page",
"description": "Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or storage; a filled field's value reads [hidden by Cotlet]. Example: return [...document.querySelectorAll('h2')].map(h => h.innerText)",
"inputSchema": {
"type": "object",
"required": [
"script"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"script": {
"type": "string",
"maxLength": 20000,
"description": "A function body that returns."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Run a script on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| text | string | Text to wait for. |
| seconds | number | At most. |
{
"name": "cotlet_browser_wait",
"title": "Wait for the page",
"description": "Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"text": {
"type": "string",
"maxLength": 200,
"description": "Text to wait for."
},
"seconds": {
"type": "number",
"maximum": 20,
"description": "At most.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"title": "Wait for the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}The tabs of the user's web browser, where they keep their signed-in sites open. `list` (default) answers each tab's id, URL and title and which is shown; `switch` with `tab` shows that tab, and every later step acts on it; `new` with `url` opens a tab (at most 8); `close` with `tab` closes it. Work in the tab of the site the task is about and close only the tabs you opened.
| Parameter | Type | Description |
|---|---|---|
| tab | string | A tab's id from list, for switch and close. |
| url | string | For new: the public http or https address the tab opens. |
| action | string | What to do. Default: list. |
{
"name": "cotlet_browser_tabs",
"title": "Browser tabs",
"description": "The tabs of the user's web browser, where they keep their signed-in sites open. `list` (default) answers each tab's id, URL and title and which is shown; `switch` with `tab` shows that tab, and every later step acts on it; `new` with `url` opens a tab (at most 8); `close` with `tab` closes it. Work in the tab of the site the task is about and close only the tabs you opened.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"description": "A tab's id from list, for switch and close."
},
"url": {
"type": "string",
"format": "uri",
"description": "For new: the public http or https address the tab opens."
},
"action": {
"enum": [
"list",
"new",
"switch",
"close"
],
"type": "string",
"description": "What to do. Default: list."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Browser tabs",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Ends the browser session when the task is done: the browser keeps its cookies and sleeps, and the per-minute charge stops. Answers the session's minutes and credits.
| Parameter | Type | Description |
|---|---|---|
| app | string | Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote. |
{
"name": "cotlet_browser_close",
"title": "Close the browser",
"description": "Ends the browser session when the task is done: the browser keeps its cookies and sleeps, and the per-minute charge stops. Answers the session's minutes and credits.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Close the browser",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session.
| Parameter | Type | Description |
|---|---|---|
| app * | string | The app's name or Cotlet slug, e.g. Notion or pirate-ship. |
| task | string | What the user wants done in the app, in their words. |
{
"name": "cotlet_app_guide",
"title": "Cotlet: how to work in an app",
"description": "How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session.",
"inputSchema": {
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"maxLength": 120,
"description": "The app's name or Cotlet slug, e.g. Notion or pirate-ship."
},
"task": {
"type": "string",
"maxLength": 500,
"description": "What the user wants done in the app, in their words."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: how to work in an app",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read first when the user wants a job to repeat on a schedule (every N minutes, daily, when something new appears): the script SDK, its rules, examples and the steps test then save. Free.
No parameters.
{
"name": "cotlet_automation_guide",
"title": "Cotlet: how to build an automation",
"description": "Read first when the user wants a job to repeat on a schedule (every N minutes, daily, when something new appears): the script SDK, its rules, examples and the steps test then save. Free.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: how to build an automation",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Runs a script once now in a hidden tab of the user's Cloud Browser with every write skipped, and answers its status, rows, log, steps and credits. Uses browser minutes. Test the exact script you will save. `automation`: test against that automation's seen rows and state.
| Parameter | Type | Description |
|---|---|---|
| script * | string | The Python script: `def run(ctx):` with the cotlet SDK (see the guide). |
| automation | string | The automation's id from cotlet_automation_list. |
{
"name": "cotlet_automation_test",
"title": "Cotlet: test an automation script",
"description": "Runs a script once now in a hidden tab of the user's Cloud Browser with every write skipped, and answers its status, rows, log, steps and credits. Uses browser minutes. Test the exact script you will save. `automation`: test against that automation's seen rows and state.",
"inputSchema": {
"type": "object",
"required": [
"script"
],
"properties": {
"script": {
"type": "string",
"description": "The Python script: `def run(ctx):` with the cotlet SDK (see the guide)."
},
"automation": {
"type": "string",
"description": "The automation's id from cotlet_automation_list."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: test an automation script",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Saves a tested script as an automation on a schedule, or with `automation` as its new version. Show the user the rows, schedule and cost first. A script with writes waits until the user allows them in the console: give them the link this answers.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Short name, e.g. Lotto monitor. |
| note | string | For a new version: what changed, one line. |
| script * | string | The Python script: `def run(ctx):` with the cotlet SDK (see the guide). |
| explain * | object | How it works, for the user: {summary: 1-3 plain sentences, nodes: [{id, kind: trigger|read|ai|write|output|step, label, site?}], edges: [[from, to, label?]]}. A write node for every ctx.write. |
| outputs | object | Where new rows go besides the dataset: {email: off|each_run|daily, email_hour: 0-23, webhook_url: https URL or null}. Default: email off. |
| schedule * | string | Cron (*/15 * * * *) or words: every 15 minutes, every 2 hours, daily at 8:00. |
| automation | string | The automation's id from cotlet_automation_list. |
The workspace's automations: status, schedule, last run, cost. With `automation`: that one in full (script, how it works, writes and consent, outputs) and its runs, newest first: each with id, status, time, new_rows. `runs`: how many (default 10, up to 200); `since`: runs from that time. Read one run's rows with cotlet_automation_rows and `run`.
| Parameter | Type | Description |
|---|---|---|
| runs | integer | |
| since | string | ISO 8601 time, e.g. 2026-11-08T00:00:00Z. |
| automation | string | The automation's id from cotlet_automation_list. |
{
"name": "cotlet_automation_list",
"title": "Cotlet: automations",
"description": "The workspace's automations: status, schedule, last run, cost. With `automation`: that one in full (script, how it works, writes and consent, outputs) and its runs, newest first: each with id, status, time, new_rows. `runs`: how many (default 10, up to 200); `since`: runs from that time. Read one run's rows with cotlet_automation_rows and `run`.",
"inputSchema": {
"type": "object",
"properties": {
"runs": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"since": {
"type": "string",
"description": "ISO 8601 time, e.g. 2026-11-08T00:00:00Z."
},
"automation": {
"type": "string",
"description": "The automation's id from cotlet_automation_list."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: automations",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}What an automation collected, newest run first, each row with its run_id. `run`: only that run's rows (ids from cotlet_automation_list). `since`: an ISO time; `limit` up to 200.
| Parameter | Type | Description |
|---|---|---|
| run | string | A run's id from cotlet_automation_list. |
| limit | integer | |
| since | string | ISO 8601 time, e.g. 2026-11-08T00:00:00Z. |
| automation * | string | The automation's id from cotlet_automation_list. |
{
"name": "cotlet_automation_rows",
"title": "Cotlet: an automation's rows",
"description": "What an automation collected, newest run first, each row with its run_id. `run`: only that run's rows (ids from cotlet_automation_list). `since`: an ISO time; `limit` up to 200.",
"inputSchema": {
"type": "object",
"required": [
"automation"
],
"properties": {
"run": {
"type": "string",
"description": "A run's id from cotlet_automation_list."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"since": {
"type": "string",
"description": "ISO 8601 time, e.g. 2026-11-08T00:00:00Z."
},
"automation": {
"type": "string",
"description": "The automation's id from cotlet_automation_list."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: an automation's rows",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}pause, resume, run_now (a run now, the answer comes later in cotlet_automation_list) or delete. Ask the user before delete.
| Parameter | Type | Description |
|---|---|---|
| action * | enum | one of ["pause","resume","run_now","delete"] |
| automation * | string | The automation's id from cotlet_automation_list. |
{
"name": "cotlet_automation_control",
"title": "Cotlet: pause, resume, run or delete an automation",
"description": "pause, resume, run_now (a run now, the answer comes later in cotlet_automation_list) or delete. Ask the user before delete.",
"inputSchema": {
"type": "object",
"required": [
"automation",
"action"
],
"properties": {
"action": {
"enum": [
"pause",
"resume",
"run_now",
"delete"
]
},
"automation": {
"type": "string",
"description": "The automation's id from cotlet_automation_list."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: pause, resume, run or delete an automation",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read first when the user wants an API of their own for a job in an app (JSON in, JSON out, called with their Cotlet key): the script SDK, ctx.http, the steps network, test, save, and the rules. Free.
No parameters.
{
"name": "cotlet_api_guide",
"title": "Cotlet: how to build a Custom API endpoint",
"description": "Read first when the user wants an API of their own for a job in an app (JSON in, JSON out, called with their Cotlet key): the script SDK, ctx.http, the steps network, test, save, and the rules. Free.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: how to build a Custom API endpoint",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}The app's own API calls: the fetch and XHR requests the user's web browser tab sent in the last 10 minutes (method, URL, status, content types, header names, short bodies), oldest first. Use it after doing the job once in the browser, to build a Custom API endpoint on the same request. A streamed answer (a chat app's) is kept too: its start here, all of it for an endpoint's script through ctx.browser.network. Free; it does not start the browser.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of a browser answer. Default: the shown tab. |
| limit | integer | Default 50, the newest. |
| since | integer | Only requests at or after this `at` (epoch ms) of an earlier answer. |
| request | integer | One request's id from the list: it alone, with its whole captured bodies. |
{
"name": "cotlet_browser_network",
"title": "See the page's requests",
"description": "The app's own API calls: the fetch and XHR requests the user's web browser tab sent in the last 10 minutes (method, URL, status, content types, header names, short bodies), oldest first. Use it after doing the job once in the browser, to build a Custom API endpoint on the same request. A streamed answer (a chat app's) is kept too: its start here, all of it for an endpoint's script through ctx.browser.network. Free; it does not start the browser.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of a browser answer. Default: the shown tab."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Default 50, the newest."
},
"since": {
"type": "integer",
"minimum": 0,
"description": "Only requests at or after this `at` (epoch ms) of an earlier answer."
},
"request": {
"type": "integer",
"minimum": 0,
"description": "One request's id from the list: it alone, with its whole captured bodies."
}
},
"additionalProperties": false
},
"annotations": {
"title": "See the page's requests",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Runs an endpoint script once now with `input`, writes not sent, and answers its JSON, log, duration and credits (10 on success, none on failure). Test the exact script you will save.
| Parameter | Type | Description |
|---|---|---|
| site * | string | The app's site, e.g. substack.com: ctx.http reaches it and its subdomains. |
| input | object | Sample input, as a caller's JSON body. |
| script * | string | The Python script: `def run(ctx):` returning the answer (see the guide). |
| input_schema | object | JSON Schema of the input, an object (type, properties, items, required). |
| output_schema | object | JSON Schema of the answer (type, properties, items, required). |
{
"name": "cotlet_api_test",
"title": "Cotlet: test a Custom API endpoint",
"description": "Runs an endpoint script once now with `input`, writes not sent, and answers its JSON, log, duration and credits (10 on success, none on failure). Test the exact script you will save.",
"inputSchema": {
"type": "object",
"required": [
"script",
"site"
],
"properties": {
"site": {
"type": "string",
"description": "The app's site, e.g. substack.com: ctx.http reaches it and its subdomains."
},
"input": {
"type": "object",
"description": "Sample input, as a caller's JSON body."
},
"script": {
"type": "string",
"description": "The Python script: `def run(ctx):` returning the answer (see the guide)."
},
"input_schema": {
"type": "object",
"description": "JSON Schema of the input, an object (type, properties, items, required)."
},
"output_schema": {
"type": "object",
"description": "JSON Schema of the answer (type, properties, items, required)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: test a Custom API endpoint",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Saves a tested script as the user's endpoint (an existing name: its new version) and answers its URL, a curl example and the OpenAPI link. Show the user the test's JSON first. An endpoint that writes waits until the user allows the writes in the console: give them the link this answers.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The endpoint's name, e.g. latest_posts. |
| note | string | For a new version: what changed, one line. |
| site * | string | The app's site, e.g. substack.com: ctx.http reaches it and its subdomains. |
| script * | string | The Python script: `def run(ctx):` returning the answer (see the guide). |
| description * | string | What it does, one line. |
| input_schema * | object | JSON Schema of the input, an object (type, properties, items, required). |
| output_schema * | object | JSON Schema of the answer (type, properties, items, required). |
The workspace's endpoints: status, URL, schemas, writes, and their calls of the last 24 hours with the last one.
No parameters.
{
"name": "cotlet_api_list",
"title": "Cotlet: Custom API endpoints",
"description": "The workspace's endpoints: status, URL, schemas, writes, and their calls of the last 24 hours with the last one.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: Custom API endpoints",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}off, on or delete an endpoint by name. Ask the user before delete.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The endpoint's name, e.g. latest_posts. |
| action * | enum | one of ["off","on","delete"] |
{
"name": "cotlet_api_control",
"title": "Cotlet: turn a Custom API endpoint off, on or delete it",
"description": "off, on or delete an endpoint by name. Ask the user before delete.",
"inputSchema": {
"type": "object",
"required": [
"name",
"action"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[a-z0-9_]{2,40}$",
"description": "The endpoint's name, e.g. latest_posts."
},
"action": {
"enum": [
"off",
"on",
"delete"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: turn a Custom API endpoint off, on or delete it",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Cotlet runs the user's own Chrome in the cloud, the Cloud Browser. The user signs in to sites there themselves or you sign in for them; Cotlet does not store their passwords. This server has Cotlet's own tools, and with them you can work in any web app of the user's. Before the first browser step in an app, call cotlet_app_guide with the app's name (free): it says which browser to use, the sign-in link and the app's screens. Call the browser tools one at a time, never in parallel: wait for each answer. Open the page with cotlet_browser_open, then cotlet_browser_read it once for its text and numbered elements. Act on those numbers with click, type, select and press, or fill_form for several fields at once; each action answers the page after it (the elements and text in view, same numbers), so read again only to see the whole page. cotlet_browser_find finds one thing on a long page; scroll loads lists that grow as you scroll; screenshot shows boards and canvases (click or drag them by x, y); download gets a file; evaluate extracts data with a script. Public pages open without signing in. Signing in for the user is allowed: on a sign-in page or a 2FA prompt, type the email, password and code the user gave you, and ask them for what you lack (Cotlet does not store them). If the user would rather sign in themselves, or a check a step says needs the person, give them one link only, the sign-in link from cotlet_app_guide (it opens their Cloud Browser right on that page), ask them to reply "done", then go on with the task. Ask the user before a step that sends, publishes, deletes or pays. Each answer names its Tab: send that id as `tab` with the next steps, so a step never acts on another tab the user or another client showed meanwhile (it does nothing and answers tab_changed: read the shown tab or switch back). A refusal says how to go on: no_tab, list the tabs, switch to the task's site (or reopen it), read it and use the fresh Tab id and element numbers; no_element, find the control by its label in the page shown, or read again, and fill only the fields not yet filled; script_failed, read the error and the page first, fix an invalid script, never send it unchanged. Close the browser with cotlet_browser_close when done: each started minute of a session uses credits. After each finished task, never in the middle of one, give the result, then offer 2 or 3 next things to do in the app, from the guide's "What to offer next": another read first, then a small change you make only after the user says yes, and an automation when a job repeats. Without `app` the browser tools work in the user's web browser, where they keep their signed-in sites open as tabs: cotlet_browser_tabs lists them and switches to the one the task is about; with `app` they work in that app's own Cloud Browser, when the guide names one. If you cannot finish the task in the browser (an element you cannot find, a page that will not work, a flow you do not understand) or a step keeps failing, call cotlet_report_issue with what the user asked, the app or site, the step and what you saw. Access to an app, a catalog description or a guide's screens prove no feature: say only what you saw work. For a large task check it read-only first, keep any no-write limit, and make a sample write only after the user agrees; estimate only from a measured sample and cotlet_balance. Never offer or promise dedicated tools, a build or a date. cotlet_whoami names the account, cotlet_balance its credits, cotlet_apps the apps ready for tools and cotlet_request_apps adds apps to that list (a web app works in the browser without it). Writes that reach other people wait for the user's approval in the Cotlet console; cotlet_get_call reports on them. Several accounts of one app: pass `browser` with a name cotlet_apps lists. An app's dedicated operations are on its own server, https://cotlet.dev/mcp/v1/<app>. Custom API turns a job done in the browser into the user's own HTTP endpoint: read cotlet_api
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "cotlet_report_issue",
"title": "Cotlet: report a bug or a missing feature",
"description": "Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to report: do the task in the browser. A feature the user asks for goes as feature_request. A report promises nothing: tell the user it was sent, never that something will be built or fixed, or when. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"title": "AgentReportCreate",
"required": [
"kind",
"title",
"description"
],
"properties": {
"app": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"title": "App",
"default": null,
"description": "App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'."
},
"kind": {
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"type": "string",
"title": "Kind",
"description": "bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user asked for. missing_feature: a step the task needed that you tried and could not do, in the browser or with a tool. other: anything else."
},
"tool": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
],
"title": "Tool",
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'."
},
"title": {
"type": "string",
"title": "Title",
"maxLength": 200,
"minLength": 3,
"description": "One line, e.g. 'skool_list_members stops after 50 members'."
},
"client": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"title": "Client",
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'."
},
"call_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Call Id",
"default": null,
"description": "call_id of the call that went wrong, if any."
},
"description": {
"type": "string",
"title": "Description",
"maxLength": 5000,
"minLength": 10,
"description": "What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets."
}
},
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: report a bug or a missing feature",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_click",
"title": "Click on the page",
"description": "Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that would open a new tab opens in this one. Buttons that pay or buy, and sign-in and account pages, are refused.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"button": {
"enum": [
"left",
"right"
],
"type": "string",
"description": "right opens the page's own context menu. Default: left."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"double": {
"type": "boolean",
"description": "Double-click."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Click on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| The field's number from the last read. Leave it out to type where the focus is. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_type",
"title": "Type on the page",
"description": "Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells and editors that read does not number (Google Sheets, Docs), click the place first; there a tab in `text` presses Tab and a line break Enter, so one call fills a table. Answers the page after it: the elements and text in view, with the same numbers. A password or code the user gave you goes in like any text; card fields are refused.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"slowly": {
"type": "boolean",
"description": "Key by key, for a search or address field whose suggestions do not appear."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The field's number from the last read. Leave it out to type where the focus is."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Type on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}{
"name": "cotlet_browser_press",
"title": "Press a key",
"description": "Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"key"
],
"properties": {
"app": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"description": "Leave it out: the step runs in the user's web browser. Only when cotlet_app_guide names an app's own Cloud Browser, that app's slug, e.g. milanote."
},
"key": {
"type": "string",
"anyOf": [
{
"enum": [
"Enter",
"Tab",
"Shift+Tab",
"Escape",
"Backspace",
"Delete",
"Space",
"ArrowDown",
"ArrowUp",
"ArrowLeft",
"ArrowRight",
"PageDown",
"PageUp",
"Home",
"End"
]
},
{
"pattern": "^[ -~]$"
}
],
"description": "One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or one character such as a or 5."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"repeat": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Times to press it. Default 1."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Press a key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}{
"name": "cotlet_automation_save",
"title": "Cotlet: save an automation",
"description": "Saves a tested script as an automation on a schedule, or with `automation` as its new version. Show the user the rows, schedule and cost first. A script with writes waits until the user allows them in the console: give them the link this answers.",
"inputSchema": {
"type": "object",
"required": [
"name",
"script",
"schedule",
"explain"
],
"properties": {
"name": {
"type": "string",
"description": "Short name, e.g. Lotto monitor."
},
"note": {
"type": "string",
"description": "For a new version: what changed, one line."
},
"script": {
"type": "string",
"description": "The Python script: `def run(ctx):` with the cotlet SDK (see the guide)."
},
"explain": {
"type": "object",
"description": "How it works, for the user: {summary: 1-3 plain sentences, nodes: [{id, kind: trigger|read|ai|write|output|step, label, site?}], edges: [[from, to, label?]]}. A write node for every ctx.write."
},
"outputs": {
"type": "object",
"description": "Where new rows go besides the dataset: {email: off|each_run|daily, email_hour: 0-23, webhook_url: https URL or null}. Default: email off."
},
"schedule": {
"type": "string",
"description": "Cron (*/15 * * * *) or words: every 15 minutes, every 2 hours, daily at 8:00."
},
"automation": {
"type": "string",
"description": "The automation's id from cotlet_automation_list."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: save an automation",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "cotlet_api_save",
"title": "Cotlet: save a Custom API endpoint",
"description": "Saves a tested script as the user's endpoint (an existing name: its new version) and answers its URL, a curl example and the OpenAPI link. Show the user the test's JSON first. An endpoint that writes waits until the user allows the writes in the console: give them the link this answers.",
"inputSchema": {
"type": "object",
"required": [
"name",
"description",
"site",
"script",
"input_schema",
"output_schema"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[a-z0-9_]{2,40}$",
"description": "The endpoint's name, e.g. latest_posts."
},
"note": {
"type": "string",
"description": "For a new version: what changed, one line."
},
"site": {
"type": "string",
"description": "The app's site, e.g. substack.com: ctx.http reaches it and its subdomains."
},
"script": {
"type": "string",
"description": "The Python script: `def run(ctx):` returning the answer (see the guide)."
},
"description": {
"type": "string",
"maxLength": 600,
"description": "What it does, one line."
},
"input_schema": {
"type": "object",
"description": "JSON Schema of the input, an object (type, properties, items, required)."
},
"output_schema": {
"type": "object",
"description": "JSON Schema of the answer (type, properties, items, required)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: save a Custom API endpoint",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}