ConvertKit CLI for Headless Automation
Use the ConvertKit CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write API key auth
ConvertKit CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The ConvertKit CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# ConvertKit CLI for Headless Automation
kosmokrator integrations:configure convertkit --set api_key="$CONVERTKIT_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call convertkit.convertkit_list_subscribers '{"page":1,"per_page":1,"from":"example_from","to":"example_to"}' --json Discovery Before Execution
Agents and scripts can inspect ConvertKit docs and schemas before choosing a function.
kosmo integrations:docs convertkit --json
kosmo integrations:docs convertkit.convertkit_list_subscribers --json
kosmo integrations:schema convertkit.convertkit_list_subscribers --json
kosmo integrations:search "ConvertKit" --json
kosmo integrations:list --json Useful ConvertKit CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
convertkit.convertkit_list_subscribers | Read | page, per_page, from, to | List subscribers from your ConvertKit account. Supports pagination and date range filtering. |
convertkit.convertkit_get_subscriber | Read | subscriber_id | Get details for a single ConvertKit subscriber by their subscriber ID. |
convertkit.convertkit_list_forms | Read | none | List all forms in your ConvertKit account. Returns form IDs and names. |
convertkit.convertkit_list_tags | Read | none | List all tags in your ConvertKit account. Returns tag IDs and names. |
convertkit.convertkit_create_tag | Write | name | Create a new tag in ConvertKit. |
convertkit.convertkit_list_broadcasts | Read | page, per_page | List broadcasts (email blasts) from your ConvertKit account. Supports pagination. |
convertkit.convertkit_get_current_user | Read | none | Get the authenticated ConvertKit account information, including account name, email, and plan details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.