# Mangomint MCP Server and API by Cotlet

> Mangomint salon and spa management MCP server: list appointments, book appointment.

- name: dev.cotlet/mangomint
- version: 1.0.2
- connection class: R1 (autonomous)
- trust: 96/100
- quality: 97/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/dev.cotlet%2Fmangomint
- tools: https://api.protogrid.dev/v1/servers/dev.cotlet%2Fmangomint/tools

**An agent can connect on its own if it already holds `MANGOMINT_TOKEN`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "mangomint": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/mangomint",
      "headers": {
        "Authorization": "Bearer ${MANGOMINT_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${MANGOMINT_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% +updated-4d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 97/100 (new)

### protocol: 100 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 300000)

### authorization: 100 (weight 15)

- pass `auth.prm`: Protected Resource Metadata (RFC 9728) published
- pass `auth.as_metadata`: authorization server metadata reachable
- pass `auth.cimd`: Client ID Metadata Documents supported
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 94 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 31 of 31 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 26 of 31 tools declare all four hints; missing: cotlet_upload_file (idempotentHint); cotlet_whoami (idempotentHint); cotlet_apps (idempotentHint); …
- pass `tools.token_cost`: about 7,530 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`, `stability.new_links`: tool history recorded for 4 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 31, about 7,530 tokens to load them all
- tool set hash: 0692c372421c2224e8bec7db7a6408e5
- tools last changed: 2026-11-12T17:42:50.218Z
- badge: [![protogrid quality](https://protogrid.dev/badge/dev.cotlet/mangomint.svg)](https://protogrid.dev/servers/dev.cotlet/mangomint)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-12 `cotlet_browser_download` changed (description)
  - before: Gets the file that clicking `element` (a download link or button) or opening `url` starts: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.
  - after: 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.
- 2026-11-09 `mangomint_export_sales_report` added
  - Export sales report in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- 2026-11-09 `mangomint_find_client` added
  - Find client in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- 2026-11-09 `mangomint_reschedule_appointment` added
  - Reschedule appointment in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- 2026-11-09 `mangomint_book_appointment` added
  - Book appointment in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- 2026-11-09 `mangomint_list_appointments` added
  - List appointments in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- 2026-11-09 `cotlet_app_guide` changed (description)
  - before: 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.
  - after: 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 Mangomint it covers these actions: List appointments, Book appointment, Reschedule appointment, Find client, Export sales report.
- 2026-11-09 `cotlet_browser_open` changed (description)
  - before: 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.
  - after: 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 Mangomint it serves these actions: List appointments, Book appointment, Reschedule appointment, Find client, Export sales report.

Full history: https://api.protogrid.dev/v1/servers/dev.cotlet%2Fmangomint/changes

## Remotes

- https://cotlet.dev/mcp/v1/mangomint/connect (streamable-http, auth oauth2, reachable true, uptime30d 1)
- https://cotlet.dev/mcp/v1/mangomint (streamable-http, auth api_key ${MANGOMINT_TOKEN}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (31)

- `cotlet_app_guide`: 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 Mangomint it covers these actions: List appointments, Book appointment, Reschedule appointment, Find client, Export sales report.
- `cotlet_apps`: 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.
- `cotlet_balance`: The user's current credit balance. Free. Needs the user's Cotlet API key or sign-in.
- `cotlet_browser_click`: 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.
- `cotlet_browser_close`: 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.
- `cotlet_browser_download`: 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.
- `cotlet_browser_drag`: 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.
- `cotlet_browser_evaluate`: 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)
- `cotlet_browser_fill_form`: 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.
- `cotlet_browser_find`: 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.
- `cotlet_browser_hover`: 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.
- `cotlet_browser_navigate`: 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.
- `cotlet_browser_open`: 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 Mangomint it serves these actions: List appointments, Book appointment, Reschedule appointment, Find client, Export sales report.
- `cotlet_browser_press`: 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.
- `cotlet_browser_read`: 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.
- `cotlet_browser_screenshot`: 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.
- `cotlet_browser_scroll`: 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.
- `cotlet_browser_select`: 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.
- `cotlet_browser_tabs`: 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.
- `cotlet_browser_type`: 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.
- `cotlet_browser_upload`: 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.
- `cotlet_browser_wait`: 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.
- `cotlet_get_call`: 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.
- `cotlet_report_issue`: 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.
- `cotlet_upload_file`: 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.
- `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 and its credit balance. Free. Needs the user's Cotlet API key or sign-in.
- `mangomint_book_appointment`: Book appointment in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- `mangomint_export_sales_report`: Export sales report in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- `mangomint_find_client`: Find client in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- `mangomint_list_appointments`: List appointments in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).
- `mangomint_reschedule_appointment`: Reschedule appointment in the user's own Mangomint account from ChatGPT, Claude or any AI agent. Returns how to do it in Mangomint step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Mangomint Cloud Browser. Mangomint's official API: Mangomint has no public API and no developer docs (checked 11 Oct 2026).