Joy MCP Server and API by Cotlet

Joy wedding planning platform MCP server: list guests, add guest, get RSVP status.

使うべきか

品質と安全性

A
説明の品質
99%
スキーマの完全性
79%
命名の品質
80%
ポイズニングのリスク
100%
権限の一致
90%
プロトコルへの準拠
100%

検出事項(2)

  • LOWTool 'cotlet_balance' description lacks action verbcotlet_balance 内
  • LOWTool 'cotlet_browser_close' suggests web access but openWorldHint=falsecotlet_browser_close 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~7,918トークン数(ツール定義)
~1.6 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 6.19%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "joy": {
      "url": "https://cotlet.dev/mcp/v1/joy/connect"
    }
  }
}

リモートエンドポイント

https://cotlet.dev/mcp/v1/joy/connectstreamable-http
https://cotlet.dev/mcp/v1/joystreamable-http

できること

ツール一覧

ツール(31)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢cotlet_whoami

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.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢cotlet_apps(app)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "app": {
      "type": "string",
      "description": "Only this app, e.g. skool."
    }
  },
  "additionalProperties": false
}
🟢cotlet_balance

The user's current credit balance. Free. Needs the user's Cotlet API key or sign-in.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢cotlet_get_call(call_id)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "call_id": {
      "type": "string",
      "description": "call_id from the earlier call"
    }
  },
  "required": [
    "call_id"
  ],
  "additionalProperties": false
}
🟡cotlet_upload_file(name, content_type)

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 works once. Free. Needs the user's Cotlet API key or sign-in.

入力スキーマ

{
  "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
}
🟢cotlet_report_issue(kind, title, description, app, tool, ...)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "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.",
      "enum": [
        "bug",
        "error",
        "feature_request",
        "missing_feature",
        "other"
      ],
      "title": "Kind",
      "type": "string"
    },
    "title": {
      "description": "One line, e.g. 'skool_list_members stops after 50 members'.",
      "maxLength": 200,
      "minLength": 3,
      "title": "Title",
      "type": "string"
    },
    "description": {
      "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.",
      "maxLength": 5000,
      "minLength": 10,
      "title": "Description",
      "type": "string"
    },
    "app": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "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'.",
      "title": "App"
    },
    "tool": {
      "anyOf": [
        {
          "maxLength": 160,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Tool or endpoint name, e.g. 'skool_list_members'.",
      "title": "Tool"
    },
    "call_id": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "call_id of the call that went wrong, if any.",
      "title": "Call Id"
    },
    "client": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Agent or tool sending this, e.g. 'Claude Code'.",
      "title": "Client"
    }
  },
  "required": [
    "kind",
    "title",
    "description"
  ],
  "additionalProperties": false,
  "description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
  "title": "AgentReportCreate"
}
🟢cotlet_browser_open(app, url)

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. In Joy it serves these actions: List guests, Add guest, Get RSVP status, Update event details, List registry gifts.

入力スキーマ

{
  "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
}
🟢cotlet_browser_navigate(app, url, history, dialog, dialog_text)

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.

入力スキーマ

{
  "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."
    },
    "history": {
      "type": "string",
      "enum": [
        "back",
        "forward"
      ],
      "description": "Instead of `url`."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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
}
🟢cotlet_browser_read(app, element)

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.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "Read only inside this element."
    }
  },
  "additionalProperties": false
}
🟢cotlet_browser_find(app, text, kind)

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.

入力スキーマ

{
  "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."
    },
    "text": {
      "type": "string",
      "maxLength": 200,
      "description": "Words to look for, any case."
    },
    "kind": {
      "type": "string",
      "enum": [
        "link",
        "button",
        "field",
        "any"
      ],
      "description": "Only elements of this kind. Default: any."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}
🟢cotlet_browser_screenshot(app)

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.

入力スキーマ

{
  "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
}
🟢cotlet_browser_scroll(app, direction, screens, element, inside)

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.

入力スキーマ

{
  "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."
    },
    "direction": {
      "type": "string",
      "enum": [
        "down",
        "up",
        "top",
        "bottom"
      ],
      "description": "Default: down."
    },
    "screens": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10,
      "description": "Viewport heights, for down and up. Default: 0.8."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "Scroll until this element is in view."
    },
    "inside": {
      "type": "integer",
      "minimum": 1,
      "description": "Scroll inside this element, not the page."
    }
  },
  "additionalProperties": false
}
🔴cotlet_browser_click(app, element, x, y, double, ...)

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.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "The element's number from the last read or step answer."
    },
    "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."
    },
    "double": {
      "type": "boolean",
      "description": "Double-click."
    },
    "button": {
      "type": "string",
      "enum": [
        "left",
        "right"
      ],
      "description": "right opens the page's own context menu. Default: left."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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
}
🟢cotlet_browser_hover(app, element, x, y)

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.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "The element's number from the last read or step answer."
    },
    "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."
    }
  },
  "additionalProperties": false
}
🔴cotlet_browser_drag(app, from, to, dialog, dialog_text)

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.

入力スキーマ

{
  "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."
    },
    "from": {
      "type": "object",
      "properties": {
        "element": {
          "type": "integer",
          "minimum": 1,
          "description": "The element's number from the last read or step answer."
        },
        "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."
        }
      },
      "additionalProperties": false,
      "description": "An element number, or x and y of the screenshot."
    },
    "to": {
      "type": "object",
      "properties": {
        "element": {
          "type": "integer",
          "minimum": 1,
          "description": "The element's number from the last read or step answer."
        },
        "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."
        }
      },
      "additionalProperties": false,
      "description": "An element number, or x and y of the screenshot."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}
