# Joist MCP Server and API by Cotlet (remote · cotlet.dev)

Joist contractor estimating and invoicing MCP server: create estimate, convert estimate to invoice.

- Trust score: 71/100 (medium)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

> **Recent critical change**: Authorization (2026-11-11). See the changelog below before you install this server.

## Components

- remote · `cotlet.dev`: 71/100 (this document), [markdown](https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist.md), [page](https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist)
- remote · `cotlet.dev`: 40/100, [markdown](https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist-connect.md), [page](https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist-connect)

## Channel facts

- Endpoint: `https://cotlet.dev/mcp/v1/joist`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (cotlet_browser_click).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 60/100
  - 50% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 8811 tokens (~169/item across 52 items; 50 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 40/100
  - Stability observed for 12 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 97% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 52 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Joist MCP Server and API by Cotlet server?

Joist MCP Server and API by Cotlet is a hosted endpoint at https://cotlet.dev/mcp/v1/joist, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http dev-cotlet-joist 'https://cotlet.dev/mcp/v1/joist'
```

### Cursor

```json
{
  "mcpServers": {
    "dev-cotlet-joist": {
      "url": "https://cotlet.dev/mcp/v1/joist"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dev-cotlet-joist": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/joist"
    }
  }
}
```

### Codex

```toml
[mcp_servers.dev-cotlet-joist]
url = "https://cotlet.dev/mcp/v1/joist"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-cotlet-joist": {
      "type": "remote",
      "url": "https://cotlet.dev/mcp/v1/joist",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-cotlet-joist --url 'https://cotlet.dev/mcp/v1/joist' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  dev-cotlet-joist:
    url: "https://cotlet.dev/mcp/v1/joist"
```

### Netclaw

```json
{
  "McpServers": {
    "dev-cotlet-joist": {
      "Transport": "http",
      "Url": "https://cotlet.dev/mcp/v1/joist"
    }
  }
}
```

### Vellum

```bash
assistant mcp add dev-cotlet-joist -t streamable-http -u 'https://cotlet.dev/mcp/v1/joist'
```

### Other

```json
{
  "mcpServers": {
    "dev-cotlet-joist": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/joist"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-20 (score 70, −3)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “cotlet_browser_type” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 100% → 50%
- [functional] New resource “cotlet-refresh-button”

### 2026-11-19 (score 73, 0)

- [security] Tool “cotlet_upload_file” rewrote its description, which is the text the model reads

### 2026-11-18 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 72, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional regression] Schema quality: 151 → 169
- [cosmetic] “cotlet_browser_click” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_download” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_drag” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_evaluate” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_fill_form” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_find” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_hover” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_navigate” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_press” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_read” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_screenshot” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_scroll” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_select” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_type” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_upload” added an optional parameter “tab”
- [cosmetic] “cotlet_browser_wait” added an optional parameter “tab”

### 2026-11-16 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-15 (score 71, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “cotlet_whoami” rewrote its description, which is the text the model reads

### 2026-11-14 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (50)

### `cotlet_whoami` (~80 tokens)

Cotlet: who am I

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.

### `cotlet_apps` (~85 tokens)

Cotlet: apps I can use

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.

Input parameters:

- `app` (string): Only this app, e.g. skool.

### `cotlet_request_apps` (~170 tokens)

Cotlet: request access to apps

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.

Input parameters:

- `apps` (array, required): App slugs, e.g. ["skool", "substack"].
- `use_case` (string): What the user wants the agent to do in these apps, in their words.

### `cotlet_get_call` (~76 tokens)

Cotlet: check a 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.

Input parameters:

- `call_id` (string, required): call_id from the earlier call

### `cotlet_upload_file` (~125 tokens)

Cotlet: upload a file for a tool

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.

Input parameters:

- `content_type` (string): MIME type, e.g. image/jpeg.
- `name` (string): File name, e.g. photo.jpg.

### `cotlet_report_issue` (~364 tokens)

Cotlet: report a bug or a missing feature

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.

Input parameters:

- `app`: App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'.
- `call_id`: call_id of the call that went wrong, if any.
- `client`: Agent or tool sending this, e.g. 'Claude Code'.
- `description` (string, required): 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.
- `kind` (string, required): 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 th…
- `title` (string, required): One line, e.g. 'skool_list_members stops after 50 members'.
- `tool`: Tool or endpoint name, e.g. 'skool_list_members'.

### `cotlet_browser_open` (~125 tokens)

Open the browser

Starts the user's Joist Cloud Browser (a real Chrome on Cotlet, signed in to Joist as the user; use it for what the Joist tools do not cover) and opens `url`. Call it first. Only Joist pages open. Answers the page after it: the elements and text in view, with the same numbers. In Joist it serves these actions: Create estimate, Convert estimate to invoice, List invoices, Add client, Record payment.

Input parameters:

- `url` (string): A public http or https address, e.g. https://example.com.

### `cotlet_browser_navigate` (~200 tokens)

Go to a page

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.

Input parameters:

- `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.
- `history` (string): Instead of `url`.
- `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 th…
- `url` (string): A public http or https address, e.g. https://example.com.

### `cotlet_browser_read` (~154 tokens)

Read the page

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.

Input parameters:

- `element` (integer): Read only inside this element.
- `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 th…

### `cotlet_browser_find` (~141 tokens)

Find on the page

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.

Input parameters:

- `kind` (string): Only elements of this kind. Default: any.
- `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 th…
- `text` (string, required): Words to look for, any case.

### `cotlet_browser_screenshot` (~110 tokens)

See the page

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.

Input parameters:

- `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 th…

### `cotlet_browser_scroll` (~193 tokens)

Scroll the page

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.

Input parameters:

- `direction` (string): Default: down.
- `element` (integer): Scroll until this element is in view.
- `inside` (integer): Scroll inside this element, not the page.
- `screens` (number): Viewport heights, for down and up. Default: 0.8.
- `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 th…

### `cotlet_browser_click` (~300 tokens)

Click on the page

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.

Input parameters:

- `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.
- `dialog_text` (string): Text for a prompt dialog this step opens; implies accept.
- `double` (boolean): Double-click.
- `element` (integer): The element's number from the last read or step answer.
- `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 th…
- `x` (number): Instead of `element`: pixels from the left of the screenshot.
- `y` (number): With `x`: pixels from the top of the screenshot.

### `cotlet_browser_hover` (~160 tokens)

Point at the page

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.

Input parameters:

- `element` (integer): The element's number from the last read or step answer.
- `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 th…
- `x` (number): Instead of `element`: pixels from the left of the screenshot.
- `y` (number): With `x`: pixels from the top of the screenshot.

### `cotlet_browser_drag` (~211 tokens)

Drag on the page

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.

Input parameters:

- `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.
- `from` (object, required): An element number, or x and y of the screenshot.
- `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 th…
- `to` (object, required): An element number, or x and y of the screenshot.

### `cotlet_browser_type` (~334 tokens)

Type on the page

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.

Input parameters:

- `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.
- `element` (integer): The field's number from the last read. Leave it out to type where the focus is.
- `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.
- `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 th…
- `text` (string, required): The text to type.

### `cotlet_browser_fill_form` (~220 tokens)

Fill in a 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.

Input parameters:

- `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.
- `fields` (array, required): The fields in the order a person fills them.
- `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 th…

### `cotlet_browser_select` (~212 tokens)

Choose from a list

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.

Input parameters:

- `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.
- `element` (integer, required): The element's number from the last read or step answer.
- `option` (string, required): The option.
- `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 th…

### `cotlet_browser_press` (~262 tokens)

Press a key

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.

Input parameters:

- `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.
- `key` (string, required): 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` (integer): Times to press it. Default 1.
- `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 th…

### `cotlet_browser_upload` (~158 tokens)

Upload a file

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.

Input parameters:

- `element` (integer, required): The element's number from the last read or step answer.
- `files` (array, required): The files.
- `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 th…

### `cotlet_browser_download` (~160 tokens)

Download a file

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.

Input parameters:

- `element` (integer): The element's number from the last read or step answer.
- `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 th…
- `url` (string): A public http or https address, e.g. https://example.com.

### `cotlet_browser_evaluate` (~165 tokens)

Run a script on the page

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)

Input parameters:

- `script` (string, required): A function body that returns.
- `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 th…

### `cotlet_browser_wait` (~144 tokens)

Wait for the page

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.

Input parameters:

- `seconds` (number): At most.
- `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 th…
- `text` (string): Text to wait for.

### `cotlet_browser_close` (~43 tokens)

Close the browser

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_app_guide` (~171 tokens)

Cotlet: how to work in an app

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 Joist it covers these actions: Create estimate, Convert estimate to invoice, List invoices, Add client, Record payment.

Input parameters:

- `app` (string): The app's name or Cotlet slug. Default: Joist.
- `task` (string): What the user wants done in the app, in their words.

### `export_documents` (~145 tokens)

Export documents

Joist's monthly CSV of estimates or invoices: number, client, subtotal, tax, total, dates, payments. Runs the same export as the Export button on Joist's Estimates or Invoices page for one month, by date issued: number, client name, subtotal, one column per tax name, total, date issued, date created and, for invoices, payment received less refunds. Returns the columns, the rows and the CSV text as Joist made it, at most 2000 rows parsed. Line items are not in the export; use get_estimate or get_invoice.

Input parameters:

- `month` (string, required): Month as YYYY-MM.
- `type` (string, required)

### `get_client` (~56 tokens)

Get client

One client card: every email and phone, billing and service address, notes and tags. Returns one client with all emails and phones, the billing and service address, notes and tags.

Input parameters:

- `client_id` (string, required): From list_clients.

### `get_estimate` (~87 tokens)

Get estimate

Full estimate: client, line items, tax, discount, deposit, expiry, approval and signature. Returns one estimate with its client, every line item with its taxes, subtotal, discount, tax, total, requested deposit, expiry, approval status, signature date and the client's link. Read it before changing or sending the estimate.

Input parameters:

- `estimate_id` (string, required): From list_estimates.

### `get_invoice` (~103 tokens)

Get invoice

Full invoice: client, line items, tax, discount, deposit, due date, balance and every payment. Returns one invoice with its client, every line item with its taxes, subtotal, discount, tax, total, requested deposit, payment terms and due date, amount paid, balance due, overdue, the estimate it came from, and the payments and refunds recorded on it. Check the payments before recording another.

Input parameters:

- `invoice_id` (string, required): From list_invoices.

### `get_report` (~256 tokens)

Get report

A Joist report for a date range: revenue, invoices, estimates or sales tax, with the period total. Returns one of the reports on Joist's Reports page for a date range, optionally for one client: revenue received per invoice (partial payments included), invoice statuses and balances, estimate statuses, or sales tax collected per tax. total is the report's total for the period. Joist updates report numbers once a day, so today's documents and payments show tomorrow. Reports are part of Joist Elite (and the trial). Pass next_cursor back as cursor.

Input parameters:

- `client` (string): Only this client, by exact name.
- `cursor` (string): next_cursor from the previous call.
- `from` (string, required): First day of the period.
- `limit` (integer)
- `report` (string, required): revenue (payments received per invoice, with balances at the start and end of the period), invoices (status, total, balance and due date), estimates (status, total, expiry) or sales_tax (tax collecte…
- `tax_name` (string): sales_tax: only this tax, by name.
- `to` (string, required): Last day, up to a year after from.

### `list_clients` (~118 tokens)

List clients

Clients in your account with name, email, phone and address. Lists your Joist clients A to Z, one Joist page per call, or the matches of search (name, email, phone or address). Pass next_cursor back as cursor; an empty page ends the list. client_id goes to create_estimate, create_invoice and the client filter of list_estimates and list_invoices.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `search` (string): Part of a name, email, phone or address.

### `list_estimates` (~185 tokens)

List estimates

Estimates with number, client, total, expiry, status, approval, and whether it was emailed or signed. Lists estimates newest first, from one of the panel's tabs (approval pending, approved, declined or all), optionally searched by client name or number or limited to one client. status is Joist's: draft, issued (sent), invoiced (an invoice was made from it). email_status says whether it was emailed (unsent, sent) and signed whether the client signed it. Pass next_cursor back as cursor.

Input parameters:

- `approval` (string): The panel's tabs: pending, approved, declined, or all (default).
- `client_id` (string): Only this client's estimates (list_clients).
- `cursor` (string): next_cursor from the previous call.
- `limit` (integer)
- `search` (string): Client name or estimate number.

### `list_invoices` (~194 tokens)

List invoices

Invoices with client, total, amount paid, balance due, due date and overdue. Active, paid or all. Lists invoices newest first from the panel's Active tab (not paid in full; default) or Paid tab, or all. overdue keeps the active ones past their due date, which is the invoice date plus its payment terms. status is Joist's: draft, issued (sent), partial or paid. Search matches client name or number. Each page of overdue may hold fewer rows than limit; follow next_cursor until it is null.

Input parameters:

- `client_id` (string): Only this client's invoices (list_clients).
- `cursor` (string): next_cursor from the previous call.
- `limit` (integer)
- `search` (string): Client name or invoice number.
- `view` (string): active (not paid in full; default), overdue (active and past due), paid, or all.

### `list_items` (~131 tokens)

List items

Saved items from your Items list with rate and description, plus your tax rates. Lists the items you saved in Joist, one Joist page per call, or the matches of search on the name. Reuse their names and rates as line items (item_id) instead of guessing prices. The first page also lists your tax rates (tax_id for create_estimate and create_invoice); later pages leave taxes empty. Pass next_cursor back as cursor; an empty page ends the list.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `search` (string): Part of the item name.

### `add_client` (~111 tokens)

Add client

New client in your Clients list, ready for estimates and invoices. Creates a client card in Joist with name and optional email, phone, billing address and notes. It reaches no one. Joist does not refuse a duplicate name, so check list_clients first.

Input parameters:

- `address` (object): Billing address.
- `email` (string): Where documents are emailed.
- `name` (string, required): Client or company name.
- `notes` (string): Notes on the client card.
- `phone` (string)

### `add_item` (~83 tokens)

Add item

Save a service or material to your Items list. Saves an item with a name, rate and optional description to your Items list, so later estimates reuse it. It reaches no one.

Input parameters:

- `description` (string): Shown on the line item.
- `name` (string, required): Item name.
- `rate` (number, required): Price per unit, e.g. 350.

### `convert_estimate_to_invoice` (~99 tokens)

Convert estimate to invoice

Generate an invoice with everything from the estimate. Nothing is sent to the client. Does what Generate Invoice does in Joist: a new invoice with the estimate's client, lines, tax, discount and deposit, and the estimate becomes approved. Joist allows more than one invoice from an estimate, so an estimate already invoiced is refused here. Nothing is sent until send_invoice.

Input parameters:

- `estimate_id` (string, required): From list_estimates.

### `create_estimate` (~295 tokens)

Create estimate

New saved estimate with line items, tax, discount, deposit and expiry. Nothing is sent to the client. Creates an estimate for a client with the next estimate number, copying the client's name, email, phone and address as Joist does. tax_rate applies one percent to every line, reusing your saved rate with that percent or adding one; tax_id picks a saved rate. A deposit shows as Deposit Due. expires_on cannot be in the past. Nothing is sent: the client sees it only after send_estimate. Joist computes the total.

Input parameters:

- `client_id` (string, required): From list_clients or add_client.
- `deposit` (object): Requested deposit, shown as Deposit Due: percent or amount.
- `discount` (object): Discount on the subtotal: percent or amount.
- `document_date` (string): Estimate date. Default: today.
- `expires_on` (string): Last day the estimate is valid.
- `line_items` (array, required): Lines: name, rate, optional quantity, description, item_id.
- `notes` (string): Notes shown on the document.
- `po_number` (string): PO number.
- `tax_id` (string): A saved tax rate from list_items (taxes) instead of tax_rate.
- `tax_rate` (number): Tax percent on every line, e.g. 7.25. Uses your tax rate with that percent, or adds one.

### `create_invoice` (~270 tokens)

Create invoice

New saved invoice for a client without an estimate. Nothing is sent to the client. Creates an invoice with the next invoice number, the client's details, line items, tax, discount, deposit and payment terms (due date = invoice date + payment_terms_days). For work you estimated, use convert_estimate_to_invoice instead. Nothing is sent: the client sees it only after send_invoice.

Input parameters:

- `client_id` (string, required): From list_clients or add_client.
- `deposit` (object): Requested deposit, shown as Deposit Due: percent or amount.
- `discount` (object): Discount on the subtotal: percent or amount.
- `document_date` (string): Invoice date. Default: today.
- `line_items` (array, required): Lines: name, rate, optional quantity, description, item_id.
- `notes` (string): Notes shown on the document.
- `payment_terms_days` (integer): Days after the invoice date the payment is due (0: due on receipt).
- `po_number` (string): PO number.
- `tax_id` (string): A saved tax rate from list_items (taxes) instead of tax_rate.
- `tax_rate` (number): Tax percent on every line, e.g. 7.25. Uses your tax rate with that percent, or adds one.

### `delete_estimate` (~52 tokens)

Delete estimate

Delete an estimate for good. Deletes the estimate from Joist; it cannot be undone and the client's link stops working. An invoice made from it stays.

Input parameters:

- `estimate_id` (string, required): From list_estimates.

### `delete_invoice` (~63 tokens)

Delete invoice

Delete an invoice that has no payments, for good. Deletes the invoice from Joist; it cannot be undone and the client's link stops working. An invoice with payments recorded is refused, so your payment history stays.

Input parameters:

- `invoice_id` (string, required): From list_invoices.

### `record_payment` (~171 tokens)

Record payment

Record a cash, check, credit card or bank transfer payment on an invoice; paid in full moves to Paid. Records a payment received outside Joist Payments, as Record Payment does in Joist. Partial payments are allowed and an invoice can hold several; an amount above the balance due or a date in the future is refused. Once paid in full the invoice moves from Active to Paid. Check get_invoice first so the same check is not entered twice. By default you confirm each call, and you can switch that off for this tool.

Input parameters:

- `amount` (number, required): Amount received, e.g. 1200.50.
- `invoice_id` (string, required): From list_invoices.
- `method` (string, required): How the client paid.
- `paid_on` (string): Payment date. Default: today.

### `send_estimate` (~171 tokens)

Send estimate

Email the estimate to the client from Joist with its link and PDF. Emails the estimate from Joist, as its Send button does: the client gets a link to view and sign it and the PDF. Without to it goes to the client email on the document; subject and message default to Joist's subject and your saved estimate message. A draft becomes issued; a sent estimate can be sent again. By default you confirm each call, and you can switch that off for this tool. Waits for the owner's approval.

Input parameters:

- `estimate_id` (string, required): From list_estimates.
- `message` (string): Default: your estimate email message.
- `subject` (string): Default: Joist's subject.
- `to` (array): Recipients. Default: the client email on the document.

### `send_invoice` (~170 tokens)

Send invoice

Email the invoice to the client from Joist with its link and PDF. Emails the invoice from Joist, as its Send button does: the client gets a link to view and pay it and the PDF. Without to it goes to the client email on the document; subject and message default to Joist's subject and your saved invoice message. A draft becomes issued; a sent invoice can be sent again. By default you confirm each call, and you can switch that off for this tool. Waits for the owner's approval.

Input parameters:

- `invoice_id` (string, required): From list_invoices.
- `message` (string): Default: your invoice email message.
- `subject` (string): Default: Joist's subject.
- `to` (array): Recipients. Default: the client email on the document.

### `update_estimate` (~265 tokens)

Update estimate

Change an estimate's lines, tax, discount, deposit, expiry, notes or PO number. Nothing is sent. Changes only the fields you pass. line_items replaces every line (the tax stays unless you pass tax_rate, tax_id or remove_tax). tax_rate or tax_id alone re-taxes the current lines. discount or deposit null removes it. Joist recomputes the total. Nothing is sent; a client who already got the estimate sees the change behind the same link.

Input parameters:

- `deposit` (object|null): null removes it.
- `discount` (object|null): null removes it.
- `estimate_id` (string, required): From list_estimates.
- `expires_on` (string): New last valid day.
- `line_items` (array): Replaces every line. Leave out to keep the lines.
- `notes` (string): Notes shown on the document.
- `po_number` (string): PO number.
- `remove_tax` (boolean): true takes the tax off every line.
- `tax_id` (string): A saved tax rate from list_items (taxes) instead of tax_rate.
- `tax_rate` (number): Tax percent on every line, e.g. 7.25. Uses your tax rate with that percent, or adds one.

### `joist_create_estimate` (~109 tokens)

Create estimate in Joist

Create estimate in the user's own Joist account from ChatGPT, Claude or any AI agent. Returns how to do it in Joist step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joist Cloud Browser. Joist's official API: Joist has no public API (checked 26 Oct 2026): its help center and pricing page document none, and there are no webhooks.

### `joist_convert_estimate_to_invoice` (~113 tokens)

Convert estimate to invoice in Joist

Convert estimate to invoice in the user's own Joist account from ChatGPT, Claude or any AI agent. Returns how to do it in Joist step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joist Cloud Browser. Joist's official API: Joist has no public API (checked 26 Oct 2026): its help center and pricing page document none, and there are no webhooks.

### `joist_list_invoices` (~109 tokens)

List invoices in Joist

List invoices in the user's own Joist account from ChatGPT, Claude or any AI agent. Returns how to do it in Joist step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joist Cloud Browser. Joist's official API: Joist has no public API (checked 26 Oct 2026): its help center and pricing page document none, and there are no webhooks.

### `joist_add_client` (~108 tokens)

Add client in Joist

Add client in the user's own Joist account from ChatGPT, Claude or any AI agent. Returns how to do it in Joist step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joist Cloud Browser. Joist's official API: Joist has no public API (checked 26 Oct 2026): its help center and pricing page document none, and there are no webhooks.

### `joist_record_payment` (~108 tokens)

Record payment in Joist

Record payment in the user's own Joist account from ChatGPT, Claude or any AI agent. Returns how to do it in Joist step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Joist Cloud Browser. Joist's official API: Joist has no public API (checked 26 Oct 2026): its help center and pricing page document none, and there are no webhooks.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist#diagnostics

## Score history

- 2026-11-21: 71
- 2026-11-20: 70
- 2026-11-19: 73
- 2026-11-18: 73
- 2026-11-17: 72
- 2026-11-16: 72
- 2026-11-15: 71
- 2026-11-14: 71
- 2026-11-13: 70
- 2026-11-12: 70
- 2026-11-11: 70
- 2026-11-10: 26
- 2026-11-09: 69

## Common questions

### What is the Joist MCP Server and API by Cotlet server?

Joist MCP Server and API by Cotlet is listed in the public MCP registry as dev.cotlet/joist. Joist contractor estimating and invoicing MCP server: create estimate, convert estimate to invoice. This page covers its hosted endpoint (https://cotlet.dev/mcp/v1/joist).

### Is the Joist MCP Server and API by Cotlet server safe to use?

Joist MCP Server and API by Cotlet scores 71 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Joist MCP Server and API by Cotlet server expose?

Joist MCP Server and API by Cotlet exposes 50 tools: cotlet_whoami, cotlet_apps, cotlet_request_apps, cotlet_get_call, cotlet_upload_file, and 45 more. Their descriptions and schemas cost roughly 7,935 tokens of context every time the server is loaded.

### Does the Joist MCP Server and API by Cotlet server require authentication?

No. We connected to Joist MCP Server and API by Cotlet without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Joist MCP Server and API by Cotlet server still maintained?

Joist MCP Server and API by Cotlet is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Joist MCP Server and API by Cotlet server?

VerifyMCP ran 13 checks on Joist MCP Server and API by Cotlet, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://cotlet.dev/mcp/v1/joist
- Authorisation metadata: https://cotlet.dev/.well-known/oauth-protected-resource/mcp/v1/joist
- Repository: https://github.com/cotletdev/joist-api-mcp-server
- Website: https://cotlet.dev/integrations/joist-api-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist.json
- HTML version of this page: https://verifymcp.io/servers/dev-cotlet-joist/mcp-v1-joist
