Can I use Sendy as a CLI?

Yes. KosmoKrator exposes a Sendy CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Sendy through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Sendy tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Sendy credentials stored?

Sendy credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Sendy MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

other

Sendy CLI for AI Agents

Use the Sendy CLI from KosmoKrator to call Sendy tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

5 functions 2 read 3 write API key auth

Submit Sendy feedback View package source

Sendy CLI Setup

Sendy can be configured headlessly with `kosmokrator integrations:configure sendy`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure sendy --set api_key="$SENDY_API_KEY" --set hostname="$SENDY_HOSTNAME" --enable --read allow --write ask --json
kosmokrator integrations:doctor sendy --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`SENDY_API_KEY`	Secret `secret`	yes	API Key
`hostname`	`SENDY_HOSTNAME`	URL `url`	yes	Sendy Hostname

Call Sendy Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call sendy.sendy_subscribe '{
  "list": "example_list",
  "email": "example_email",
  "name": "example_name"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:sendy sendy_subscribe '{
  "list": "example_list",
  "email": "example_email",
  "name": "example_name"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs sendy --json
kosmo integrations:docs sendy.sendy_subscribe --json
kosmo integrations:schema sendy.sendy_subscribe --json
kosmo integrations:search "Sendy" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Sendy.

`sendy.sendy_subscribe`

Write write

Subscribe an email address to a Sendy mailing list. Optionally provide a name and custom fields.

Parameters: list, email, name

Generic CLI call

kosmo integrations:call sendy.sendy_subscribe '{"list":"example_list","email":"example_email","name":"example_name"}' --json

Provider shortcut

kosmo integrations:sendy sendy_subscribe '{"list":"example_list","email":"example_email","name":"example_name"}' --json

`sendy.sendy_unsubscribe`

Write write

Unsubscribe an email address from a Sendy mailing list.

Parameters: list, email

Generic CLI call

kosmo integrations:call sendy.sendy_unsubscribe '{"list":"example_list","email":"example_email"}' --json

Provider shortcut

kosmo integrations:sendy sendy_unsubscribe '{"list":"example_list","email":"example_email"}' --json

`sendy.sendy_list_subscribers`

Read read

Get the total number of subscribers for a Sendy mailing list.

Parameters: list_id

Generic CLI call

kosmo integrations:call sendy.sendy_list_subscribers '{"list_id":"example_list_id"}' --json

Provider shortcut

kosmo integrations:sendy sendy_list_subscribers '{"list_id":"example_list_id"}' --json

`sendy.sendy_create_campaign`

Write write

Create a new email campaign in Sendy. You can create a draft or send immediately. Requires a list ID, subject, HTML content, and sender details.

Parameters: from_name, from_email, reply_to, title, subject, html_text, list_ids, plain_text, send_campaign, brand_id, query_string

Generic CLI call

kosmo integrations:call sendy.sendy_create_campaign '{"from_name":"example_from_name","from_email":"example_from_email","reply_to":"example_reply_to","title":"example_title","subject":"example_subject","html_text":"example_html_text","list_ids":"example_list_ids","plain_text":"example_plain_text"}' --json

Provider shortcut

kosmo integrations:sendy sendy_create_campaign '{"from_name":"example_from_name","from_email":"example_from_email","reply_to":"example_reply_to","title":"example_title","subject":"example_subject","html_text":"example_html_text","list_ids":"example_list_ids","plain_text":"example_plain_text"}' --json

`sendy.sendy_get_current_user`

Read read

Get the current brand/account information from Sendy. Useful for verifying credentials and retrieving brand details.

Parameters: none

Generic CLI call

kosmo integrations:call sendy.sendy_get_current_user '{}' --json

Provider shortcut

kosmo integrations:sendy sendy_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`sendy.sendy_subscribe`

Subscribe an email address to a Sendy mailing list. Optionally provide a name and custom fields.

Operation: Write write
Schema command: kosmo integrations:schema sendy.sendy_subscribe --json

Parameter	Type	Required	Description
`list`	string	yes	The list ID to subscribe to.
`email`	string	yes	The subscriber's email address.
`name`	string	no	The subscriber's name (optional).

`sendy.sendy_unsubscribe`

Unsubscribe an email address from a Sendy mailing list.

Operation: Write write
Schema command: kosmo integrations:schema sendy.sendy_unsubscribe --json

Parameter	Type	Required	Description
`list`	string	yes	The list ID to unsubscribe from.
`email`	string	yes	The subscriber's email address.

`sendy.sendy_list_subscribers`

Get the total number of subscribers for a Sendy mailing list.

Operation: Read read
Schema command: kosmo integrations:schema sendy.sendy_list_subscribers --json

Parameter	Type	Required	Description
`list_id`	string	yes	The list ID to query subscriber count for.

`sendy.sendy_create_campaign`

Create a new email campaign in Sendy. You can create a draft or send immediately. Requires a list ID, subject, HTML content, and sender details.

Operation: Write write
Schema command: kosmo integrations:schema sendy.sendy_create_campaign --json

Parameter	Type	Required	Description
`from_name`	string	yes	Sender name (e.g., "Acme Corp").
`from_email`	string	yes	Sender email address (e.g., "[email protected]").
`reply_to`	string	yes	Reply-to email address.
`title`	string	yes	Internal campaign title (for your reference).
`subject`	string	yes	Email subject line.
`html_text`	string	yes	HTML content of the email.
`list_ids`	string	yes	Comma-separated list IDs to send to.
`plain_text`	string	no	Plain text version of the email. Auto-generated if omitted.
`send_campaign`	integer	no	Set to 1 to send immediately, 0 or omit to save as draft.
`brand_id`	string	no	Brand ID (required for multi-brand setups).
`query_string`	string	no	UTM query string appended to links (e.g., "utm_source=sendy&utm_medium=email").

`sendy.sendy_get_current_user`

Get the current brand/account information from Sendy. Useful for verifying credentials and retrieving brand details.

Operation: Read read
Schema command: kosmo integrations:schema sendy.sendy_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.