🔴cotlet_browser_type(app, element, text, submit, slowly, ...)

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. Password, card and one-time code fields are refused: the user types them.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "The field's number from the last read. Leave it out to type where the focus is."
    },
    "text": {
      "type": "string",
      "maxLength": 5000,
      "description": "The text to type."
    },
    "submit": {
      "type": "boolean",
      "description": "Press Enter after typing, e.g. to search."
    },
    "slowly": {
      "type": "boolean",
      "description": "Key by key, for a search or address field whose suggestions do not appear."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}
🔴cotlet_browser_fill_form(app, fields, dialog, dialog_text)

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.

入力スキーマ

{
  "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."
    },
    "fields": {
      "type": "array",
      "minItems": 1,
      "maxItems": 30,
      "items": {
        "type": "object",
        "properties": {
          "element": {
            "type": "integer",
            "minimum": 1,
            "description": "The element's number from the last read or step answer."
          },
          "value": {
            "type": [
              "string",
              "boolean"
            ],
            "description": "Text, option, or true/false."
          }
        },
        "required": [
          "element",
          "value"
        ],
        "additionalProperties": false
      },
      "description": "The fields in the order a person fills them."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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."
    }
  },
  "required": [
    "fields"
  ],
  "additionalProperties": false
}
🔴cotlet_browser_select(app, element, option, dialog, dialog_text)

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.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "The element's number from the last read or step answer."
    },
    "option": {
      "type": "string",
      "maxLength": 300,
      "description": "The option."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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."
    }
  },
  "required": [
    "element",
    "option"
  ],
  "additionalProperties": false
}
🔴cotlet_browser_press(app, key, repeat, dialog, dialog_text)

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.

入力スキーマ

{
  "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."
    },
    "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."
    },
    "repeat": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Times to press it. Default 1."
    },
    "dialog": {
      "type": "string",
      "enum": [
        "accept",
        "dismiss"
      ],
      "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."
    }
  },
  "required": [
    "key"
  ],
  "additionalProperties": false
}
🔴cotlet_browser_upload(app, element, files)

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.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "The element's number from the last read or step answer."
    },
    "files": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "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
      },
      "description": "The files."
    }
  },
  "required": [
    "element",
    "files"
  ],
  "additionalProperties": false
}
🔴cotlet_browser_download(app, element, url)

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.

入力スキーマ

{
  "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."
    },
    "element": {
      "type": "integer",
      "minimum": 1,
      "description": "The element's number from the last read or step answer."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "A public http or https address, e.g. https://example.com."
    }
  },
  "additionalProperties": false
}
🔴cotlet_browser_evaluate(app, script)

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)

入力スキーマ

{
  "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."
    },
    "script": {
      "type": "string",
      "maxLength": 20000,
      "description": "A function body that returns."
    }
  },
  "required": [
    "script"
  ],
  "additionalProperties": false
}
🟢cotlet_browser_wait(app, text, seconds)

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.

入力スキーマ

{
  "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."
    },
    "text": {
      "type": "string",
      "maxLength": 200,
      "description": "Text to wait for."
    },
    "seconds": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 20,
      "description": "At most."
    }
  },
  "additionalProperties": false
}
⚪cotlet_browser_tabs(action, tab, url)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "new",
        "switch",
        "close"
      ],
      "description": "What to do. Default: list."
    },
    "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."
    }
  },
  "additionalProperties": false
}
⚪cotlet_browser_close(app)

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.

入力スキーマ

{
  "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
}
🟢cotlet_app_guide(app, task)

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. For Joy it covers these actions: List guests, Add guest, Get RSVP status, Update event details, List registry gifts.

入力スキーマ

{
  "type": "object",
  "properties": {
    "app": {
      "type": "string",
      "maxLength": 120,
      "description": "The app's name or Cotlet slug. Default: Joy."
    },
    "task": {
      "type": "string",
      "maxLength": 500,
      "description": "What the user wants done in the app, in their words."
    }
  },
  "additionalProperties": false
}
🟢joy_list_guests

List guests in the user's own Joy account from ChatGPT, Claude or any AI agent. Returns how to do it in Joy step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joy Cloud Browser. Joy's official API: Joy has no public API, no developer program and no Zapier app (checked 11 Oct 2026).

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢joy_add_guest

Add guest in the user's own Joy account from ChatGPT, Claude or any AI agent. Returns how to do it in Joy step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joy Cloud Browser. Joy's official API: Joy has no public API, no developer program and no Zapier app (checked 11 Oct 2026).

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢joy_get_rsvp_status

Get RSVP status in the user's own Joy account from ChatGPT, Claude or any AI agent. Returns how to do it in Joy step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joy Cloud Browser. Joy's official API: Joy has no public API, no developer program and no Zapier app (checked 11 Oct 2026).

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢joy_update_event_details

Update event details in the user's own Joy account from ChatGPT, Claude or any AI agent. Returns how to do it in Joy step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joy Cloud Browser. Joy's official API: Joy has no public API, no developer program and no Zapier app (checked 11 Oct 2026).

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢joy_list_registry_gifts

List registry gifts in the user's own Joy account from ChatGPT, Claude or any AI agent. Returns how to do it in Joy step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joy Cloud Browser. Joy's official API: Joy has no public API, no developer program and no Zapier app (checked 11 Oct 2026).

入力スキーマ

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 31 件
認証が必要バージョンは記録されていません—