# Kit — how to use (mcp.ai)

Kit is a platform that allows creators to automate tasks and developers to build apps for the Kit App Store.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kit?ms=1781541720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kit_add_subscriber_to_form`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kit/add/subscriber/to/form` — Tool to add a subscriber to a specific form by id. use after confirming form and subscriber ids.
  - body: { id: integer, form_id: integer, referrer?: string }
- `POST https://api.mcp.ai/api/kit/create/custom/field` — Tool to create a new custom field for subscriber data. use when you need to store extra attributes for subscribers.
  - body: { label: string }
- `POST https://api.mcp.ai/api/kit/create/tag` — Tool to create a new tag in the account. use when you need a custom label to segment subscribers. use after confirming tag uniqueness to avoid duplicates. example: "create a tag called 'vip' for premi
  - body: { name: string }
- `POST https://api.mcp.ai/api/kit/create/webhook` — Tool to create a new webhook subscription. use when you need subscriber or purchase event notifications.
  - body: { event: object, target_url: string }
- `POST https://api.mcp.ai/api/kit/delete/broadcast` — Tool to delete a specific broadcast. use when you need to permanently remove a broadcast by id (after confirming the id). example prompt: "delete broadcast with id 123"
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/delete/custom/field` — Tool to delete a specific custom field. use after confirming the custom field id is correct. deletes the field permanently.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/delete/subscriber` — Tool to delete (unsubscribe) a subscriber by id. use when you need to remove a subscriber from all sequences and forms after confirming the subscriber exists.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/delete/tag` — Tool to delete a tag by id. use when you need to remove obsolete or incorrect tags after confirming the tag exists.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/delete/webhook` — Tool to delete a webhook by id. use when you want to permanently remove a webhook after confirming its id.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/get/account` — Tool to retrieve current account information. use after validating api key to fetch account id, plan type, primary email, and timezone details.
- `POST https://api.mcp.ai/api/kit/get/account/colors` — Tool to retrieve list of colors associated with the account. use after confirming authentication to fetch account-specific color palette.
- `POST https://api.mcp.ai/api/kit/get/broadcast` — Tool to retrieve details of a specific broadcast by id. use when you have a valid broadcast id and need its metadata.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/get/broadcast/stats` — Tool to retrieve statistics for a specific broadcast by id. use after a broadcast has been sent to monitor performance.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/kit/get/creator/profile` — Tool to retrieve the creator profile information for the account. use when you need creator metadata (bio, avatar, social links) before publishing or customizing content.
- `POST https://api.mcp.ai/api/kit/get/email/stats` — Tool to retrieve email statistics for the account. use after confirming authentication to fetch metrics on emails (sent, opened, clicked) over the last 90 days.
- `POST https://api.mcp.ai/api/kit/list/broadcasts` — Tool to retrieve a paginated list of all broadcasts. use when you need to enumerate or review broadcast summaries with cursor-based pagination.
  - body: { after?: string, before?: string, per_page?: integer, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/custom/fields` — Tool to retrieve a paginated list of custom fields. use after confirming you need to enumerate or inspect all custom fields with cursor-based pagination.
  - body: { after?: string, before?: string, per_page?: integer, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/forms` — Tool to list all forms. use when you need to fetch forms with optional filters and pagination.
  - body: { type?: string, after?: string, before?: string, status?: string, per_page?: integer, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/segments` — Tool to retrieve a paginated list of segments. use when you need to enumerate segments with cursor-based pagination for further processing or display.
  - body: { after?: string, before?: string, per_page?: integer, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/sequences` — Tool to retrieve a paginated list of all sequences. use when you need to enumerate sequences with pagination for further processing or display.
  - body: { after?: string, before?: string, per_page?: integer, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/subscribers` — Tool to retrieve a list of subscribers. use when you need to fetch subscriber records with optional filtering, sorting, and pagination.
  - body: { after?: string, before?: string, status?: string, per_page?: integer, sort_field?: string, sort_order?: string, created_after?: string, email_address?: string, updated_after?: string, created_before?: string, updated_before?: string, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/subscribers/for/form` — Tool to retrieve subscribers for a specific form by id. use when you need to page or filter subscribers of a form.
  - body: { after?: string, before?: string, status?: string, form_id: integer, per_page?: integer, added_after?: string, added_before?: string, created_after?: string, created_before?: string, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/tag/subscribers` — Tool to retrieve subscribers for a specific tag. use after confirming the tag id when you need to list subscribers associated with a tag.
  - body: { after?: string, before?: string, status?: string, tag_id: integer, per_page?: integer, tagged_after?: string, created_after?: string, tagged_before?: string, created_before?: string, include_total_count?: string }
- `POST https://api.mcp.ai/api/kit/list/tags` — Tool to retrieve a list of all tags. use when you need a complete inventory of tags for the kit account.
- `POST https://api.mcp.ai/api/kit/tag/subscriber` — Tool to associate a subscriber with a specific tag by id. use after confirming tag and subscriber ids when tagging a subscriber.
  - body: { tag_id: integer, subscriber_id: integer }
- `POST https://api.mcp.ai/api/kit/tag/subscriber/by/email` — Tool to associate a subscriber with a tag using an email address. use when you have a tag id and subscriber email ready. use after confirming both resources exist.
  - body: { tag_id: integer, email_address: string }
- `POST https://api.mcp.ai/api/kit/update/account/colors` — Tool to update the list of colors for the account. use when customizing your kit account's color palette for broadcasts and templates.
  - body: { colors: string[] }
- `POST https://api.mcp.ai/api/kit/update/custom/field` — Tool to update a custom field's label. use after listing or retrieving custom fields and confirming the field id to rename.
  - body: { id: integer, label: string }
- `POST https://api.mcp.ai/api/kit/update/tag` — Tool to update a tag's name by id. use after retrieving tag id and confirming the new name.
  - body: { id: integer, name: string }

## More
- Page: https://mcp.ai/kit
- Agent spec (llms.txt): https://mcp.ai/kit/llms.txt
- Postman collection: https://mcp.ai/kit/postman.json