Kit MCP Server
Kit MCP Server exposes 85 MCP/CLI tools (38 reads, 47 writes) to manage a Kit email marketing account, with confirmation and safety guards for sensitive actions.
Account: read account, colors, creator profile, growth/email stats; update colors.
Broadcasts: list/get/create/update/delete, stats and clicks, draft/schedule newsletters.
Subscribers: list/search/filter, get/create/update/unsubscribe, location, stats, tags; bulk create (OAuth).
Tags/custom fields: list/create/update/delete tags and custom fields; tag/untag subscribers, bulk tag operations (OAuth for some).
Forms/sequences: list forms/subscribers, add subscribers to forms/sequences, manage sequences and sequence emails (CRUD).
Snippets/posts/segments/templates/purchases: list snippets, posts, segments, email templates; OAuth-only purchase reads/writes.
Webhooks: list/create/update/delete endpoints and legacy webhooks; rotate/revoke signing secrets (saved privately).
Safety/ops: named private accounts, OAuth token refresh, bounded pagination, CLI commands, read-only mode, confirm guard for destructive/delivery/audience changes.
Provides tools for interacting with the Kit API v4 (newsletter/email marketing platform), covering 85 operations: reading account identity, growth and email statistics; drafting, scheduling, updating and deleting broadcasts with click breakdowns; creating, updating, filtering, unsubscribing and tagging subscribers; managing tags, forms, sequences and individual sequence emails; CRUD on snippets and templates; reading posts and segments; OAuth-only purchase endpoints and asynchronous bulk jobs; and configuring signed webhook endpoints with secret rotation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kit MCP Server draft a newsletter broadcast about our spring sale and schedule it for tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kit MCP Server & CLI
Kit MCP server and CLI for Claude Code, Codex and AI agents. 85 tools: 38 reads and 47 writes for account data, newsletters, subscribers, tags, forms, sequences, snippets, statistics, bulk work and webhooks.
One package gives you two ways in: kit-mcp connects the tools to your AI app, and kit-cli makes the same tools shell commands. Claude Desktop also has a bundled .mcpb extension. The 40 audience, delivery, deletion and signing-secret operations require explicit confirmation.
Built and maintained by Navid Moazzez. Built on Slipway, which turns one definition of each tool into the MCP server and the CLI. The installation guide is in INSTALL.md; the full matching navid.me guide is saved as a CMS draft and awaits publication.
The terminal illustrates shipped tool names and the requested draft workflow. It is a presentation preview, not a live account transcript.
You need a Kit v4 API key or an authorized OAuth session. Some endpoints require OAuth; account permissions and plan eligibility still apply. The wrapper is free software under AGPL-3.0-or-later. Kit service charges remain separate. This is a community integration, not a Kit-endorsed product.
Kit already has an official account MCP with v4 reads and writes. This package adds a task CLI, private named accounts, bounded cursor aggregation, private token refresh and a desktop bundle. It does not claim more API coverage or measured token savings over the official server.
Validation: build, typecheck, 40 behavior/CLI checks, public npm installation and desktop protocol discovery are checked. Live account writes and actual desktop GUI installation remain unverified; section 7 has the measured token costs.
Two ways to use it
Command line
npm install -g @thenavidm/kit-mcp-cli@latest
kit-cli
kit-cli list-broadcasts --help
kit-cli schema create-broadcast
kit-cli get-account --agent
kit-cli list-broadcasts --per-page 5 --agent
kit-cli create-broadcast --subject "This week's creator notes" --content '<p>Your newsletter content.</p>' --confirm --agentConfigure credentials privately first. Draft creation defaults private and unscheduled. --confirm authorizes the requested operation; --agent and --yes never bypass that guard.
MCP server, for your AI app
claude mcp add --scope user kit -- npx -y @thenavidm/kit-mcp-cli@latestThen ask: "Draft my next newsletter privately. Show me the draft and leave it unscheduled." Confirm only the requested account action.
All client configurations and operating-system steps are in INSTALL.md.
Which one
Where you work | What to use |
Claude Code, Codex, Cursor or another agent with a terminal | MCP, CLI or both |
Claude Desktop chat | The local MCP server or desktop extension |
Scripts, cron or CI | CLI commands, or MCP through an MCP client |
A web client that accepts only a remote MCP URL | Kit's official hosted MCP; this package exposes local stdio |
Related MCP server: kit-mcp
Features
Capability | CLI command | MCP tool |
Account and growth |
|
|
Recent newsletters |
|
|
Draft and schedule |
|
|
Newsletter statistics |
|
|
Subscriber lookup |
|
|
Subscribers and tags |
|
|
Sequences |
|
|
Templates |
|
|
Signed webhook endpoints |
|
|
Private named accounts |
|
|
Diagnose setup |
| CLI utility |
Contents
Number | Section | What it covers |
1 | Practical prompts, coverage and validation | |
2 | Install, discover and authenticate | |
3 | API keys, OAuth and revocation | |
4 | Every client and desktop route | |
5 | Doctor and the first account read | |
6 | Scripts, JSON and nested bodies | |
7 | Surface choices and measurement | |
8 | All 85 tools and their arguments | |
9 | Draft, review, schedule and manage audiences | |
10 | Cursors, asynchronous jobs and private secrets | |
11 | Account selection and isolation | |
12 | Confirmation, read-only and retries | |
13 | Shared handlers, schemas and development | |
14 | Credentials, local files and privacy | |
15 | Credentials, safety and tuning | |
16 | npm, desktop, disconnecting and migration | |
17 | Symptoms and fixes | |
18 | Official and community alternatives | |
19 | Component versions, releases and history | |
20 | Common questions |
1. What you can ask it
Show my latest five newsletters and their statistics.
Draft my next newsletter privately and leave it unscheduled.
Find this subscriber by exact email and show their tags.
Read the current audience before applying the tag I requested.
List available sequences and templates.
Create the requested signed webhook and save its signing secret privately.
The pinned official API v4 snapshot contains 83 operations. This server exposes each one, plus list_accounts and the search_subscribers compatibility alias. The snapshot source, date, hash and reviewed corrections are in api-source.json.
Area | Examples |
Account | Identity, creator profile, growth statistics, email statistics and colors |
Broadcasts | Draft, read, update, delete, statistics and click breakdowns |
Subscribers | Create, update, unsubscribe, filter, location, statistics and tags |
Tags, forms, sequences | Read resources, subscribe to a form or sequence, tag and untag |
Sequence emails | Read, create, edit and delete individual emails |
Snippets and templates | Reusable content CRUD supported by the API; list email templates |
Posts and segments | Read published posts and segment metadata |
Purchases and bulk | OAuth-only purchase endpoints and asynchronous bulk jobs |
Webhook endpoints | Signed endpoints, secret rotation and previous-secret revocation |
Legacy webhooks | Older webhook API preserved separately |
The API does not provide all Kit UI actions. This package does not promise visual automation editing, automatic duplication of a designed broadcast, a block editor, a webhook receiver, a hosted scheduler or a browser session. A successful bulk submission is not proof that its asynchronous job has completed.
What was actually checked
Check | Status for 3.0.0 |
Official API snapshot | 83 operations, pinned on 2026-10-02 |
Real local MCP discovery | 85 tools, or 38 with read-only enabled |
Behavior and shared CLI | 38 checks passed against controlled HTTP fixtures |
TypeScript | Build and typecheck passed |
Production dependency audit | Zero findings at review time |
Live account reads and writes | Pending a configured v4 key or authorized OAuth session |
Actual Claude Desktop installation | Pending a GUI check; archive and protocol checked separately |
Matched MCP versus CLI model-token task | Measured against 2.0.3 in README section 7 |
Fixture tests check request construction and guards. They do not establish that a particular Kit account or email template accepts a live write. Release artifact checks are reported in the release notes when completed.
2. Quick install
Install Node.js 22 or newer, then:
npm install -g @thenavidm/kit-mcp-cli@latest
kit-cli --version
kit-cli
kit-cli list-broadcasts --help
kit-cli schema create-broadcast
kit-cli loginDiscovery, help and schemas work before authentication. login prints setup instructions. It does not open a browser, exchange an OAuth code or save credentials. Configure a v4 API key privately as KIT_API_KEY, then:
kit-cli doctor
kit-cli doctor --network
kit-cli get-account --agent
kit-cli list-broadcasts --per-page 10 --agent --select broadcasts.id,broadcasts.subject,paginationThe local doctor checks configuration. The network doctor reads the default account and reports authentication success without returning account details. It never sends a newsletter or changes subscribers.
For a single invocation without a global install:
npx -y --package @thenavidm/kit-mcp-cli@latest kit-cli toolsINSTALL.md covers Node/PATH on macOS, Windows and Linux, private account setup, every client, updates and removal. No .env file is loaded automatically.
3. Set up Kit access
Personal v4 API key
Open Kit's Developer settings, click Add a new key, name it and save the value privately when shown. Kit does not let you view that value again afterwards. Set KIT_API_KEY in your local shell or client settings. The server sends it in X-Kit-Api-Key, never a URL query string. Old v3 API secrets are not interchangeable.
Kit documents 120 requests over a rolling 60 seconds per API key and 600 for OAuth API access. The official hosted MCP separately documents 120/minute per token. This wrapper spaces calls per account by 550 ms for keys and 110 ms for OAuth. Other processes using the same credential also count against Kit's limits.
OAuth for full endpoint eligibility
Bulk and purchase endpoints in the tool table are marked OAuth-only. Create your own Kit app and enable API access, then implement the official OAuth authorization flow or Kit's Node example. Keep the app's secret on a private confidential backend. Use the callback URI exactly as registered, a cryptographically random state verified on callback, and HTTPS for a hosted callback.
The current authorization and token endpoints are https://api.kit.com/v4/oauth/authorize and https://api.kit.com/v4/oauth/token. There is no built-in OAuth consent service in this package. The old source's app.kit.com/oauth/token examples are obsolete. Follow Kit's current registered-app instructions; do not invent unsupported fine-grained OAuth scopes from operation-schema security labels.
A private token file can contain:
{
"access_token": "YOUR_OAUTH_ACCESS_TOKEN",
"refresh_token": "YOUR_OAUTH_REFRESH_TOKEN",
"client_id": "YOUR_OWN_KIT_APP_CLIENT_ID",
"client_secret": "YOUR_OWN_KIT_APP_CLIENT_SECRET",
"created_at": 1790899200,
"expires_in": 7200
}These are placeholders; use actual issued expiry metadata. Point KIT_TOKENS_FILE at an absolute private path outside the checkout. It must be a regular JSON file, at most 64 KB; symlinks are refused. Restrict access to your OS user. If expiry metadata is available, refresh happens one minute before expiry. Concurrent refreshes within the same process are deduplicated. Updated tokens are written atomically with mode 0600. On Windows, protect the enclosing folder using user-only ACLs; POSIX mode bits are not a complete Windows access policy.
Alternatively set KIT_ACCESS_TOKEN, KIT_REFRESH_TOKEN, KIT_CLIENT_ID and KIT_CLIENT_SECRET privately. Without a token file, refresh state lasts only in that process. Without refresh credentials, renew an expired access token yourself. An OAuth access token takes precedence over an API key for the selected account.
4. Connect your client
The full commands and private configurations are in INSTALL.md. Common registrations, after privately configuring account credentials:
claude mcp add --scope user kit -- npx -y @thenavidm/kit-mcp-cli@latest
claude mcp list
codex mcp add kit -- npx -y @thenavidm/kit-mcp-cli@latest
codex mcp listClaude Desktop can install the .mcpb release or use manual JSON. Cursor, Windsurf and Gemini CLI use their user MCP settings; VS Code supports secure prompted inputs; Zed uses context_servers. Local Cline/Roo-style clients accept the same stdio command through their MCP setup UI. A local stdio process is not a public HTTP connector for ChatGPT on the web. Kit's official hosted MCP is the appropriate remote option there.
Desktop settings accept a sensitive API key or a private OAuth token-file path. API-key authentication cannot use OAuth-only bulk and purchase endpoints. Custom extension availability depends on your installed host and organization policy.
Let an agent guide setup
Help me install Kit MCP Server & CLI using INSTALL.md. Check Node and the binary, let me configure my account credentials privately, then run discovery and doctor --network. Do not send email or change subscribers during setup.
For shell agents, make SKILL.md available through the client's supported skills location. npm installation does not register the skill automatically.
5. Check it works
kit-cli --version
kit-cli doctor
kit-cli doctor --network
kit-cli get-account --agent
kit-cli list-broadcasts --per-page 1 --agentLocal discovery works without credentials. The local doctor checks configuration; the network doctor reads account identity without returning private account details. It never sends email or changes subscribers. A successful read does not establish every endpoint's eligibility or template compatibility.
6. Output, flags and exit codes
Tool names become dashed commands: get_broadcast becomes kit-cli get-broadcast. Both exact underscore tool names and dashed forms are accepted. Argument names have dashed aliases: broadcast_id is --broadcast-id. Use help and schema to discover each operation's current input.
kit-cli tools
kit-cli get-broadcast --help
kit-cli schema get-broadcast
kit-cli get-broadcast --broadcast-id 123 --agentFlag | Behavior |
| Current schema-derived arguments and defaults |
| Structured JSON output |
| Compact JSON on one line |
| Compact JSON and no prompts; never confirms a write |
| Keep selected fields; dotted paths descend through objects and arrays |
| No terminal colors |
| No interactive prompts |
| Accepted for scripts written for other tools; never substitutes for |
| Explicit confirmation for the requested guarded operation |
| Select a configured local account on API tools |
| Complete request body as one JSON object |
| Complete request body from a local regular JSON file, at most 5 MB |
Body flags and payload/payload_file are mutually exclusive. Path and query flags remain separate. Objects take JSON; array flags repeat once per array item. Do not pass an array to a flag that expects a single item:
kit-cli list-subscribers --include tags --include stats --per-page 10 --agent
kit-cli create-broadcast --payload-file /absolute/private/path/newsletter.json --confirm --agentNull is meaningful
A shell flag such as --send-at null is the string null, not JSON null. Use the complete body form to return a scheduled broadcast to draft:
kit-cli update-broadcast --broadcast-id 123 --payload '{"send_at":null}' --confirm --agentThe same applies to nullable text, thumbnail and other nullable fields. In an MCP call, send an actual JSON null. Avoid mixing the nullable complete body with individual body flags.
Exit codes
Code | Meaning | A script's next step |
0 | Success | Use the returned data |
1 | Unexpected error | Report it with the command that caused it |
2 | Usage, validation or safety refusal, an unknown command or a hidden write | Correct inputs or obtain the requested authorization |
3 | Not found | Verify the resource ID |
4 | Authentication or permission failure | Check key, OAuth state or endpoint eligibility |
5 | Other API or transport failure | Inspect account state before repeating a write |
7 | Rate limit | Wait; mutating requests are not automatically retried |
10 | Missing or invalid local configuration | Repair private configuration |
Errors are JSON on stderr. On success, field selection shapes output only; it does not limit Kit's original response or its API processing.
7. MCP or CLI and token cost
Surface | How it runs | Suitable for |
| Local stdio server launched by an MCP client | Natural language account work in a compatible AI app |
| Schema-derived commands with machine-readable output | Scripts, CI and agents with shell access |
| Local MCP server with bundled production dependencies | Claude Desktop custom extensions |
Official Kit MCP | Hosted | Remote connections and browser-only AI clients |
Slipway builds the MCP server, over stdio or --http, and the CLI from each tool's one definition, with the same schemas, validation, handlers and safety guards. Separate handwritten CLI request logic cannot drift from the MCP path.
An MCP client may send tool schemas or deferred tool names into model context. A shell agent instead needs the skill, help, commands and results. Both consume tokens; neither surface guarantees lower total cost for every task.
kit-cli with no arguments lists commands. kit-mcp with no arguments starts stdio and does not print a banner. Avoid launching an interactive banner on an MCP server's stdout.
Measuring the context and task cost
Measured on 2026-10-05 against 2.0.3, with Claude Code 2.1.286 on Claude Opus 5.5 (one short prompt with and without the server connected, the difference read from the API's own usage figures) and Codex 0.159.3 on gpt-6.1-sol:
Cost | 2.0.3 | 3.0.0 |
Claude Code, every tool loaded, every message | 55,242 | 46,158 |
Claude Code's default, tool search, every message | 1,516 | 1,518 |
| 1,430 | 1,566 |
Codex over the CLI, one task, median of five | 84,497 | 83,147 |
Codex over MCP, the same task, median of five | 77,336 | 77,462 |
The task was "find the command that tags a subscriber, and the flags it requires". Every tool loaded costs less because parts that several tools repeated are written once. Over the CLI, every 3.0.0 run asked which, a 568-character answer, where every 2.0.3 run read the 6,245-character command list. Over MCP, Codex prints only part of a tool list this long and 3.0.0's part takes a few more tokens to say, so the median rose by 126, while two 3.0.0 runs answered from a shorter printout, against one 2.0.3 run, and the average fell from 70,923 to 64,738. SKILL.md costs 136 more because it says how approval works over MCP and how which finds a command, and lists every exit code.
Tool-list bytes or characters divided by four are not API usage, and no other offering was measured.
8. Every tool and argument
The following catalog is generated from the actual tools/list result. Body-required fields are enforced within payload or individual body arguments at execution; path/query requirements appear in each input schema. schema <command> is the exact machine-readable reference. OAuth-only labels come from the pinned operation security definitions.
Tool | API | Mode | OAuth only |
|
| Read | No |
|
| Read | No |
|
| Write | No |
|
| Read | No |
|
| Read | No |
|
| Read | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Read | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write | Yes |
|
| Write, confirms | Yes |
|
| Read | No |
|
| Write | No |
|
| Write, confirms | No |
|
| Write | No |
|
| Read | No |
|
| Write, confirms | Yes |
|
| Read | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Read | No |
|
| Read | Yes |
|
| Write, confirms | Yes |
|
| Read | Yes |
|
| Read | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | Yes |
|
| Read | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Read | No |
|
| Write, confirms | Yes |
|
| Write | Yes |
|
| Write, confirms | Yes |
|
| Write, confirms | Yes |
|
| Read | No |
|
| Write | No |
|
| Write | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
|
| Read | No |
|
| Write, confirms | No |
|
| Write, confirms | No |
| Alias for GET /v4/subscribers with exact email | Read | No |
| Local labels only | Read | No |
Shared input rules
Every API tool accepts optional account. Writes accept confirm; the 40 guarded operations require it to be true. Pagination controls are included only on tools whose schema supports cursor pagination. Body tools accept either their individual body fields or payload/payload_file. list_accounts accepts no arguments.
Complete arguments
get_account
Get current account. Read-only.
kit-cli get-account --helpArgument | Type | Required | Meaning |
list_colors
List colors. Read-only.
kit-cli list-colors --helpArgument | Type | Required | Meaning |
update_colors
Update colors. Reversible configuration write.
kit-cli update-colors --helpArgument | Type | Required | Meaning |
| array | Body | An array of up to 10 color hex codes |
get_creator_profile
Get Creator Profile. Read-only.
kit-cli get-creator-profile --helpArgument | Type | Required | Meaning |
get_email_stats
Get email stats. Read-only.
kit-cli get-email-stats --helpArgument | Type | Required | Meaning |
get_growth_stats
Get growth stats. Read-only.
kit-cli get-growth-stats --helpArgument | Type | Required | Meaning |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
list_broadcasts
List broadcasts. Read-only.
kit-cli list-broadcasts --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| string | No | Values: |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_broadcast
Create a broadcast. Requires confirmation.
kit-cli create-broadcast --helpArgument | Type | Required | Meaning |
| integer | No | Id of the email template to use. Uses the account's default template if not provided. 'Starting point' template is not supported. |
| string/null | No | The sending email address to use. Uses the account's sending email address if not provided. |
| string | No | The HTML content of the email. On a |
| string | No | See the exact input schema. |
| boolean | No |
|
| string | No | The published timestamp to display in ISO8601 format. If no timezone is provided, UTC is assumed. |
| string/null | No | The scheduled send time for this broadcast in ISO8601 format. If no timezone is provided, UTC is assumed. |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | Body | See the exact input schema. |
| array | No | Filters your subscribers. At this time, we only support using only one filter group type via the API (e.g. |
| boolean | No | Explicitly allow replacing a Starting point template body, as described in Kit’s current content-field documentation. Review the complete rendered HTML first. |
Body alternatives: content; email_template_id.
list_broadcast_stats
Get stats for a list of broadcasts. Read-only.
kit-cli list-broadcast-stats --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string | No | Values: |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
get_broadcast_clicks
Get link clicks for a broadcast. Read-only.
kit-cli get-broadcast-clicks --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive broadcast id. |
get_broadcast_stats
Get stats for a broadcast. Read-only.
kit-cli get-broadcast-stats --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive broadcast id. |
delete_broadcast
Delete a broadcast. Requires confirmation.
kit-cli delete-broadcast --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive broadcast id. |
get_broadcast
Get a broadcast. Read-only.
kit-cli get-broadcast --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive broadcast id. |
update_broadcast
Update a broadcast. Requires confirmation.
kit-cli update-broadcast --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive broadcast id. |
| integer | No | Id of the email template to use. Uses the account's default template if not provided. 'Starting point' template is not supported. |
| string/null | No | The sending email address to use. Uses the account's sending email address if not provided. |
| string | No | The HTML content of the email. On a |
| string | No | See the exact input schema. |
| boolean | No |
|
| string | No | The published timestamp to display in ISO8601 format. If no timezone is provided, UTC is assumed. |
| string/null | No | The scheduled send time for this broadcast in ISO8601 format. If no timezone is provided, UTC is assumed. |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| array | No | Filters your subscribers. At this time, we only support using only one filter group type via the API (e.g. |
| boolean | No | Explicitly allow replacing a Starting point template body, as described in Kit’s current content-field documentation. Review the complete rendered HTML first. |
bulk_create_custom_fields
Bulk create custom fields. OAuth-only. Reversible configuration write.
kit-cli bulk-create-custom-fields --helpArgument | Type | Required | Meaning |
| array | Body | See the exact input schema. |
| string/null | No | See the exact input schema. |
bulk_update_subscriber_custom_field_values
Bulk update subscriber custom field values. OAuth-only. Requires confirmation.
kit-cli bulk-update-subscriber-custom-field-values --helpArgument | Type | Required | Meaning |
| array | Body | See the exact input schema. |
| schema | Body | See the exact input schema. |
list_custom_fields
List custom fields. Read-only.
kit-cli list-custom-fields --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_custom_field
Create a custom field. Reversible configuration write.
kit-cli create-custom-field --helpArgument | Type | Required | Meaning |
| string | Body | See the exact input schema. |
delete_custom_field
Delete custom field. Requires confirmation.
kit-cli delete-custom-field --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive custom field id. |
update_custom_field
Update a custom field. Reversible configuration write.
kit-cli update-custom-field --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive custom field id. |
| string | Body | See the exact input schema. |
list_email_templates
List email templates. Read-only.
kit-cli list-email-templates --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
bulk_add_subscribers_to_forms
Bulk add subscribers to forms. OAuth-only. Requires confirmation.
kit-cli bulk-add-subscribers-to-forms --helpArgument | Type | Required | Meaning |
| array | Body | See the exact input schema. |
| string/null | No | See the exact input schema. |
list_forms
List forms. Read-only.
kit-cli list-forms --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string/null | No | Values: |
| schema | No | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
list_subscribers_for_form
List subscribers for a form. Read-only.
kit-cli list-subscribers-for-form --helpArgument | Type | Required | Meaning |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| schema | Yes | Positive form id. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| string | No | Values: |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
add_subscriber_to_form
Add subscriber to form by email address. Requires confirmation.
kit-cli add-subscriber-to-form --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive form id. |
| string | Body | See the exact input schema. |
| string/null | No | See the exact input schema. |
add_subscriber_to_form_by_id
Add subscriber to form. Requires confirmation.
kit-cli add-subscriber-to-form-by-id --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive form id. |
| schema | Yes | Positive subscriber id. |
| string | Body | See the exact input schema. |
list_posts
List posts. Read-only.
kit-cli list-posts --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
get_post
Get a post. Read-only.
kit-cli get-post --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive post id. |
list_purchases
List purchases. OAuth-only. Read-only.
kit-cli list-purchases --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_purchase
Create a purchase. OAuth-only. Requires confirmation.
kit-cli create-purchase --helpArgument | Type | Required | Meaning |
| object | Body | See the exact input schema. |
get_purchase
Get a purchase. OAuth-only. Read-only.
kit-cli get-purchase --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive purchase id. |
list_segments
List segments. Read-only.
kit-cli list-segments --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
list_sequence_emails
List sequence emails. Read-only.
kit-cli list-sequence-emails --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | Yes | Positive sequence id. |
| string | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_sequence_email
Create a sequence email. Requires confirmation.
kit-cli create-sequence-email --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive sequence id. |
| string | Body | Subject line of the email |
| string/null | No | Preview text shown in email clients before the email is opened |
| string/null | No | HTML body content of the email |
| integer | Body | Number of days or hours to wait before sending this email after the previous one |
| string | Body | Unit for the send delay. Use |
| integer/null | No | ID of the email template to use for layout and styling |
| boolean | No | Whether the email is active and will be sent to subscribers. Defaults to |
| array/null | No | Days of the week this email may be sent. Defaults to all 7 days (inherits the sequence schedule). Pass a subset to restrict delivery, or |
| integer/null | No | Zero-based position of the email in the sequence. Assigned automatically after the last email if omitted |
delete_sequence_email
Delete a sequence email. Requires confirmation.
kit-cli delete-sequence-email --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive email id. |
| schema | Yes | Positive sequence id. |
get_sequence_email
Get a sequence email. Read-only.
kit-cli get-sequence-email --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive email id. |
| schema | Yes | Positive sequence id. |
| string | No | See the exact input schema. |
update_sequence_email
Update a sequence email. Requires confirmation.
kit-cli update-sequence-email --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive email id. |
| schema | Yes | Positive sequence id. |
| string | No | New subject line for the email |
| string/null | No | New preview text shown in email clients before the email is opened |
| string/null | No | New HTML body content of the email |
| integer | No | New delay value |
| string | No | New delay unit. Use |
| integer/null | No | New email template ID for layout and styling. Pass |
| boolean | No | Pass |
| array/null | No | Days of the week this email may be sent. Pass a subset to restrict delivery, or |
| integer/null | No | New zero-based position of the email in the sequence |
list_sequences
List sequences. Read-only.
kit-cli list-sequences --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_sequence
Create a sequence. Requires confirmation.
kit-cli create-sequence --helpArgument | Type | Required | Meaning |
| string | No | The name of the sequence. |
| string | No | The sending email address to use. Uses the account's sending email address if not provided. |
| integer | No | Id of the email template to use. |
| array | No | The days of the week to send the sequence on. Must be one of: |
| integer | No | The hour of the day to send the sequence at. Must be an integer between 0 and 23. |
| string | No | The timezone to use for the sequence. Must be a valid IANA timezone string. |
| boolean | No |
|
| boolean | No | When |
| boolean | No | When |
| array | No | The subscriber sources to exclude from the sequence. |
delete_sequence
Delete a sequence. Requires confirmation.
kit-cli delete-sequence --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive sequence id. |
get_sequence
Get a sequence. Read-only.
kit-cli get-sequence --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive sequence id. |
| string | No | See the exact input schema. |
update_sequence
Update a sequence. Requires confirmation.
kit-cli update-sequence --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive sequence id. |
| string | No | The name of the sequence. |
| string | No | The sending email address to use. Uses the account's sending email address if not provided. |
| integer | No | Id of the email template to use. |
| array | No | The days of the week to send the sequence on. Must be one of: |
| integer | No | The hour of the day to send the sequence at. Must be an integer between 0 and 23. |
| string | No | The timezone to use for the sequence. Must be a valid IANA timezone string. |
| boolean | No |
|
| boolean | No | When |
| boolean | No | When |
| array | No | The subscriber sources to exclude from the sequence. |
list_subscribers_for_sequence
List subscribers for a sequence. Read-only.
kit-cli list-subscribers-for-sequence --helpArgument | Type | Required | Meaning |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | Yes | Positive sequence id. |
| string | No | Values: |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
add_subscriber_to_sequence
Add subscriber to sequence by email address. Requires confirmation.
kit-cli add-subscriber-to-sequence --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive sequence id. |
| string | Body | See the exact input schema. |
add_subscriber_to_sequence_by_id
Add subscriber to sequence. Requires confirmation.
kit-cli add-subscriber-to-sequence-by-id --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
| schema | Yes | Positive sequence id. |
list_snippets
List snippets. Read-only.
kit-cli list-snippets --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_snippet
Create a snippet. Requires confirmation.
kit-cli create-snippet --helpArgument | Type | Required | Meaning |
get_snippet
Get a snippet. Read-only.
kit-cli get-snippet --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive snippet id. |
update_snippet
Update a snippet. Requires confirmation.
kit-cli update-snippet --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive snippet id. |
bulk_create_subscribers
Bulk create subscribers. OAuth-only. Requires confirmation.
kit-cli bulk-create-subscribers --helpArgument | Type | Required | Meaning |
| array | Body | See the exact input schema. |
| string/null | No | See the exact input schema. |
list_subscribers
List subscribers. Read-only.
kit-cli list-subscribers --helpArgument | Type | Required | Meaning |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| number/null | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| string | No | Values: |
| string | No | Values: |
| string | No | Values: |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_subscriber
Create a subscriber. Requires confirmation.
kit-cli create-subscriber --helpArgument | Type | Required | Meaning |
| string/null | No | See the exact input schema. |
| string | Body | See the exact input schema. |
| string/null | No | Create subscriber in this state ( |
| object | No | Custom field values keyed by the custom field's |
filter_subscribers
Filter subscribers by engagement, sign-up date, state, and tags. Read-only.
kit-cli filter-subscribers --helpArgument | Type | Required | Meaning |
| string | No | Controls how engagement-filter count thresholds are tallied. |
| array | Body | Array of filter conditions where ALL must be met (AND logic) |
| array | No | Optional. Array of |
| string | No | Field to order results by. Base columns ( |
| string | No | Sort direction (default: desc). Values: |
get_subscriber
Get a subscriber. Read-only.
kit-cli get-subscriber --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
update_subscriber
Update a subscriber. Requires confirmation.
kit-cli update-subscriber --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
| string/null | No | See the exact input schema. |
| string | Body | See the exact input schema. |
| object | No | Custom field values keyed by the custom field's |
unsubscribe
Unsubscribe subscriber. Requires confirmation.
kit-cli unsubscribe --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
delete_subscriber_location
Delete a subscriber's location. Requires confirmation.
kit-cli delete-subscriber-location --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
update_subscriber_location
Update a subscriber's pinned location. Requires confirmation.
kit-cli update-subscriber-location --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
| object | Body | See the exact input schema. |
pin_subscriber_location
Pin a subscriber's location. Requires confirmation.
kit-cli pin-subscriber-location --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
| object | Body | See the exact input schema. |
get_subscriber_stats
List stats for a subscriber. Read-only.
kit-cli get-subscriber-stats --helpArgument | Type | Required | Meaning |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| schema | Yes | Positive subscriber id. |
list_subscriber_tags
List tags for a subscriber. Read-only.
kit-cli list-subscriber-tags --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| schema | Yes | Positive subscriber id. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
bulk_delete_tags
Bulk delete tags. OAuth-only. Requires confirmation.
kit-cli bulk-delete-tags --helpArgument | Type | Required | Meaning |
| array | Body | Tags to delete, identified by |
| string/null | No | Optional. When the batch is processed asynchronously (more than 100 tags), the results are POSTed to this URL on completion. |
bulk_create_tags
Bulk create tags. OAuth-only. Reversible configuration write.
kit-cli bulk-create-tags --helpArgument | Type | Required | Meaning |
| array | Body | See the exact input schema. |
| string/null | No | See the exact input schema. |
bulk_remove_tags_from_subscribers
Bulk remove tags from subscribers. OAuth-only. Requires confirmation.
kit-cli bulk-remove-tags-from-subscribers --helpArgument | Type | Required | Meaning |
bulk_tag_subscribers
Bulk tag subscribers. OAuth-only. Requires confirmation.
kit-cli bulk-tag-subscribers --helpArgument | Type | Required | Meaning |
| array | Body | See the exact input schema. |
| string/null | No | See the exact input schema. |
list_tags
List tags. Read-only.
kit-cli list-tags --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_tag
Create a tag. Reversible configuration write.
kit-cli create-tag --helpArgument | Type | Required | Meaning |
| string | Body | See the exact input schema. |
update_tag_name
Update tag name. Reversible configuration write.
kit-cli update-tag-name --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive tag id. |
| string | Body | See the exact input schema. |
untag_subscriber_by_email
Remove tag from subscriber by email address. Requires confirmation.
kit-cli untag-subscriber-by-email --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive tag id. |
| string | Yes | See the exact input schema. |
list_subscribers_for_tag
List subscribers for a tag. Read-only.
kit-cli list-subscribers-for-tag --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| string | No | Values: |
| schema | Yes | Positive tag id. |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
tag_subscriber
Tag a subscriber by email address. Requires confirmation.
kit-cli tag-subscriber --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive tag id. |
| string | Body | See the exact input schema. |
untag_subscriber
Remove tag from subscriber. Requires confirmation.
kit-cli untag-subscriber --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
| schema | Yes | Positive tag id. |
tag_subscriber_by_id
Tag a subscriber. Requires confirmation.
kit-cli tag-subscriber-by-id --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive subscriber id. |
| schema | Yes | Positive tag id. |
list_webhook_endpoints
List webhook endpoints. Read-only.
kit-cli list-webhook-endpoints --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| string | No | Values: |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_webhook_endpoint
Create a webhook endpoint. Requires confirmation.
kit-cli create-webhook-endpoint --helpArgument | Type | Required | Meaning |
| string | Body | See the exact input schema. |
| array | Body | Event types this endpoint subscribes to (e.g. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | Yes | New private filename under KIT_PRIVATE_DIR. Required before creating/rotating a signing secret; never overwritten. |
delete_webhook_endpoint
Delete a webhook endpoint. Requires confirmation.
kit-cli delete-webhook-endpoint --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive webhook endpoint id. |
get_webhook_endpoint
Get a webhook endpoint. Read-only.
kit-cli get-webhook-endpoint --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive webhook endpoint id. |
update_webhook_endpoint
Update a webhook endpoint. Requires confirmation.
kit-cli update-webhook-endpoint --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive webhook endpoint id. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | Endpoint status. One of: |
| array | No | Event types this endpoint subscribes to (e.g. |
revoke_previous_webhook_secret
Revoke the previous webhook endpoint secret. Requires confirmation.
kit-cli revoke-previous-webhook-secret --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive webhook endpoint id. |
rotate_webhook_secret
Rotate a webhook endpoint secret. Requires confirmation.
kit-cli rotate-webhook-secret --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive webhook endpoint id. |
| boolean | No | Rotating again while a previous rotation's overlap window is still open returns |
| string | Yes | New private filename under KIT_PRIVATE_DIR. Required before creating/rotating a signing secret; never overwritten. |
list_webhooks
List webhooks. Read-only.
kit-cli list-webhooks --helpArgument | Type | Required | Meaning |
| schema | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| schema | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
create_webhook
Create a webhook. Requires confirmation.
kit-cli create-webhook --helpArgument | Type | Required | Meaning |
| string | Body | See the exact input schema. |
| object | Body | See the exact input schema. |
delete_webhook
Delete a webhook. Requires confirmation.
kit-cli delete-webhook --helpArgument | Type | Required | Meaning |
| schema | Yes | Positive webhook id. |
search_subscribers
Find subscribers by exact email. Read-only.
kit-cli search-subscribers --helpArgument | Type | Required | Meaning |
| string/null | No | See the exact input schema. |
| string/null | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| string | Yes | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| number/null | No | See the exact input schema. |
| boolean | No | See the exact input schema. |
| string | No | Values: |
| string | No | Values: |
| string | No | Values: |
| string | No | See the exact input schema. |
| string | No | See the exact input schema. |
| boolean | No | Read successive cursor pages, bounded by max_items (default 1000). Default false returns one API page. |
| integer | No | Maximum records when all_pages=true. A capped result reports truncation and its continuation cursor. |
list_accounts
List configured accounts. Read-only.
kit-cli list-accounts --helpNo arguments.
9. Newsletter and subscriber workflows
Draft privately, review, then schedule
A create call defaults to public:false and send_at:null. It creates a private unscheduled draft. It still requires confirmation because it changes account content and can accept delivery fields when explicitly supplied.
kit-cli list-email-templates --agent
kit-cli create-broadcast --subject "This week's creator notes" --content '<p>Write the actual newsletter here.</p>' --confirm --agent --select broadcast.id,broadcast.subject,broadcast.send_at
kit-cli get-broadcast --broadcast-id BROADCAST_ID_FROM_RESULT --agentPositive IDs are returned by Kit; replace illustrative markers with real IDs. For an existing draft, validate the intended audience and delivery time before the separate confirmed update:
kit-cli update-broadcast --broadcast-id 123 --payload-file /absolute/private/path/schedule.json --confirm --agentYour private schedule.json contains the ISO timestamp and the audience fields from the current schema, for example send_at with a timezone offset or UTC Z. published_at controls web publication metadata; it is not the email send time. Neither successful creation nor a local confirmation proves delivery. Read the broadcast and statistics afterwards.
Template HTML needs care
The API's content is HTML; it is not Kit's visual editor block tree. Preserve the full email wrapper and required Liquid unsubscribe/address markup when replacing content. Retrieve an existing example and inspect the selected template before updating. Do not replace a whole template with one paragraph if you need its existing branding and legal footer.
Kit's current OpenAPI prose contradicts itself around Starting point templates and required fields. This wrapper accepts a subject plus either content or email_template_id, allows nonempty partial broadcast updates, and exposes the documented allow_starting_point flag. These reviewed corrections are recorded with the snapshot. Starting point behavior remains unverified against a live account, so test with a private unscheduled draft and inspect it in Kit before any send.
Existing broadcasts and click reports
kit-cli list-broadcasts --per-page 10 --agent --select broadcasts.id,broadcasts.subject,pagination
kit-cli get-broadcast-stats --broadcast-id 123 --agent
kit-cli get-broadcast-clicks --broadcast-id 123 --agentThe client does not automatically retry POST, PUT, PATCH or DELETE requests. A timeout can have an unknown outcome. Check the existing draft or scheduled broadcast before repeating a write; sending twice cannot be undone by a retry wrapper.
Subscriber workflows
Find an exact email or read a bounded list, then choose a requested audience change:
kit-cli search-subscribers --email-address reader@example.com --agent
kit-cli list-tags --agent
kit-cli tag-subscriber --tag-id 123 --email-address reader@example.com --confirm --agent
kit-cli list-subscriber-tags --subscriber-id 456 --agentThe .example address is illustrative. Do not add or tag real people without the requested account action. Tagging and form/sequence enrollment may trigger existing Kit automations.
filter_subscribers is a read-only POST with nested all/any filters. Use its current schema and a private JSON body; it is not a v3 page-number endpoint. search_subscribers is an exact-email compatibility alias, not a fuzzy search engine.
Sequences now have their own create/update/delete endpoints and individual email operations. Read their schemas and current delay units before using them. Sequence enrollment can deliver email through existing automation, so it is confirmed even if the API call itself merely adds a subscriber.
Custom field and tag creation are reversible configuration writes, so they do not require --confirm; they still disappear in read-only mode. Deletions, audience changes, snippets that can affect email and purchases are guarded. The tool table labels every operation.
10. Pagination, bulk work and webhooks
Cursor pages
Kit v4 uses after, before, start_cursor and end_cursor, not old v3 numeric page arguments. Default per_page is 500, maximum 1000. Ask for a small page when you only need a sample:
kit-cli list-subscribers --per-page 25 --include-total-count --agent
kit-cli list-subscribers --after END_CURSOR_FROM_RESULT --per-page 25 --agent
kit-cli list-subscribers --all-pages --max-items 1000 --agentDo not supply both before and after. all_pages traverses forward and refuses before. It stops at max_items (default 1000, maximum 10000) or 100 pages, and refuses repeated cursors. It reduces each page size to the remaining cap so the returned end cursor does not skip unseen records. Aggregated output includes collected, pages, the last pagination object and truncated.
include_total_count must be requested where supported; total count can add API work. max_items without all_pages is a usage error. This is bounded retrieval, not a backup/export guarantee for an entire large account.
OAuth-only bulk
The full API snapshot supplies nested request schemas and endpoint-specific limits. Discover the body and put private batches outside the checkout:
kit-cli schema bulk-create-subscribers
kit-cli bulk-create-subscribers --payload-file /absolute/private/path/subscribers.json --confirm --agentSome bulk operations require a callback URL. Use HTTPS on a receiver you control and inspect its actual completion notification. The wrapper does not deploy or listen for callbacks. Split payloads according to Kit's current per-endpoint limits and the local 5 MB request cap. Do not retry an asynchronous submission merely because its completion has not arrived yet.
Signed webhooks
The current signed webhook_endpoints family and older webhooks are separate APIs. Prefer signed endpoints for new setups. Discover the accepted event enum from the current schema:
kit-cli schema create-webhook-endpoint
kit-cli create-webhook-endpoint --url https://your-receiver.example/kit --events EVENT_FROM_SCHEMA --secret-name newsletter-hook --confirm --agentReplace both placeholders with your own endpoint and a supported event. Creation and secret rotation require a new secret_name. Before the remote call, the server reserves that filename exclusively under KIT_PRIVATE_DIR (default ~/.config/kit-mcp-cli/secrets) with mode 0600. Existing files are never overwritten.
Returned signing secrets are redacted from model/CLI output and saved to the private file. The result exposes secret_file, not the secret itself. Configure your own receiver's signature verification privately. The package does not provide a receiver or claim that the endpoint is reachable. Protect private folders with Windows ACLs where applicable.
When rotating, update and verify your receiver before revoking the previous secret. If Kit changed the endpoint but local secret storage failed, inspect the remote endpoint before attempting rotation again. Do not paste signing secrets in an AI chat or public issue.
11. Several private accounts
Set KIT_ACCOUNTS to a private JSON array. Its supported keys are name, api_key, access_token, refresh_token, client_id, client_secret and tokens_file. It replaces the single-account variables:
[
{"name":"work","api_key":"YOUR_WORK_V4_KEY"},
{"name":"personal","tokens_file":"/absolute/private/path/personal-kit.json"}
]Set KIT_DEFAULT_ACCOUNT=work, then:
kit-cli list-accounts --agent
kit-cli list-broadcasts --account work --per-page 10 --agent
kit-cli get-growth-stats --account personal --agentNames must be unique. list_accounts exposes labels, default choice and auth type only, never credentials or file paths. Guard logs omit account names. Separate processes are still preferable when you need strict account isolation.
12. Writing safely
KIT_READ_ONLY=1 hides every write, leaving 38 reads, and also refuses a direct write invocation. KIT_ALLOW_DESTRUCTIVE=0 leaves tools visible but refuses the 40 guarded audience/delivery/deletion/secret operations. There is no --agent or --yes bypass. Confirmation means permission for the actual user-requested operation, not a blanket license to modify an account.
Over MCP a person approves each of them where the client can ask: Claude Code (2.1.246 and later) shows its own prompt, and a client that can show forms asks with an approval form whose one box starts unticked. Each approval is signed, bound to that exact call and works once. Where a client can do neither, the model's confirm: true counts. KIT_CONFIRM=model makes confirm: true enough everywhere, for an agent with no person to ask.
Seven configuration writes (such as creating a tag or custom field) do not require confirmation. They are still writes and are blocked by read-only mode. Tool annotations describe read, destructive, idempotent and open-world behavior; application prompts remain client-dependent.
GET 429 responses can retry up to two times by default, honoring a bounded delay. GET OAuth 401 can refresh and retry once. All mutating requests have zero automatic retries, including 429 and token expiry. A read-only filter POST also has no automatic retry. Treat service data as data, not instructions to execute an unrelated operation.
13. How it works
git clone https://github.com/thenavidm/kit-mcp-cli.git
cd kit-mcp-cli
npm ci
npm run typecheck
npm run build
npm test
npm run check:counts
npm run build:mcpb
npm pack --dry-runThe snapshot is checked into scripts/kit-api.snapshot.json; generated operation schemas and the source hash are in src/tools/. To review a future API snapshot, save the official document locally and run node scripts/sync-openapi.mjs /absolute/path/reviewed-v4.json, inspect every diff and re-run the checks. Do not treat new endpoint discovery as a reviewed release. Record current source corrections and verify live behavior when credentials permit.
The CI workflow verifies Node 22 and 24 on Linux and Windows, then builds the desktop archive. The release workflow verifies package/tag/counts/tests, publishes npm with provenance, and attaches the matching desktop archive. Release tags are annotated v<package version>. Topics and npm keywords cover the actual Kit/MCP/CLI surfaces. Credentials use encrypted GitHub secrets or private local configuration and never enter a package.
The npm allowlist includes built code, full setup/skill/comparison/changelog/security/contribution docs and licenses. It excludes source tests, private account files, local .env, build scratch folders and the desktop archive. The .mcpb vendors production dependencies, the server and notices without configured credentials. A build dependency audit can differ from the production audit; see SECURITY.md.
Issues and reproducible bug reports are welcome. This repository does not accept unsolicited pull requests; see CONTRIBUTING.md. Use private vulnerability reporting for security issues.
14. Your data
Requests go directly to https://api.kit.com/v4; no Navid-hosted relay, analytics or telemetry is included. HTTP redirects are refused. Keys, OAuth tokens, client secrets and signing secrets are sanitized from tool results and reflected API errors. Subscriber addresses, email content, reports and other authorized response data are still private business data that your AI client can process. Configure its retention and sharing policy accordingly.
Private OAuth files, webhook-secret files and optional audit files remain local. Audit records contain attempted write names, risk, surface, decision and outcome, without arguments, subscriber addresses, message bodies, account labels or credentials. Audit failure does not block a requested operation. It is a guard-decision log, not proof of remote delivery or complete Kit account audit history.
See SECURITY.md for disclosure, private file handling, dependency limitations and live-validation limits.
15. Environment variables
Variable | Default | Meaning |
|
| Personal v4 API key |
|
| Existing OAuth access token |
|
| OAuth refresh token |
|
| Your authorized Kit app ID |
|
| Your private confidential-app secret |
|
| Regular private OAuth JSON, max 64 KB |
|
| Private JSON named accounts; replaces single-account settings |
|
| Default name from KIT_ACCOUNTS |
|
| 1 or true hides and refuses all 47 writes |
|
| 0 or false blocks all 40 guarded operations even with confirm |
|
| Local attempted-write guard log, no request fields |
|
| Private signing-secret folder |
|
| Per-request deadline, integer 100–300000 |
|
| GET 429 retries only, integer 0–5 |
|
| 0 chooses 550 ms keys / 110 ms OAuth; otherwise 1–10000 ms |
|
|
|
|
|
|
| None | Give up on any tool after this long |
| 8787, 127.0.0.1, none | For |
| None | Comma-separated browser origins allowed to call |
| 0 |
|
The package reads environment variables only. It does not automatically load .env, resolve a secret-manager account, or inherit GUI environment values from a terminal. Private client config examples are in INSTALL.md. Never put real credentials in project MCP files.
16. Updates and removal
npm install -g @thenavidm/kit-mcp-cli@latest
kit-cli --version
claude mcp remove --scope user kit
codex mcp remove kit
npm uninstall -g @thenavidm/kit-mcp-cliReinstall a newer desktop archive separately and restart affected clients. Remove manual client entries using its own settings. Uninstalling the package does not revoke Kit credentials, remove private token/secret files or unschedule email. Revoke/delete keys or authorized apps in Kit when appropriate. Inspect and remove private files yourself after preserving any receiver secrets still in use.
Pin a reviewed version instead of @latest if your automation requires reproducibility. Check CHANGELOG.md and GitHub Releases before a major update. Do not roll back by blindly publishing an older version over an existing npm version.
17. Troubleshooting
Symptom | Resolution |
Binary not found | Install Node 22+, check npm global prefix/PATH, reopen terminal |
PowerShell blocks npm.ps1 | Use npm.cmd or Command Prompt in accordance with your policy |
Local doctor exit 10 | Configure a v4 key or regular OAuth token file in private settings |
GUI works differently from terminal | GUI clients often do not inherit shell env; configure private client env |
API 401 | Verify v4 credentials; OAuth may be expired or revoked |
API 403 / OAuth required | Check current plan permissions and use OAuth for that endpoint |
Read-only missing tools | Set KIT_READ_ONLY=0 only when writes are wanted; reconnect |
Confirmation refused | Supply confirm:true/--confirm only for an explicitly requested operation; check destructive policy |
Invalid request body | Read schema; use payload for nested fields/null; avoid mixing body forms |
No results beyond the first page | Follow end_cursor or use bounded all_pages |
429 | Wait; other integrations share the credential limit; do not blindly retry writes |
Write timeout | Outcome may be unknown; inspect the account before repeating |
Template or Starting point error | See recorded schema contradictions and test an unscheduled private draft |
Secret filename exists | Choose a new private secret_name; files are never overwritten |
Refresh succeeds but file update fails | Repair private folder access and inspect state before another write |
Desktop extension rejected | Validate host custom-extension policy and compatible runtime; try manual stdio setup |
18. API coverage and comparisons
Offering | Surface | What the reviewed source establishes | Tradeoff |
Remote MCP, Kit OAuth | v4 account reads and writes; paid Creator/Creator Pro; 120 requests/min/token | Hosted consent/setup; standalone task CLI not identified there | |
Documentation MCP | Read documentation | No account operations | |
This package | Local stdio, CLI, desktop archive | 83 pinned operations + 2 helpers, private account settings and guards | You maintain local credentials; live writes pending |
PHP/Laravel integration and Artisan commands | Kit integration with framework commands | Requires the Laravel application environment | |
Provider data-access CLI | JDBC-backed data access from a CLI | Different provider/license and data-oriented scope |
COMPARISON.md records dated primary sources, scope and limitations. Counts are package discovery results, not evidence that the official server has fewer endpoints. No competitor latency, success rate or total token cost has been measured here.
19. Versions
Component | Version / source |
This package and desktop manifest | 3.0.0 |
Runtime | Node 22 or newer |
Kit API | v4; 83 reviewed operations from the 2026-10-02 snapshot |
Slipway | 0.1.20 |
MCP TypeScript SDK, through Slipway | 2.3.0 |
Source provenance | api-source.json, with SHA-256 and corrections |
CHANGELOG.md records dated changes and validation. Version 2.0.0 replaces the private 1.0.0 source with a sanitized public v4 implementation. It preserves the AGPL license and useful operation names, and adds the CLI and desktop surface.
The old source's private account instructions and original commits remain private. Public history starts with the reviewed v2 source; this avoids publishing personal setup data. Only the sanitized public branch is pushed.
Major-version migration
Configure a v4 key or private authorized OAuth file; a v3 API secret is insufficient.
Replace numeric page arguments with v4 cursors.
Use current tool IDs and schemas;
search_subscribersremains an exact-email alias.The old browser
kit_loginand broadcast/sequence/visual-automation duplication helpers are not included. Their private cookie workflows are not part of the v4 API. Use the Kit UI for designed duplication and visual automation work.API sequence/email CRUD is now available, but it is not a claim of legacy browser feature parity.
Review
send_at, draft defaults and explicit confirmation before any delivery or audience change.Never copy old personal SKILL content, cookies or the private Git history into public files.
20. FAQ
The wrapper is free AGPL software. Your Kit subscription and API eligibility are separate. The official Kit MCP is available on paid Creator and Creator Pro plans; consult Kit for your account’s API access.
Yes. Its account server supports reads and writes across v4. Its separate developer-docs MCP reads documentation and cannot act on your account.
Use it for standalone task commands, shell automation, private named-account settings, token-file refresh, bounded pagination or a local desktop archive. Use Kit’s official server for Kit-managed hosted OAuth. Neither is declared universally better.
No standalone email-account task CLI was identified in the official developer surfaces reviewed on 2026-10-02. Framework-specific and data-provider CLIs exist; see COMPARISON.md.
Discovery shows them, but OAuth-only bulk and purchase endpoints reject API-key calls before HTTP. The tool table marks them. Use an authorized OAuth session for those operations.
No. Configure it privately in your shell or client settings. Help, discovery and schemas work without it.
No. It explains first-time key/OAuth setup. This package does not host a consent flow or copy your browser cookies.
Yes, through local stdio configuration or the custom .mcpb release. GUI installation of this version remains a separate host check.
This local package does not expose an HTTPS connector. Use Kit’s official remote MCP for a compatible web connector.
The wrapper defaults create to private and unscheduled. If you explicitly pass send_at or publication fields, they can change that behavior. All broadcast writes require confirmation; review in Kit before delivery.
No. Use send_at for email delivery. published_at concerns web publication.
Use update_broadcast with a JSON body containing send_at:null, then inspect the broadcast. A shell string null is not JSON null.
Inspect existing template HTML and required Liquid/footer markup before changing content. The API is not a visual block editor. Starting point schema conflicts remain live-account validation pending.
Yes, existing automations can react to tagging, form subscription or sequence enrollment. Those operations require explicit confirmation here.
No. Mutating requests are never automatically retried. A timeout may have an unknown outcome; inspect the account first.
Yes. Use a private KIT_ACCOUNTS array with unique names, then --account. list_accounts returns labels/auth methods without credentials.
Use after or bounded all_pages/max_items. v4 uses cursors. Aggregate output exposes the last cursor and truncation; it is not an unlimited export.
New signed endpoint secrets go to exclusive owner-only files under KIT_PRIVATE_DIR and are redacted from returned tool data. Configure your own receiver privately.
Against the official MCP it has not been measured. In Claude Code the CLI costs nothing until it is used, plus about 1,570 tokens for SKILL.md once, where the server costs about 1,520 tokens a message with tool search and 46,200 with every tool loaded. In Codex, finding the command that tags a subscriber and its flags took a median of 83,147 input tokens over the CLI and 77,462 over MCP. Section 7 has how each was measured.
Create new private settings with a v4 key or authorized OAuth token file. Do not copy old personal SKILL content, cookies or source history into a public repo. See the 2.0 migration notes.
Questions
Open an issue with the version, client and a sanitized reproduction. Report security problems privately through SECURITY.md.
About the author
Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. He creates useful free tools, MCP servers and CLIs that creators and founders can use in their own workflows.
Links
Personal website: navid.me
Link in bio: navid.bio
Navid Media: navid.media
YouTube: @thenavidm and @thenavidai
X: @thenavidm
Instagram: @thenavidm
LinkedIn: thenavidm
Dependencies
Dependency | Version range | Used for |
|
| The MCP server and the CLI from one definition of each tool, with the MCP TypeScript SDK |
|
| JSON Schema input validation |
|
| JSON Schema input validation |
Full third-party attribution is in THIRD_PARTY_NOTICES.md. Development tooling and its audit limitations are documented in SECURITY.md.
License
This wrapper is AGPL-3.0-or-later, preserving the legacy source's license. See LICENSE and the full AGPL text. Kit's service and documentation retain their own rights and terms. Third-party dependency attribution is in THIRD_PARTY_NOTICES.md.
© 2026 Navid Media. Made with ❤️ by Navid Moazzez.
Available Tools
85 toolsadd_subscriber_to_formAdd subscriber to form by email addressADestructive
Add subscriber to form by email address. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: form_id (required), account, confirm, payload, +3 more.
add_subscriber_to_form_by_idAdd subscriber to formADestructive
Add subscriber to form. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: form_id (required), subscriber_id (required), account, confirm, +3 more.
add_subscriber_to_sequenceAdd subscriber to sequence by email addressADestructive
Add subscriber to sequence by email address. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: sequence_id (required), account, confirm, payload, +2 more.
add_subscriber_to_sequence_by_idAdd subscriber to sequenceADestructive
Add subscriber to sequence. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: sequence_id (required), subscriber_id (required), account, confirm.
bulk_add_subscribers_to_formsBulk add subscribers to formsADestructive
Bulk add subscribers to forms. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, confirm, payload, additions, +2 more.
bulk_create_custom_fieldsBulk create custom fieldsA
Bulk create custom fields. Changes account configuration. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, payload, callback_url, payload_file, +1 more.
bulk_create_subscribersBulk create subscribersADestructive
Bulk create subscribers. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, confirm, payload, subscribers, +2 more.
bulk_create_tagsBulk create tagsB
Bulk create tags. Changes account configuration. Requires OAuth; API keys are not supported for this endpoint.
Inputs: tags, account, payload, callback_url, +1 more.
bulk_delete_tagsBulk delete tagsADestructive
Bulk delete tags. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: tags, account, confirm, payload, +2 more.
bulk_remove_tags_from_subscribersBulk remove tags from subscribersADestructive
Bulk remove tags from subscribers. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, confirm.
bulk_tag_subscribersBulk tag subscribersBDestructive
Bulk tag subscribers. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, confirm, payload, taggings, +2 more.
bulk_update_subscriber_custom_field_valuesBulk update subscriber custom field valuesADestructive
Bulk update subscriber custom field values. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, confirm, payload, callback_url, +2 more.
create_broadcastCreate a broadcastBDestructive
Create a broadcast. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: public, account, confirm, content, +13 more.
create_custom_fieldCreate a custom fieldB
Create a custom field. Changes account configuration.
Inputs: label, account, payload, payload_file.
create_purchaseCreate a purchaseADestructive
Create a purchase. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Requires OAuth; API keys are not supported for this endpoint.
Inputs: account, confirm, payload, purchase, +1 more.
create_sequenceCreate a sequenceADestructive
Create a sequence. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: hold, name, active, repeat, +10 more.
create_sequence_emailCreate a sequence emailCDestructive
Create a sequence email. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: sequence_id (required), account, confirm, content, +10 more.
create_snippetCreate a snippetADestructive
Create a snippet. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: account, confirm.
create_subscriberCreate a subscriberBDestructive
Create a subscriber. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: state, fields, account, confirm, +4 more.
create_tagCreate a tagC
Create a tag. Changes account configuration.
Inputs: name, account, payload, payload_file.
create_webhookCreate a webhookADestructive
Create a webhook. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: event, account, confirm, payload, +2 more.
create_webhook_endpointCreate a webhook endpointADestructive
Create a webhook endpoint. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: secret_name (required), url, name, events, +5 more.
delete_broadcastDelete a broadcastADestructive
Delete a broadcast. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: broadcast_id (required), account, confirm.
delete_custom_fieldDelete custom fieldADestructive
Delete custom field. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: custom_field_id (required), account, confirm.
delete_sequenceDelete a sequenceADestructive
Delete a sequence. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: sequence_id (required), account, confirm.
delete_sequence_emailDelete a sequence emailADestructive
Delete a sequence email. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: email_id (required), sequence_id (required), account, confirm.
delete_subscriber_locationDelete a subscriber's locationADestructive
Delete a subscriber's location. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: subscriber_id (required), account, confirm.
delete_webhookDelete a webhookADestructive
Delete a webhook. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: webhook_id (required), account, confirm.
delete_webhook_endpointDelete a webhook endpointADestructive
Delete a webhook endpoint. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: webhook_endpoint_id (required), account, confirm.
filter_subscribersFilter subscribers by engagement, sign-up date, state, and tagsCRead-onlyIdempotent
Filter subscribers by engagement, sign-up date, state, and tags. Reads account data.
Inputs: all, account, include, payload, +4 more.
get_accountGet current accountCRead-onlyIdempotent
Get current account. Reads account data.
Inputs: account.
get_broadcastGet a broadcastCRead-onlyIdempotent
Get a broadcast. Reads account data.
Inputs: broadcast_id (required), account.
get_broadcast_clicksGet link clicks for a broadcastBRead-onlyIdempotent
Get link clicks for a broadcast. Reads account data.
Inputs: broadcast_id (required), account.
get_broadcast_statsGet stats for a broadcastCRead-onlyIdempotent
Get stats for a broadcast. Reads account data.
Inputs: broadcast_id (required), account.
get_creator_profileGet Creator ProfileCRead-onlyIdempotent
Get Creator Profile. Reads account data.
Inputs: account.
get_email_statsGet email statsCRead-onlyIdempotent
Get email stats. Reads account data.
Inputs: account.
get_growth_statsGet growth statsCRead-onlyIdempotent
Get growth stats. Reads account data.
Inputs: ending, account, starting.
get_postGet a postCRead-onlyIdempotent
Get a post. Reads account data.
Inputs: post_id (required), account.
get_purchaseGet a purchaseARead-onlyIdempotent
Get a purchase. Reads account data. Requires OAuth; API keys are not supported for this endpoint.
Inputs: purchase_id (required), account.
get_sequenceGet a sequenceCRead-onlyIdempotent
Get a sequence. Reads account data.
Inputs: sequence_id (required), account, include.
get_sequence_emailGet a sequence emailCRead-onlyIdempotent
Get a sequence email. Reads account data.
Inputs: email_id (required), sequence_id (required), account, include.
get_snippetGet a snippetCRead-onlyIdempotent
Get a snippet. Reads account data.
Inputs: snippet_id (required), account.
get_subscriberGet a subscriberCRead-onlyIdempotent
Get a subscriber. Reads account data.
Inputs: subscriber_id (required), account.
get_subscriber_statsList stats for a subscriberCRead-onlyIdempotent
List stats for a subscriber. Reads account data.
Inputs: subscriber_id (required), account, email_sent_after, email_sent_before.
get_webhook_endpointGet a webhook endpointBRead-onlyIdempotent
Get a webhook endpoint. Reads account data. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: webhook_endpoint_id (required), account.
list_accountsList configured accountsARead-onlyIdempotent
List private account labels and configured auth methods, without returning credentials or token-file paths. Does not contact Kit.
Inputs: no named parameters.
list_broadcastsList broadcastsCRead-onlyIdempotent
List broadcasts. Reads account data.
Inputs: slim, after, before, status, +7 more.
list_broadcast_statsGet stats for a list of broadcastsCRead-onlyIdempotent
Get stats for a list of broadcasts. Reads account data.
Inputs: after, before, status, account, +6 more.
list_colorsList colorsCRead-onlyIdempotent
List colors. Reads account data.
Inputs: account.
list_custom_fieldsList custom fieldsCRead-onlyIdempotent
List custom fields. Reads account data.
Inputs: after, before, account, per_page, +3 more.
list_email_templatesList email templatesCRead-onlyIdempotent
List email templates. Reads account data.
Inputs: after, before, account, per_page, +3 more.
list_formsList formsCRead-onlyIdempotent
List forms. Reads account data.
Inputs: type, after, before, status, +6 more.
list_postsList postsCRead-onlyIdempotent
List posts. Reads account data.
Inputs: after, before, account, per_page, +4 more.
list_purchasesList purchasesCRead-onlyIdempotent
List purchases. Reads account data. Requires OAuth; API keys are not supported for this endpoint.
Inputs: after, before, account, per_page, +3 more.
list_segmentsList segmentsCRead-onlyIdempotent
List segments. Reads account data.
Inputs: after, before, account, per_page, +3 more.
list_sequence_emailsList sequence emailsCRead-onlyIdempotent
List sequence emails. Reads account data.
Inputs: sequence_id (required), after, before, account, +6 more.
list_sequencesList sequencesCRead-onlyIdempotent
List sequences. Reads account data.
Inputs: after, before, account, include, +4 more.
list_snippetsList snippetsDRead-onlyIdempotent
List snippets. Reads account data.
Inputs: after, before, account, archived, +6 more.
list_subscribersList subscribersCRead-onlyIdempotent
List subscribers. Reads account data.
Inputs: slim, after, before, status, +13 more.
list_subscribers_for_formList subscribers for a formCRead-onlyIdempotent
List subscribers for a form. Reads account data.
Inputs: form_id (required), slim, after, before, +10 more.
list_subscribers_for_sequenceList subscribers for a sequenceCRead-onlyIdempotent
List subscribers for a sequence. Reads account data.
Inputs: sequence_id (required), after, before, status, +9 more.
list_subscribers_for_tagList subscribers for a tagCRead-onlyIdempotent
List subscribers for a tag. Reads account data.
Inputs: tag_id (required), slim, after, before, +10 more.
list_subscriber_tagsList tags for a subscriberCRead-onlyIdempotent
List tags for a subscriber. Reads account data.
Inputs: subscriber_id (required), after, before, account, +4 more.
list_tagsList tagsCRead-onlyIdempotent
List tags. Reads account data.
Inputs: after, before, account, include, +4 more.
list_webhook_endpointsList webhook endpointsBRead-onlyIdempotent
List webhook endpoints. Reads account data. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: after, before, status, account, +4 more.
list_webhooksList webhooksBRead-onlyIdempotent
List webhooks. Reads account data. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: after, before, account, per_page, +3 more.
pin_subscriber_locationPin a subscriber's locationADestructive
Pin a subscriber's location. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: subscriber_id (required), account, confirm, payload, +2 more.
revoke_previous_webhook_secretRevoke the previous webhook endpoint secretADestructive
Revoke the previous webhook endpoint secret. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: webhook_endpoint_id (required), account, confirm.
rotate_webhook_secretRotate a webhook endpoint secretBDestructive
Rotate a webhook endpoint secret. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: secret_name (required), webhook_endpoint_id (required), force, account, +3 more.
search_subscribersFind subscribers by exact emailBRead-onlyIdempotent
Compatibility alias for list_subscribers with a required exact email_address filter.
Inputs: email_address (required), slim, after, before, +13 more.
tag_subscriberTag a subscriber by email addressADestructive
Tag a subscriber by email address. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: tag_id (required), account, confirm, payload, +2 more.
tag_subscriber_by_idTag a subscriberADestructive
Tag a subscriber. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: tag_id (required), subscriber_id (required), account, confirm.
unsubscribeUnsubscribe subscriberADestructive
Unsubscribe subscriber. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: subscriber_id (required), account, confirm.
untag_subscriberRemove tag from subscriberBDestructive
Remove tag from subscriber. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: tag_id (required), subscriber_id (required), account, confirm.
untag_subscriber_by_emailRemove tag from subscriber by email addressADestructive
Remove tag from subscriber by email address. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: tag_id (required), email_address (required), account, confirm.
update_broadcastUpdate a broadcastADestructive
Update a broadcast. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: broadcast_id (required), public, account, confirm, +14 more.
update_colorsUpdate colorsC
Update colors. Changes account configuration.
Inputs: colors, account, payload, payload_file.
update_custom_fieldUpdate a custom fieldC
Update a custom field. Changes account configuration.
Inputs: custom_field_id (required), label, account, payload, +1 more.
update_sequenceUpdate a sequenceADestructive
Update a sequence. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: sequence_id (required), hold, name, active, +11 more.
update_sequence_emailUpdate a sequence emailBDestructive
Update a sequence email. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: email_id (required), sequence_id (required), account, confirm, +11 more.
update_snippetUpdate a snippetADestructive
Update a snippet. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: snippet_id (required), account, confirm.
update_subscriberUpdate a subscriberADestructive
Update a subscriber. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: subscriber_id (required), fields, account, confirm, +4 more.
update_subscriber_locationUpdate a subscriber's pinned locationADestructive
Update a subscriber's pinned location. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Inputs: subscriber_id (required), account, confirm, payload, +2 more.
update_tag_nameUpdate tag nameC
Update tag name. Changes account configuration.
Inputs: tag_id (required), name, account, payload, +1 more.
update_webhook_endpointUpdate a webhook endpointADestructive
Update a webhook endpoint. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true. Webhook response secrets are redacted; new signing secrets are saved only to a private local file.
Inputs: webhook_endpoint_id (required), url, name, events, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 85 tools
Most tools target a distinct resource+action, but create/update/delete_webhook and the *_webhook_endpoint variants are near-duplicates, and list_subscribers/filter_subscribers/search_subscribers overlap. The by_id vs by_email variants are distinguishable via descriptions, keeping ambiguity limited.
All tools use snake_case with a consistent verb_noun pattern (create_broadcast, list_subscribers, update_tag_name), and the bulk_ prefix is applied uniformly. Minor verb-only exceptions like unsubscribe and rotate_webhook_secret do not break the overall pattern.
85 tools is far beyond the 3-15 range for well-scoped servers and imposes heavy selection load on an agent. While many map to real Kit API endpoints, the count is excessive for reliable tool choice.
Coverage spans subscribers, tags, forms, sequences, broadcasts, custom fields, webhooks, purchases, snippets, and stats with mostly full CRUD. Minor gaps exist (e.g., no delete_snippet, read-only posts/email templates/segments), but core workflows are supported.
Maintenance
Related MCP Connectors
Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage subscribers.
Read Buttondown subscribers, emails, analytics and automations; add subscribers; write email drafts.
Read subscribers, groups, campaigns, fields, segments, automations, webhooks; safe additive writes.
Related MCP Servers
- FlicenseAqualityDmaintenanceAn MCP server for the Keila newsletter API that enables management of contacts, campaigns, segments, and senders. It allows users to create, schedule, and send newsletters directly through natural language interactions.17-
- AlicenseAqualityDmaintenanceAn agent-optimized MCP server for Kit.com (formerly ConvertKit) that enables full management of email marketing campaigns, subscribers, and broadcasts. It provides 13 composite tools covering the entire Kit V4 API with built-in rate limiting and formatted responses for efficient AI interaction.1360 npm2MIT
- FlicenseBqualityDmaintenanceEnables management of email campaigns, subscribers, lists, segments, journeys, templates, transactional email, and client/account settings through the Campaign Monitor API via natural language.1001-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with the Mailchimp API for managing campaigns, lists, templates, reports, and automations through natural language.3-