Substack MCP Server and API by Cotlet is an MCP server published by dev.cotlet, hosted at cotlet.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 83 tools, including cotlet_whoami, cotlet_apps, cotlet_request_apps, cotlet_get_call, cotlet_upload_file.
Substack writer newsletter publishing MCP server: create post, schedule post, publish Note.
1,987 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task and sign-in link. Free. Needs the user's Cotlet API key or sign-in.
No parameters.
{
"name": "cotlet_whoami",
"title": "Cotlet: who am I",
"description": "The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task and sign-in link. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: who am I",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| app | string | Only this app, e.g. skool. |
{
"name": "cotlet_apps",
"title": "Cotlet: apps I can use",
"description": "The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: apps I can use",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser. Access says nothing about whether a task works there: check that in the browser. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| apps * | array | App slugs, e.g. ["skool", "substack"]. |
| use_case | string | What the user wants the agent to do in these apps, in their words. |
{
"name": "cotlet_request_apps",
"title": "Cotlet: request access to apps",
"description": "Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser. Access says nothing about whether a task works there: check that in the browser. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"required": [
"apps"
],
"properties": {
"apps": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "App slugs, e.g. [\"skool\", \"substack\"]."
},
"use_case": {
"type": "string",
"maxLength": 1000,
"description": "What the user wants the agent to do in these apps, in their words."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: request access to apps",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.
| Parameter | Type | Description |
|---|---|---|
| call_id * | string | call_id from the earlier call |
{
"name": "cotlet_get_call",
"title": "Cotlet: check a call",
"description": "Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.",
"inputSchema": {
"type": "object",
"required": [
"call_id"
],
"properties": {
"call_id": {
"type": "string",
"description": "call_id from the earlier call"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: check a call",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL takes one stored file (a failed PUT can be sent again). Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| name | string | File name, e.g. photo.jpg. |
| content_type | string | MIME type, e.g. image/jpeg. |
{
"name": "cotlet_upload_file",
"title": "Cotlet: upload a file for a tool",
"description": "Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {\"file_id\": \"...\"}. Up to 25 MB, the URL takes one stored file (a failed PUT can be sent again). Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "File name, e.g. photo.jpg."
},
"content_type": {
"type": "string",
"description": "MIME type, e.g. image/jpeg."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: upload a file for a tool",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to report: do the task in the browser. A feature the user asks for goes as feature_request. A report promises nothing: tell the user it was sent, never that something will be built or fixed, or when. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| app | any | App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'. |
| kind * | string | bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user asked for. missing_feature: a step the task needed that you tried and could not do, in the browser or with a tool. other: anything else. |
| tool | any | Tool or endpoint name, e.g. 'skool_list_members'. |
| title * | string | One line, e.g. 'skool_list_members stops after 50 members'. |
| client | any | Agent or tool sending this, e.g. 'Claude Code'. |
| call_id | any | call_id of the call that went wrong, if any. |
| description * | string | What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets. |
Starts the user's Substack Cloud Browser (a real Chrome on Cotlet, signed in to Substack as the user; use it for what the Substack tools do not cover) and opens `url`. Call it first. Only Substack pages open. Answers the page after it: the elements and text in view, with the same numbers. In Substack it serves these actions: Create post, Schedule post, Publish Note, Reply to Notes, Send direct message, Moderate comments, List subscribers, Get post stats.
| Parameter | Type | Description |
|---|---|---|
| url | string | A public http or https address, e.g. https://example.com. |
{
"name": "cotlet_browser_open",
"title": "Open the browser",
"description": "Starts the user's Substack Cloud Browser (a real Chrome on Cotlet, signed in to Substack as the user; use it for what the Substack tools do not cover) and opens `url`. Call it first. Only Substack pages open. Answers the page after it: the elements and text in view, with the same numbers. In Substack it serves these actions: Create post, Schedule post, Publish Note, Reply to Notes, Send direct message, Moderate comments, List subscribers, Get post stats.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Open the browser",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| url | string | A public http or https address, e.g. https://example.com. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| history | string | Instead of `url`. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_navigate",
"title": "Go to a page",
"description": "Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"history": {
"enum": [
"back",
"forward"
],
"type": "string",
"description": "Instead of `url`."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Go to a page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside one element (a dialog, a form, a list). Never returns field values, cookies or storage.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| element | integer | Read only inside this element. |
{
"name": "cotlet_browser_read",
"title": "Read the page",
"description": "The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside one element (a dialog, a form, a list). Never returns field values, cookies or storage.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Read only inside this element."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Read the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| kind | string | Only elements of this kind. Default: any. |
| text * | string | Words to look for, any case. |
{
"name": "cotlet_browser_find",
"title": "Find on the page",
"description": "Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"kind": {
"enum": [
"link",
"button",
"field",
"any"
],
"type": "string",
"description": "Only elements of this kind. Default: any."
},
"text": {
"type": "string",
"maxLength": 200,
"description": "Words to look for, any case."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find on the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
{
"name": "cotlet_browser_screenshot",
"title": "See the page",
"description": "A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
}
},
"additionalProperties": false
},
"annotations": {
"title": "See the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| inside | integer | Scroll inside this element, not the page. |
| element | integer | Scroll until this element is in view. |
| screens | number | Viewport heights, for down and up. Default: 0.8. |
| direction | string | Default: down. |
{
"name": "cotlet_browser_scroll",
"title": "Scroll the page",
"description": "Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"inside": {
"type": "integer",
"minimum": 1,
"description": "Scroll inside this element, not the page."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element is in view."
},
"screens": {
"type": "number",
"maximum": 10,
"description": "Viewport heights, for down and up. Default: 0.8.",
"exclusiveMinimum": 0
},
"direction": {
"enum": [
"down",
"up",
"top",
"bottom"
],
"type": "string",
"description": "Default: down."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Scroll the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that would open a new tab opens in this one. Buttons that pay or buy, and sign-in and account pages, are refused.
| Parameter | Type | Description |
|---|---|---|
| x | number | Instead of `element`: pixels from the left of the screenshot. |
| y | number | With `x`: pixels from the top of the screenshot. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| button | string | right opens the page's own context menu. Default: left. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| double | boolean | Double-click. |
| element | integer | The element's number from the last read or step answer. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| x | number | Instead of `element`: pixels from the left of the screenshot. |
| y | number | With `x`: pixels from the top of the screenshot. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| element | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_hover",
"title": "Point at the page",
"description": "Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Point at the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| to * | object | An element number, or x and y of the screenshot. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| from * | object | An element number, or x and y of the screenshot. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_drag",
"title": "Drag on the page",
"description": "Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"description": "An element number, or x and y of the screenshot.",
"additionalProperties": false
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"from": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"description": "An element number, or x and y of the screenshot.",
"additionalProperties": false
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Drag on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells and editors that read does not number (Google Sheets, Docs), click the place first; there a tab in `text` presses Tab and a line break Enter, so one call fills a table. Answers the page after it: the elements and text in view, with the same numbers. A password or code the user gave you goes in like any text; card fields are refused.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| text * | string | The text to type. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| slowly | boolean | Key by key, for a search or address field whose suggestions do not appear. |
| submit | boolean | Press Enter after typing, e.g. to search. |
| element | integer | The field's number from the last read. Leave it out to type where the focus is. |
| dialog_text | string |
Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button after. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| fields * | array | The fields in the order a person fills them. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_fill_form",
"title": "Fill in a form",
"description": "Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button after. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"fields"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"element",
"value"
],
"properties": {
"value": {
"type": [
"string",
"boolean"
],
"description": "Text, option, or true/false."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"maxItems": 30,
"minItems": 1,
"description": "The fields in the order a person fills them."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Fill in a form",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| option * | string | The option. |
| element * | integer | The element's number from the last read or step answer. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_select",
"title": "Choose from a list",
"description": "Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"element",
"option"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Choose from a list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| key * | string | One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or one character such as a or 5. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| repeat | integer | Times to press it. Default 1. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_press",
"title": "Press a key",
"description": "Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"anyOf": [
{
"enum": [
"Enter",
"Tab",
"Shift+Tab",
"Escape",
"Backspace",
"Delete",
"Space",
"ArrowDown",
"ArrowUp",
"ArrowLeft",
"ArrowRight",
"PageDown",
"PageUp",
"Home",
"End"
]
},
{
"pattern": "^[ -~]$"
}
],
"description": "One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or one character such as a or 5."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"repeat": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Times to press it. Default 1."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Press a key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Puts files into file field or upload button `element`: each file is {"url": "https://..."} or {"file_id": "..."} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| files * | array | The files. |
| element * | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_upload",
"title": "Upload a file",
"description": "Puts files into file field or upload button `element`: each file is {\"url\": \"https://...\"} or {\"file_id\": \"...\"} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"element",
"files"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public file URL."
},
"file_id": {
"type": "string",
"description": "A file uploaded to Cotlet."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1,
"description": "The files."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Upload a file",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| url | string | A public http or https address, e.g. https://example.com. |
| element | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_download",
"title": "Download a file",
"description": "Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Download a file",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or storage; a filled field's value reads [hidden by Cotlet]. Example: return [...document.querySelectorAll('h2')].map(h => h.innerText)
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| script * | string | A function body that returns. |
{
"name": "cotlet_browser_evaluate",
"title": "Run a script on the page",
"description": "Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or storage; a filled field's value reads [hidden by Cotlet]. Example: return [...document.querySelectorAll('h2')].map(h => h.innerText)",
"inputSchema": {
"type": "object",
"required": [
"script"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"script": {
"type": "string",
"maxLength": 20000,
"description": "A function body that returns."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Run a script on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| text | string | Text to wait for. |
| seconds | number | At most. |
{
"name": "cotlet_browser_wait",
"title": "Wait for the page",
"description": "Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"text": {
"type": "string",
"maxLength": 200,
"description": "Text to wait for."
},
"seconds": {
"type": "number",
"maximum": 20,
"description": "At most.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"title": "Wait for the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "cotlet_browser_close",
"title": "Close the browser",
"description": "Ends the browser session when the task is done: the browser keeps its cookies and sleeps, and the per-minute charge stops. Answers the session's minutes and credits.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Close the browser",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session. For Substack it covers these actions: Create post, Schedule post, Publish Note, Reply to Notes, Send direct message, Moderate comments, List subscribers, Get post stats.
| Parameter | Type | Description |
|---|---|---|
| app | string | The app's name or Cotlet slug. Default: Substack. |
| task | string | What the user wants done in the app, in their words. |
{
"name": "cotlet_app_guide",
"title": "Cotlet: how to work in an app",
"description": "How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session. For Substack it covers these actions: Create post, Schedule post, Publish Note, Reply to Notes, Send direct message, Moderate comments, List subscribers, Get post stats.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"maxLength": 120,
"description": "The app's name or Cotlet slug. Default: Substack."
},
"task": {
"type": "string",
"maxLength": 500,
"description": "What the user wants done in the app, in their words."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: how to work in an app",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The full subscriber list as a CSV download link, with the row count. Builds the same CSV as Export in the subscriber dashboard: email, name, subscription type, activity rating and start date. Substack builds the file in the background; the call waits up to about a minute and otherwise asks you to try again later. The link needs no sign-in and works until expires_at, 24 hours when we recorded it. For filtered pages use list_subscribers.
No parameters.
{
"name": "export_subscribers",
"title": "Export subscribers",
"description": "The full subscriber list as a CSV download link, with the row count. Builds the same CSV as Export in the subscriber dashboard: email, name, subscription type, activity rating and start date. Substack builds the file in the background; the call waits up to about a minute and otherwise asks you to try again later. The link needs no sign-in and works until expires_at, 24 hours when we recorded it. For filtered pages use list_subscribers.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Export subscribers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Where your subscribers live, and which publications share your readers. Returns Analytics > Statistics > Audience: subscriber counts per country (region world, ISO codes such as us, gb) or per US state (region usa, codes such as ny, ca), all subscribers or paid only, the number of countries and states with any subscriber, and the publications whose readers overlap most with yours. Substack computes these in the background; a new publication has empty lists for a while.
| Parameter | Type | Description |
|---|---|---|
| region | string | world (by country) or usa (by state). Default: world. |
| paid_only | boolean | Count paid subscribers only. Default: false. |
{
"name": "get_audience_insights",
"title": "Get audience insights",
"description": "Where your subscribers live, and which publications share your readers. Returns Analytics > Statistics > Audience: subscriber counts per country (region world, ISO codes such as us, gb) or per US state (region usa, codes such as ny, ca), all subscribers or paid only, the number of countries and states with any subscriber, and the publications whose readers overlap most with yours. Substack computes these in the background; a new publication has empty lists for a while.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"region": {
"enum": [
"world",
"usa"
],
"type": "string",
"description": "world (by country) or usa (by state). Default: world."
},
"paid_only": {
"type": "boolean",
"description": "Count paid subscribers only. Default: false."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get audience insights",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The latest messages of one direct-message conversation, oldest first. Returns who is in the conversation and its latest messages as the chat window first shows them, oldest first, with sender, text and time. Opening a conversation this way marks nothing read.
| Parameter | Type | Description |
|---|---|---|
| conversation_id * | string | Conversation ID from list_conversations. |
{
"name": "get_conversation",
"title": "Get conversation",
"description": "The latest messages of one direct-message conversation, oldest first. Returns who is in the conversation and its latest messages as the chat window first shows them, oldest first, with sender, text and time. Opening a conversation this way marks nothing read.",
"inputSchema": {
"type": "object",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"description": "Conversation ID from list_conversations."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get conversation",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Day by day: total and paid subscribers, followers and views. Returns one row per day of the period, as the charts on the dashboard home and in Audience: total subscribers, paid subscribers and followers at the end of the day, and the day's views across your site and the app. Days Substack has no number for are null; a young publication starts on the day it was made.
| Parameter | Type | Description |
|---|---|---|
| period | string | Default: 30d. |
{
"name": "get_daily_stats",
"title": "Get daily stats",
"description": "Day by day: total and paid subscribers, followers and views. Returns one row per day of the period, as the charts on the dashboard home and in Audience: total subscribers, paid subscribers and followers at the end of the day, and the day's views across your site and the app. Days Substack has no number for are null; a young publication starts on the day it was made.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d",
"365d"
],
"type": "string",
"description": "Default: 30d."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get daily stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your Substack home feed: posts and Notes, For you or Following. Returns one page of the home feed of the Substack app, split into posts and Notes in feed order. for_you is Substack's own mix; following holds only people and publications you follow or subscribe to. Suggestions of people to follow are left out. Reading marks nothing seen. Page with next_cursor; the feed is personal and changes between calls.
| Parameter | Type | Description |
|---|---|---|
| tab | string | for_you (Substack's picks) or following (whom you follow). Default: for_you. |
| cursor | string | next_cursor from the previous page. |
{
"name": "get_feed",
"title": "Get feed",
"description": "Your Substack home feed: posts and Notes, For you or Following. Returns one page of the home feed of the Substack app, split into posts and Notes in feed order. for_you is Substack's own mix; following holds only people and publications you follow or subscribe to. Suggestions of people to follow are left out. Reading marks nothing seen. Page with next_cursor; the feed is personal and changes between calls.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"tab": {
"enum": [
"for_you",
"following"
],
"type": "string",
"description": "for_you (Substack's picks) or following (whom you follow). Default: for_you."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get feed",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Full post: title, subtitle, body as Markdown, audience, URL and dates. Returns one post of your publication, draft, scheduled or published, with its full body as Markdown, including the paywalled part. Images come back as URLs. Buttons, embeds and footnotes come back as plain text, so writing the body back with update_draft drops them. A scheduled post also has publish_at.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "get_post",
"title": "Get post",
"description": "Full post: title, subtitle, body as Markdown, audience, URL and dates. Returns one post of your publication, draft, scheduled or published, with its full body as Markdown, including the paywalled part. Images come back as URLs. Buttons, embeds and footnotes come back as plain text, so writing the body back with update_draft drops them. A scheduled post also has publish_at.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get post",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Who liked and commented on a post, and the subscribers it won and lost. Returns the Engagement and Growth parts of a post's stats: like and comment counts with the people behind them (name and handle, never email), and the free signups, paid subscriptions and unsubscribes Substack credits to the post. Counts keep changing for days after a send.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "get_post_engagement",
"title": "Get post engagement",
"description": "Who liked and commented on a post, and the subscribers it won and lost. Returns the Engagement and Growth parts of a post's stats: like and comment counts with the people behind them (name and handle, never email), and the free signups, paid subscriptions and unsubscribes Substack credits to the post. Counts keep changing for days after a send.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get post engagement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Recipients, opens, open rate, views, likes, restacks and subscribers gained. Returns the engagement numbers of one published post, as on its stats page in the dashboard. Email numbers cover the send; views include the web; likes are reactions. A draft or scheduled post returns an error. Numbers keep growing for days after a send, so check again later.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "get_post_stats",
"title": "Get post stats",
"description": "Recipients, opens, open rate, views, likes, restacks and subscribers gained. Returns the engagement numbers of one published post, as on its stats page in the dashboard. Email numbers cover the send; views include the web; likes are reactions. A draft or scheduled post returns an error. Numbers keep growing for days after a send, so check again later.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get post stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Where a post's readers came from: sources, categories and devices. Returns the Traffic part of a post's stats: each source (app, email, a website, search) with its views, share of all views and the free and paid subscribers it brought, the share per source category and per device. A post nobody has read yet returns empty lists.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "get_post_traffic",
"title": "Get post traffic",
"description": "Where a post's readers came from: sources, categories and devices. Returns the Traffic part of a post's stats: each source (app, email, a website, search) with its views, share of all views and the free and paid subscribers it brought, the share per source category and per device. A post nobody has read yet returns empty lists.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get post traffic",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Total and paid subscribers, new subscribers, paid cancellations and estimated revenue for a period. Totals are from the publisher dashboard at the end of the period (7, 30 or 90 days). subscribers_churned counts paid cancellations only; Substack keeps no count of free unsubscribes. subscribers_new is the growth in total subscribers plus those cancellations. revenue_usd is not money received: it is the dashboard's annualized revenue at the end of the period, times the period's share of a year.
| Parameter | Type | Description |
|---|---|---|
| period | string | 7d, 30d or 90d. Default: 30d. |
{
"name": "get_publication_stats",
"title": "Get publication stats",
"description": "Total and paid subscribers, new subscribers, paid cancellations and estimated revenue for a period. Totals are from the publisher dashboard at the end of the period (7, 30 or 90 days). subscribers_churned counts paid cancellations only; Substack keeps no count of free unsubscribes. subscribers_new is the growth in total subscribers plus those cancellations. revenue_usd is not money received: it is the dashboard's annualized revenue at the end of the period, times the period's share of a year.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "7d, 30d or 90d. Default: 30d."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get publication stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How many unread direct messages, message requests and activity notifications you have. Returns the badges of the Substack app: unread direct messages, pending message requests and unread activity (likes, replies, new followers, restacks). Reading them marks nothing read.
No parameters.
{
"name": "get_unread_counts",
"title": "Get unread counts",
"description": "How many unread direct messages, message requests and activity notifications you have. Returns the badges of the Substack app: unread direct messages, pending message requests and unread activity (likes, replies, new followers, restacks). Reading them marks nothing read.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Get unread counts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your Substack notifications: replies, likes, new followers, restacks, newest first. Returns the Activity tab of the Substack app, newest first. type is Substack's own name, e.g. note_reply, note_like, comment_reply, comment_like, post_like, follow, restack or mention. from lists the latest people behind a grouped item and people counts all of them. A reply or mention carries its comment_id and text; on_comment_id and on_post_id point at what it was about. Reading the list marks nothing read. Page with next_cursor.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | next_cursor from the previous page. |
| filter | string | all, replies (replies and mentions) or restacks. Default: all. |
{
"name": "list_activity",
"title": "List activity",
"description": "Your Substack notifications: replies, likes, new followers, restacks, newest first. Returns the Activity tab of the Substack app, newest first. type is Substack's own name, e.g. note_reply, note_like, comment_reply, comment_like, post_like, follow, restack or mention. from lists the latest people behind a grouped item and people counts all of them. A reply or mention carries its comment_id and text; on_comment_id and on_post_id point at what it was about. Reading the list marks nothing read. Page with next_cursor.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"filter": {
"enum": [
"all",
"replies",
"restacks"
],
"type": "string",
"description": "all, replies (replies and mentions) or restacks. Default: all."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List activity",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Comments on a post, with author, text and whether you replied. Returns all comments of one post at once, oldest first, with replies nested under their parent. Deleted comments are left out. replied is true when you answered anywhere in the thread under the comment; unanswered_only keeps only top-level comments where you did not. Pass comment_id to reply_to_comment.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
| unanswered_only | boolean | Skip threads you already replied to. |
{
"name": "list_comments",
"title": "List comments",
"description": "Comments on a post, with author, text and whether you replied. Returns all comments of one post at once, oldest first, with replies nested under their parent. Deleted comments are left out. replied is true when you answered anywhere in the thread under the comment; unanswered_only keeps only top-level comments where you did not. Pass comment_id to reply_to_comment.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
},
"unanswered_only": {
"type": "boolean",
"description": "Skip threads you already replied to."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List comments",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your direct-message conversations, latest first, with the last message. Returns your Substack chat inbox: one-to-one and group direct messages with who they are with, the last message, its time, your unread count and whether it is a message request from someone you do not follow. Publication chats are left out. Reading the list does not mark anything read. Pass conversation_id to get_conversation or send_message.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | next_cursor from the previous page. |
| unread_only | boolean | Only conversations with unread messages. |
{
"name": "list_conversations",
"title": "List conversations",
"description": "Your direct-message conversations, latest first, with the last message. Returns your Substack chat inbox: one-to-one and group direct messages with who they are with, the last message, its time, your unread count and whether it is a message request from someone you do not follow. Publication chats are left out. Reading the list does not mark anything read. Pass conversation_id to get_conversation or send_message.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"unread_only": {
"type": "boolean",
"description": "Only conversations with unread messages."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List conversations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Replies under a Note, with author, text and likes. Returns the direct replies under one Note (yours or anyone's), in Substack's order. replies is the count under each reply; list those by passing its note_id. Substack sends no handle with replies, so author.handle is empty and url is null. Page with next_cursor.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | next_cursor from the previous page. |
| note_id * | string | Note ID from list_notes or search_substack. |
{
"name": "list_note_replies",
"title": "List Note replies",
"description": "Replies under a Note, with author, text and likes. Returns the direct replies under one Note (yours or anyone's), in Substack's order. replies is the count under each reply; list those by passing its note_id. Substack sends no handle with replies, so author.handle is empty and url is null. Page with next_cursor.",
"inputSchema": {
"type": "object",
"required": [
"note_id"
],
"properties": {
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"note_id": {
"type": "string",
"description": "Note ID from list_notes or search_substack."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Note replies",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Notes posted by you or any other Substack user, newest first, with likes and replies. Returns the Notes on a profile's Notes tab, newest first: text, time, likes, restacks, reply count and link. Without user it lists yours. Posts and restacks of posts on the profile are left out. Page with next_cursor. Pass note_id to list_note_replies, like_comment or reply_to_note.
| Parameter | Type | Description |
|---|---|---|
| user | string | Handle (e.g. @mayachen) or user ID. Default: you. |
| cursor | string | next_cursor from the previous page. |
{
"name": "list_notes",
"title": "List Notes",
"description": "Notes posted by you or any other Substack user, newest first, with likes and replies. Returns the Notes on a profile's Notes tab, newest first: text, time, likes, restacks, reply count and link. Without user it lists yours. Posts and restacks of posts on the profile are left out. Page with next_cursor. Pass note_id to list_note_replies, like_comment or reply_to_note.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"user": {
"type": "string",
"description": "Handle (e.g. @mayachen) or user ID. Default: you."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Notes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Tags your publication uses to group posts. Returns every post tag of your publication with its ID, name and slug; readers see tagged posts on /t/{slug}. hidden tags group posts without a public page. Pass tag_id to tag_post.
No parameters.
{
"name": "list_post_tags",
"title": "List post tags",
"description": "Tags your publication uses to group posts. Returns every post tag of your publication with its ID, name and slug; readers see tagged posts on /t/{slug}. hidden tags group posts without a public page. Pass tag_id to tag_post.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List post tags",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Posts of your publication, newest first, with status and audience. Lists posts of your publication, newest first. Filter by status to see drafts or scheduled posts. Scheduled posts include their publish time. Pages hold up to 50 posts; pass next_cursor back as cursor for the next page.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | 1 to 50. Default: 20. |
| cursor | string | Next page cursor from the previous call. |
| status | string | published, draft or scheduled. Default: published. |
{
"name": "list_posts",
"title": "List posts",
"description": "Posts of your publication, newest first, with status and audience. Lists posts of your publication, newest first. Filter by status to see drafts or scheduled posts. Scheduled posts include their publish time. Pages hold up to 50 posts; pass next_cursor back as cursor for the next page.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "1 to 50. Default: 20."
},
"cursor": {
"type": "string",
"description": "Next page cursor from the previous call."
},
"status": {
"enum": [
"published",
"draft",
"scheduled"
],
"type": "string",
"description": "published, draft or scheduled. Default: published."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List posts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Publications you recommend, or that recommend you, with the subscribers each sent. Returns Audience > Recommendations: with direction given, the publications you recommend; with received, the ones recommending you, and whether you recommend them back (mutual). subscribers_sent counts subscribers the recommendation brought. The table is rebuilt by Substack in the background, so a recommendation made minutes ago may be missing while counts already include it; publication_id checks one recommendation of yours directly.
| Parameter | Type | Description |
|---|---|---|
| direction | string | given (publications you recommend) or received (that recommend you). Default: given. |
| publication_id | string | Check one publication instead: does yours recommend it (given only). |
{
"name": "list_recommendations",
"title": "List recommendations",
"description": "Publications you recommend, or that recommend you, with the subscribers each sent. Returns Audience > Recommendations: with direction given, the publications you recommend; with received, the ones recommending you, and whether you recommend them back (mutual). subscribers_sent counts subscribers the recommendation brought. The table is rebuilt by Substack in the background, so a recommendation made minutes ago may be missing while counts already include it; publication_id checks one recommendation of yours directly.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"direction": {
"enum": [
"given",
"received"
],
"type": "string",
"description": "given (publications you recommend) or received (that recommend you). Default: given."
},
"publication_id": {
"type": "string",
"description": "Check one publication instead: does yours recommend it (given only)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List recommendations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Sections of your publication, the separate newsletters inside it. Returns each section with its ID, name, description and slug. live is false while Substack still sets a new section up. subscribed_by_default tells whether new subscribers get its emails. A publication without sections returns an empty list.
No parameters.
{
"name": "list_sections",
"title": "List sections",
"description": "Sections of your publication, the separate newsletters inside it. Returns each section with its ID, name, description and slug. live is false while Substack still sets a new section up. subscribed_by_default tells whether new subscribers get its emails. A publication without sections returns an empty list.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List sections",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Tags you use to group subscribers. Returns the subscriber tags of your publication with their IDs, as Audience > Subscribers > Tags shows them. Subscribers never see tags. Pass tag_id to tag_subscribers.
No parameters.
{
"name": "list_subscriber_tags",
"title": "List subscriber tags",
"description": "Tags you use to group subscribers. Returns the subscriber tags of your publication with their IDs, as Audience > Subscribers > Tags shows them. Subscribers never see tags. Pass tag_id to tag_subscribers.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List subscriber tags",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Subscribers with plan, start date and activity rating. Lists subscribers, newest first, from the subscriber dashboard. Activity rating is the 0 to 5 score Substack shows there. Pages hold up to 500 rows; pass next_cursor back as cursor. The plan and since filters apply inside each page, so a filtered page can be short or empty while next_cursor still points further. Someone added a minute ago may not show yet: Substack fills the table in the background. paid includes founding members.
| Parameter | Type | Description |
|---|---|---|
| plan | string | all, free, paid, comp or founding. Default: all. |
| limit | integer | 1 to 500. Default: 100. |
| since | string | Only subscribers who joined on or after this date. |
| cursor | string | Next page cursor from the previous call. |
{
"name": "list_subscribers",
"title": "List subscribers",
"description": "Subscribers with plan, start date and activity rating. Lists subscribers, newest first, from the subscriber dashboard. Activity rating is the 0 to 5 score Substack shows there. Pages hold up to 500 rows; pass next_cursor back as cursor. The plan and since filters apply inside each page, so a filtered page can be short or empty while next_cursor still points further. Someone added a minute ago may not show yet: Substack fills the table in the background. paid includes founding members.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"plan": {
"enum": [
"all",
"free",
"paid",
"comp",
"founding"
],
"type": "string",
"description": "all, free, paid, comp or founding. Default: all."
},
"limit": {
"type": "integer",
"description": "1 to 500. Default: 100."
},
"since": {
"type": "string",
"format": "date",
"description": "Only subscribers who joined on or after this date."
},
"cursor": {
"type": "string",
"description": "Next page cursor from the previous call."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List subscribers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Publications you subscribe to, with your plan and whether their emails reach you. Returns every publication your account subscribes to, as Settings > Subscriptions lists them: name, link, plan (free, paid, comp, founding or gift, as Substack names the membership) and whether you get its emails. Your own publications are left out.
No parameters.
{
"name": "list_subscriptions",
"title": "List subscriptions",
"description": "Publications you subscribe to, with your plan and whether their emails reach you. Returns every publication your account subscribes to, as Settings > Subscriptions lists them: name, link, plan (free, paid, comp, founding or gift, as Substack names the membership) and whether you get its emails. Your own publications are left out.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List subscriptions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Where your publication's visitors came from in a period, most views first. Returns Analytics > Traffic > Traffic sources: each source (the app, email, a website, search, social) with its category, views, unique visitors and the free and paid subscribers it brought. Sorted by views; page with next_cursor.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Default: 20. |
| cursor | string | next_cursor from the previous page. |
| period | string | Default: 30d. |
{
"name": "list_traffic_sources",
"title": "List traffic sources",
"description": "Where your publication's visitors came from in a period, most views first. Returns Analytics > Traffic > Traffic sources: each source (the app, email, a website, search, social) with its category, views, unique visitors and the free and paid subscribers it brought. Sorted by views; page with next_cursor.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Default: 20."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
},
"period": {
"enum": [
"7d",
"30d",
"90d",
"365d"
],
"type": "string",
"description": "Default: 30d."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List traffic sources",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search all of Substack for people, posts and Notes. Runs Substack's search as the search box does and splits the results into people, posts and Notes. Use the IDs with follow_user, like_post, like_comment, reply_to_note, send_message or recommend_publication. Page with next_cursor; later pages may hold only posts and Notes.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Words to search for. |
| cursor | string | next_cursor from the previous page. |
{
"name": "search_substack",
"title": "Search Substack",
"description": "Search all of Substack for people, posts and Notes. Runs Substack's search as the search box does and splits the results into people, posts and Notes. Use the IDs with follow_user, like_post, like_comment, reply_to_note, send_message or recommend_publication. Page with next_cursor; later pages may hold only posts and Notes.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Words to search for."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add one email to your list as a free subscriber. Adds one email as a free subscriber, the same as Add subscribers in the dashboard, and Substack sends its usual welcome email. Substack adds the email in the background, so list_subscribers may show it a minute later. Add only people who agreed to hear from you. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Subscriber email. |
{
"name": "add_subscriber",
"title": "Add subscriber",
"description": "Add one email to your list as a free subscriber. Adds one email as a free subscriber, the same as Add subscribers in the dashboard, and Substack sends its usual welcome email. Substack adds the email in the background, so list_subscribers may show it a minute later. Add only people who agreed to hear from you. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Subscriber email."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add subscriber",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Stop a scheduled post from going out; it stays as a draft. Removes the scheduled time from a post, so nothing is published or emailed then; the post stays a draft with its content. Schedule it again with schedule_post. A post with no schedule returns an error.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "cancel_scheduled_post",
"title": "Cancel scheduled post",
"description": "Stop a scheduled post from going out; it stays as a draft. Removes the scheduled time from a post, so nothing is published or emailed then; the post stays a draft with its content. Schedule it again with schedule_post. A post with no schedule returns an error.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cancel scheduled post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}New draft from Markdown. Nothing is sent until you publish or schedule it. Creates a draft in your publication and returns its post_id and editor link. Markdown covers headings, paragraphs, bullet and numbered lists, quotes, code blocks, rules, images by public URL, bold, italic, strikethrough, inline code and links; local image files cannot be used. Sending is a separate step: schedule_post or publish_post. A draft reaches no one, so it runs without asking.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Post title. |
| audience | string | everyone, only_paid or founding. Default: everyone. |
| subtitle | string | Shown under the title and in the email preview. |
| body_markdown * | string | Post body in Markdown. Images by public URL. |
{
"name": "create_draft",
"title": "Create draft",
"description": "New draft from Markdown. Nothing is sent until you publish or schedule it. Creates a draft in your publication and returns its post_id and editor link. Markdown covers headings, paragraphs, bullet and numbered lists, quotes, code blocks, rules, images by public URL, bold, italic, strikethrough, inline code and links; local image files cannot be used. Sending is a separate step: schedule_post or publish_post. A draft reaches no one, so it runs without asking.",
"inputSchema": {
"type": "object",
"required": [
"title",
"body_markdown"
],
"properties": {
"title": {
"type": "string",
"description": "Post title."
},
"audience": {
"enum": [
"everyone",
"only_paid",
"founding"
],
"type": "string",
"description": "everyone, only_paid or founding. Default: everyone."
},
"subtitle": {
"type": "string",
"description": "Shown under the title and in the email preview."
},
"body_markdown": {
"type": "string",
"description": "Post body in Markdown. Images by public URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create draft",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}New tag for grouping your posts. Creates a post tag on your publication; Substack makes the slug from the name. A tag with no posts shows nowhere. Put posts under it with tag_post.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Tag name, e.g. Habits. |
{
"name": "create_post_tag",
"title": "Create post tag",
"description": "New tag for grouping your posts. Creates a post tag on your publication; Substack makes the slug from the name. A tag with no posts shows nowhere. Put posts under it with tag_post.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Tag name, e.g. Habits."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create post tag",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}New private tag for grouping subscribers. Creates a subscriber tag on your publication. Tags are private: subscribers never see them. Put subscribers under it with tag_subscribers.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Tag name, e.g. Early readers. |
{
"name": "create_subscriber_tag",
"title": "Create subscriber tag",
"description": "New private tag for grouping subscribers. Creates a subscriber tag on your publication. Tags are private: subscribers never see them. Put subscribers under it with tag_subscribers.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Tag name, e.g. Early readers."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create subscriber tag",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Delete one of your own comments, Notes or Note replies. Deletes something you wrote: a comment under a post, a Note or a reply to a Note. Replies other people wrote under it stay, under a deleted placeholder. Someone else's comment returns an error; on your own posts remove it with remove_comment. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| comment_id * | string | ID of your comment, Note or Note reply. |
{
"name": "delete_comment",
"title": "Delete comment or Note",
"description": "Delete one of your own comments, Notes or Note replies. Deletes something you wrote: a comment under a post, a Note or a reply to a Note. Replies other people wrote under it stay, under a deleted placeholder. Someone else's comment returns an error; on your own posts remove it with remove_comment. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"comment_id"
],
"properties": {
"comment_id": {
"type": "string",
"description": "ID of your comment, Note or Note reply."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Delete comment or Note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Delete a draft, scheduled or published post, with its comments. Deletes one post of your publication for good: a draft, a scheduled post (its send is cancelled) or a published post, which leaves the web, the archive and the app with its comments and stats. Emails already sent stay in inboxes. Substack has no undo; unpublish_post keeps the post as a draft instead. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "delete_post",
"title": "Delete post",
"description": "Delete a draft, scheduled or published post, with its comments. Deletes one post of your publication for good: a draft, a scheduled post (its send is cancelled) or a published post, which leaves the web, the archive and the app with its comments and stats. Emails already sent stay in inboxes. Substack has no undo; unpublish_post keeps the post as a draft instead. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Delete post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Copy any post into a new draft. Makes a new draft with the title, subtitle, body and settings of a draft or published post, as Duplicate in the post list does. Substack puts [COPY] in front of the title; change it with update_draft. Nothing is published or sent.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "duplicate_post",
"title": "Duplicate post",
"description": "Copy any post into a new draft. Makes a new draft with the title, subtitle, body and settings of a draft or published post, as Duplicate in the post list does. Substack puts [COPY] in front of the title; change it with update_draft. Nothing is published or sent.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Duplicate post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Follow or unfollow a Substack user, so their Notes reach your feed. Follows a person on Substack, as Follow on their profile does, or unfollows them. Following is not subscribing: you get their Notes and activity in the app, not their newsletter by email. They see the follow.
| Parameter | Type | Description |
|---|---|---|
| user * | string | Handle (e.g. @mayachen) or user ID. |
| unfollow | boolean | Unfollow instead. Default: false. |
{
"name": "follow_user",
"title": "Follow user",
"description": "Follow or unfollow a Substack user, so their Notes reach your feed. Follows a person on Substack, as Follow on their profile does, or unfollows them. Following is not subscribing: you get their Notes and activity in the app, not their newsletter by email. They see the follow.",
"inputSchema": {
"type": "object",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"description": "Handle (e.g. @mayachen) or user ID."
},
"unfollow": {
"type": "boolean",
"description": "Unfollow instead. Default: false."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Follow user",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Like or unlike a comment or a Note as you. Adds your heart to any Note or Note reply, or to a comment under a post of your publication, or removes it with unlike. Comments and Notes share one ID space, so a Note ID from list_notes or search_substack works too. The author sees your like in their activity.
| Parameter | Type | Description |
|---|---|---|
| unlike | boolean | Remove your like instead. Default: false. |
| comment_id * | string | Comment ID from list_comments, or a Note ID. |
{
"name": "like_comment",
"title": "Like comment or Note",
"description": "Like or unlike a comment or a Note as you. Adds your heart to any Note or Note reply, or to a comment under a post of your publication, or removes it with unlike. Comments and Notes share one ID space, so a Note ID from list_notes or search_substack works too. The author sees your like in their activity.",
"inputSchema": {
"type": "object",
"required": [
"comment_id"
],
"properties": {
"unlike": {
"type": "boolean",
"description": "Remove your like instead. Default: false."
},
"comment_id": {
"type": "string",
"description": "Comment ID from list_comments, or a Note ID."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Like comment or Note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Like or unlike any Substack post as you. Adds your heart to a post on any publication, as the heart under a post does, or removes it with unlike. The author sees your like in their activity. Liking twice keeps one like.
| Parameter | Type | Description |
|---|---|---|
| unlike | boolean | Remove your like instead. Default: false. |
| post_id * | string | Post ID from search_substack, list_posts or a post's data. |
{
"name": "like_post",
"title": "Like post",
"description": "Like or unlike any Substack post as you. Adds your heart to a post on any publication, as the heart under a post does, or removes it with unlike. The author sees your like in their activity. Liking twice keeps one like.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"unlike": {
"type": "boolean",
"description": "Remove your like instead. Default: false."
},
"post_id": {
"type": "string",
"description": "Post ID from search_substack, list_posts or a post's data."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Like post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Pin a comment to the top of your post's comments, or unpin it. Pins one comment on a post of your publication above all others, as Pin in the comment menu does, or unpins it. A comment on someone else's post returns an error.
| Parameter | Type | Description |
|---|---|---|
| unpin | boolean | Unpin instead. Default: false. |
| comment_id * | string | Comment ID from list_comments. |
{
"name": "pin_comment",
"title": "Pin comment",
"description": "Pin a comment to the top of your post's comments, or unpin it. Pins one comment on a post of your publication above all others, as Pin in the comment menu does, or unpins it. A comment on someone else's post returns an error.",
"inputSchema": {
"type": "object",
"required": [
"comment_id"
],
"properties": {
"unpin": {
"type": "boolean",
"description": "Unpin instead. Default: false."
},
"comment_id": {
"type": "string",
"description": "Comment ID from list_comments."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Pin comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Short post in Substack Notes, now or at a set time, optionally with a link card to one of your posts. Posts a Note under your name. Without publish_at it goes out now; with it, the Note waits in your scheduled Notes, status is scheduled and published_at is that time. Text is 1 to 1,000 characters. link_post_id must be a published post. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Note text, up to 1,000 characters. |
| publish_at | string | ISO 8601 with time zone. Omit to post now. |
| link_post_id | string | Attach one of your published posts as a link card. |
{
"name": "publish_note",
"title": "Publish Note",
"description": "Short post in Substack Notes, now or at a set time, optionally with a link card to one of your posts. Posts a Note under your name. Without publish_at it goes out now; with it, the Note waits in your scheduled Notes, status is scheduled and published_at is that time. Text is 1 to 1,000 characters. link_post_id must be a published post. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Note text, up to 1,000 characters."
},
"publish_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 with time zone. Omit to post now."
},
"link_post_id": {
"type": "string",
"description": "Attach one of your published posts as a link card."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Publish Note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Publish a draft now. Publishes a draft immediately, on the web and, unless send_email is false, by email, to the audience set on the draft. Substack's own pre-publish check runs first; a missing title or an empty body stops the call. A sent email cannot be recalled. On a publication with sections the post goes to section_id, else to the section already set on the draft, else to the main publication. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
| section_id | string | Section ID from list_sections, or main. Default: the draft's section, else main. |
| send_email | boolean | Email it to subscribers. Default: true. |
{
"name": "publish_post",
"title": "Publish post",
"description": "Publish a draft now. Publishes a draft immediately, on the web and, unless send_email is false, by email, to the audience set on the draft. Substack's own pre-publish check runs first; a missing title or an empty body stops the call. A sent email cannot be recalled. On a publication with sections the post goes to section_id, else to the section already set on the draft, else to the main publication. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
},
"section_id": {
"type": "string",
"description": "Section ID from list_sections, or main. Default: the draft's section, else main."
},
"send_email": {
"type": "boolean",
"description": "Email it to subscribers. Default: true."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Publish post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Recommend another publication to your readers, or stop recommending it. Adds a publication to your Recommendations, as Growth > Recommendations does: Substack suggests it to people who subscribe to you and notifies its author. blurb is the short reason readers see. With remove it takes the recommendation back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| blurb | string | Why you recommend it, shown to your readers (optional). |
| remove | boolean | Stop recommending it instead. Default: false. |
| publication_id * | string | Publication ID, e.g. from search_substack posts. |
{
"name": "recommend_publication",
"title": "Recommend publication",
"description": "Recommend another publication to your readers, or stop recommending it. Adds a publication to your Recommendations, as Growth > Recommendations does: Substack suggests it to people who subscribe to you and notifies its author. blurb is the short reason readers see. With remove it takes the recommendation back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"publication_id"
],
"properties": {
"blurb": {
"type": "string",
"description": "Why you recommend it, shown to your readers (optional)."
},
"remove": {
"type": "boolean",
"description": "Stop recommending it instead. Default: false."
},
"publication_id": {
"type": "string",
"description": "Publication ID, e.g. from search_substack posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Recommend publication",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Remove someone's comment from your post as the publication's moderator. Hides a comment on a post of your publication, as Remove in the comment menu does: readers see that a moderator removed it, the text is gone, replies under it stay. Use delete_comment for your own comments. A comment on someone else's post returns an error. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| comment_id * | string | Comment ID from list_comments. |
{
"name": "remove_comment",
"title": "Remove comment",
"description": "Remove someone's comment from your post as the publication's moderator. Hides a comment on a post of your publication, as Remove in the comment menu does: readers see that a moderator removed it, the text is gone, replies under it stay. Use delete_comment for your own comments. A comment on someone else's post returns an error. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"comment_id"
],
"properties": {
"comment_id": {
"type": "string",
"description": "Comment ID from list_comments."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Remove comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Remove one email from your subscriber list. Removes a subscriber from your list, as Remove in the subscriber's menu does: they get no more emails from you and no notice. A paid subscription is cancelled and Substack refunds the unused part. An email not on your list returns an error; add_subscriber takes about a minute before the address is listed. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Subscriber's email address. |
{
"name": "remove_subscriber",
"title": "Remove subscriber",
"description": "Remove one email from your subscriber list. Removes a subscriber from your list, as Remove in the subscriber's menu does: they get no more emails from you and no notice. A paid subscription is cancelled and Substack refunds the unused part. An email not on your list returns an error; add_subscriber takes about a minute before the address is listed. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Subscriber's email address."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Remove subscriber",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Reply as you under a comment on your post. Posts a reply under one comment on a post of your publication, under your name, visible to everyone who can read the post. A comment elsewhere on Substack returns an error. The author gets Substack's usual reply notification. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Reply text. |
| comment_id * | string | Comment ID from list_comments. |
{
"name": "reply_to_comment",
"title": "Reply to comment",
"description": "Reply as you under a comment on your post. Posts a reply under one comment on a post of your publication, under your name, visible to everyone who can read the post. A comment elsewhere on Substack returns an error. The author gets Substack's usual reply notification. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"comment_id",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Reply text."
},
"comment_id": {
"type": "string",
"description": "Comment ID from list_comments."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Reply to comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Reply as you under any Note or Note reply. Posts a reply under a Note (yours or anyone's) or under a reply to one, visible to everyone who sees the Note. Text is 1 to 1,000 characters; Markdown bold, italics and links work. The author gets Substack's usual notification. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Reply text, up to 1,000 characters. |
| note_id * | string | Note ID from list_notes, list_note_replies or search_substack. |
{
"name": "reply_to_note",
"title": "Reply to Note",
"description": "Reply as you under any Note or Note reply. Posts a reply under a Note (yours or anyone's) or under a reply to one, visible to everyone who sees the Note. Text is 1 to 1,000 characters; Markdown bold, italics and links work. The author gets Substack's usual notification. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"note_id",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Reply text, up to 1,000 characters."
},
"note_id": {
"type": "string",
"description": "Note ID from list_notes, list_note_replies or search_substack."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Reply to Note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Publish a draft at a set time, on the web and by email. Schedules a draft to go live at the time you set, on the web and, unless send_email is false, by email, to the audience set on the draft. The time needs a time zone and must be in the future. Substack's own pre-publish check runs first; a missing title or an empty body stops the call. A scheduled post stays editable until it goes out. On a publication with sections the post goes to section_id, else to the section already set on the draft, else to the main publication. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
| publish_at * | string | ISO 8601 with time zone. |
| section_id | string | Section ID from list_sections, or main. Default: the draft's section, else main. |
| send_email | boolean | Email it to subscribers. Default: true. |
{
"name": "schedule_post",
"title": "Schedule post",
"description": "Publish a draft at a set time, on the web and by email. Schedules a draft to go live at the time you set, on the web and, unless send_email is false, by email, to the audience set on the draft. The time needs a time zone and must be in the future. Substack's own pre-publish check runs first; a missing title or an empty body stops the call. A scheduled post stays editable until it goes out. On a publication with sections the post goes to section_id, else to the section already set on the draft, else to the main publication. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"publish_at"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
},
"publish_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 with time zone."
},
"section_id": {
"type": "string",
"description": "Section ID from list_sections, or main. Default: the draft's section, else main."
},
"send_email": {
"type": "boolean",
"description": "Email it to subscribers. Default: true."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Schedule post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Send a direct message on Substack, in a conversation or to a person. Sends a private chat message under your name. With conversation_id it replies there; with user it writes to that person, in your existing conversation with them or a new one. Someone who does not follow you gets it as a message request. Give one of conversation_id or user. A sent message cannot be recalled. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Message text. |
| user | string | Or start one with this handle (e.g. @mayachen) or user ID. |
| conversation_id | string | Reply in this conversation from list_conversations. |
{
"name": "send_message",
"title": "Send message",
"description": "Send a direct message on Substack, in a conversation or to a person. Sends a private chat message under your name. With conversation_id it replies there; with user it writes to that person, in your existing conversation with them or a new one. Someone who does not follow you gets it as a message request. Give one of conversation_id or user. A sent message cannot be recalled. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Message text."
},
"user": {
"type": "string",
"description": "Or start one with this handle (e.g. @mayachen) or user ID."
},
"conversation_id": {
"type": "string",
"description": "Reply in this conversation from list_conversations."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Send message",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Add a tag to a post, or take it off. Puts one of your post tags on a draft or published post, or removes it with remove. A post can have several tags. Tagging twice keeps one tag.
| Parameter | Type | Description |
|---|---|---|
| remove | boolean | Take the tag off instead. Default: false. |
| tag_id * | string | Tag ID from list_post_tags or create_post_tag. |
| post_id * | string | Post ID from list_posts. |
{
"name": "tag_post",
"title": "Tag post",
"description": "Add a tag to a post, or take it off. Puts one of your post tags on a draft or published post, or removes it with remove. A post can have several tags. Tagging twice keeps one tag.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"tag_id"
],
"properties": {
"remove": {
"type": "boolean",
"description": "Take the tag off instead. Default: false."
},
"tag_id": {
"type": "string",
"description": "Tag ID from list_post_tags or create_post_tag."
},
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Tag post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Put a tag on subscribers by email, or take it off. Adds one of your subscriber tags to up to 50 subscribers, or removes it with remove. Emails not on your list come back in not_found and nothing else fails. A subscriber added a minute ago may not be findable yet; try again shortly.
| Parameter | Type | Description |
|---|---|---|
| emails * | array | Subscribers' email addresses, up to 50. |
| remove | boolean | Take the tag off instead. Default: false. |
| tag_id * | string | Tag ID from list_subscriber_tags or create_subscriber_tag. |
{
"name": "tag_subscribers",
"title": "Tag subscribers",
"description": "Put a tag on subscribers by email, or take it off. Adds one of your subscriber tags to up to 50 subscribers, or removes it with remove. Emails not on your list come back in not_found and nothing else fails. A subscriber added a minute ago may not be findable yet; try again shortly.",
"inputSchema": {
"type": "object",
"required": [
"tag_id",
"emails"
],
"properties": {
"emails": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "Subscribers' email addresses, up to 50."
},
"remove": {
"type": "boolean",
"description": "Take the tag off instead. Default: false."
},
"tag_id": {
"type": "string",
"description": "Tag ID from list_subscriber_tags or create_subscriber_tag."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Tag subscribers",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Take a published post off the web and back to drafts. Turns a published post back into a draft, as Unpublish in the editor does: it leaves your site, archive and the Substack app, and its link stops working. Comments and stats stay with the draft. Emails already sent stay in inboxes. Publish it again with publish_post. A post that is not published returns an error. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | Post ID from list_posts. |
{
"name": "unpublish_post",
"title": "Unpublish post",
"description": "Take a published post off the web and back to drafts. Turns a published post back into a draft, as Unpublish in the editor does: it leaves your site, archive and the Substack app, and its link stops working. Comments and stats stay with the draft. Emails already sent stay in inboxes. Publish it again with publish_post. A post that is not published returns an error. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Unpublish post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Change the title, subtitle, body or audience of a draft. Changes the fields you pass and leaves the others as they are. body_markdown replaces the whole body. Drafts and scheduled posts only: a published post returns an error. Nothing reaches your subscribers, so it runs without asking.
| Parameter | Type | Description |
|---|---|---|
| fields * | string | JSON object with any of title, subtitle, body_markdown, audience, e.g. {"title": "New title"}. |
| post_id * | string | Post ID from list_posts. |
{
"name": "update_draft",
"title": "Update draft",
"description": "Change the title, subtitle, body or audience of a draft. Changes the fields you pass and leaves the others as they are. body_markdown replaces the whole body. Drafts and scheduled posts only: a published post returns an error. Nothing reaches your subscribers, so it runs without asking.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"fields"
],
"properties": {
"fields": {
"type": "string",
"description": "JSON object with any of title, subtitle, body_markdown, audience, e.g. {\"title\": \"New title\"}."
},
"post_id": {
"type": "string",
"description": "Post ID from list_posts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Update draft",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Create post in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_create_post",
"title": "Create post in Substack",
"description": "Create post in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Create post in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Schedule post in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_schedule_post",
"title": "Schedule post in Substack",
"description": "Schedule post in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Schedule post in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Publish Note in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_publish_note",
"title": "Publish Note in Substack",
"description": "Publish Note in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Publish Note in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Reply to Notes in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_reply_to_notes",
"title": "Reply to Notes in Substack",
"description": "Reply to Notes in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Reply to Notes in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send direct message in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_send_direct_message",
"title": "Send direct message in Substack",
"description": "Send direct message in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Send direct message in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Moderate comments in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_moderate_comments",
"title": "Moderate comments in Substack",
"description": "Moderate comments in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Moderate comments in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List subscribers in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_list_subscribers",
"title": "List subscribers in Substack",
"description": "List subscribers in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List subscribers in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get post stats in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).
No parameters.
{
"name": "substack_get_post_stats",
"title": "Get post stats in Substack",
"description": "Get post stats in the user's own Substack account from ChatGPT, Claude or any AI agent. Returns how to do it in Substack step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Substack Cloud Browser. Substack's official API: Substack has only a limited API (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Get post stats in Substack",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Substack MCP server by Cotlet: connects Substack to Claude Code, ChatGPT and any AI agent. Cotlet works in the user's own Substack account through their Cloud Browser, a real Chrome hosted by Cotlet where the user signed in to Substack themselves; Cotlet does not store their password. The substack_* tools each return the Substack steps for one action (screens, buttons, fields) and open nothing: call one, then do the steps with the cotlet_browser_* tools. Each Substack operation is its own tool and does a job in one call: prefer them. Writes that reach other people wait for the user's approval in the Cotlet console and answer with status pending and a call_id, which cotlet_get_call reports on. Several Substack accounts: pass `browser` with a name cotlet_apps lists. For what the operations do not cover, the cotlet_browser_* tools work in the same Substack browser: call cotlet_app_guide first (free) for its screens. Call the browser tools one at a time, never in parallel: wait for each answer. Open the page with cotlet_browser_open, then cotlet_browser_read it once for its text and numbered elements. Act on those numbers with click, type, select and press, or fill_form for several fields at once; each action answers the page after it (the elements and text in view, same numbers), so read again only to see the whole page. cotlet_browser_find finds one thing on a long page; scroll loads lists that grow as you scroll; screenshot shows boards and canvases (click or drag them by x, y); download gets a file; evaluate extracts data with a script. Public pages open without signing in. Signing in for the user is allowed: on a sign-in page or a 2FA prompt, type the email, password and code the user gave you, and ask them for what you lack (Cotlet does not store them). If the user would rather sign in themselves, or a check a step says needs the person, give them one link only, the sign-in link from cotlet_app_guide (it opens their Cloud Browser right on that page), ask them to reply "done", then go on with the task. Ask the user before a step that sends, publishes, deletes or pays. Each answer names its Tab: send that id as `tab` with the next steps, so a step never acts on another tab the user or another client showed meanwhile (it does nothing and answers tab_changed: read the shown tab or switch back). A refusal says how to go on: no_tab, list the tabs, switch to the task's site (or reopen it), read it and use the fresh Tab id and element numbers; no_element, find the control by its label in the page shown, or read again, and fill only the fields not yet filled; script_failed, read the error and the page first, fix an invalid script, never send it unchanged. Close the browser with cotlet_browser_close when done: each started minute of a session uses credits. After each finished task, never in the middle of one, give the result, then offer 2 or 3 next things to do in the app, from the guide's "What to offer next": another read first, then a small change you make only after the user says yes, and an automation when a job repeats. If you cannot finish the task in the browser (an element you cannot find, a page that will not work, a flow you do not understand) or a step keeps failing, call cotlet_report_issue with what the user asked, the page, the step and what you saw. cotlet_whoami names the account and its credits, cotlet_apps whether the app is ready. When a Cotlet answer starts with a note that your Cotlet tool list is old, tell the user first, with its link, and call cotlet_refresh_button if you have it. The account and credits: https://cotlet.dev/app.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "cotlet_report_issue",
"title": "Cotlet: report a bug or a missing feature",
"description": "Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to report: do the task in the browser. A feature the user asks for goes as feature_request. A report promises nothing: tell the user it was sent, never that something will be built or fixed, or when. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"title": "AgentReportCreate",
"required": [
"kind",
"title",
"description"
],
"properties": {
"app": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"title": "App",
"default": null,
"description": "App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'."
},
"kind": {
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"type": "string",
"title": "Kind",
"description": "bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user asked for. missing_feature: a step the task needed that you tried and could not do, in the browser or with a tool. other: anything else."
},
"tool": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
],
"title": "Tool",
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'."
},
"title": {
"type": "string",
"title": "Title",
"maxLength": 200,
"minLength": 3,
"description": "One line, e.g. 'skool_list_members stops after 50 members'."
},
"client": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"title": "Client",
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'."
},
"call_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Call Id",
"default": null,
"description": "call_id of the call that went wrong, if any."
},
"description": {
"type": "string",
"title": "Description",
"maxLength": 5000,
"minLength": 10,
"description": "What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets."
}
},
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: report a bug or a missing feature",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "cotlet_browser_click",
"title": "Click on the page",
"description": "Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that would open a new tab opens in this one. Buttons that pay or buy, and sign-in and account pages, are refused.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"button": {
"enum": [
"left",
"right"
],
"type": "string",
"description": "right opens the page's own context menu. Default: left."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"double": {
"type": "boolean",
"description": "Double-click."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Click on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_type",
"title": "Type on the page",
"description": "Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells and editors that read does not number (Google Sheets, Docs), click the place first; there a tab in `text` presses Tab and a line break Enter, so one call fills a table. Answers the page after it: the elements and text in view, with the same numbers. A password or code the user gave you goes in like any text; card fields are refused.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"slowly": {
"type": "boolean",
"description": "Key by key, for a search or address field whose suggestions do not appear."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The field's number from the last read. Leave it out to type where the focus is."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Type on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}