marketing
SparkPost CLI for Headless Automation
Use the SparkPost CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write API key auth
SparkPost 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 SparkPost CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# SparkPost CLI for Headless Automation
kosmokrator integrations:configure spark-post --set api_key="$SPARK_POST_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call spark-post.spark_post_list_sending_domains '{"limit":1}' --json Discovery Before Execution
Agents and scripts can inspect SparkPost docs and schemas before choosing a function.
kosmo integrations:docs spark-post --json
kosmo integrations:docs spark-post.spark_post_list_sending_domains --json
kosmo integrations:schema spark-post.spark_post_list_sending_domains --json
kosmo integrations:search "SparkPost" --json
kosmo integrations:list --json Useful SparkPost CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
spark-post.spark_post_list_sending_domains | Read | limit | List sending domains configured in SparkPost. Returns domain names along with verification and DKIM signing status. |
spark-post.spark_post_get_sending_domain | Read | domain | Get details for a specific sending domain in SparkPost. Returns verification status, DKIM signing info, and SPF records. |
spark-post.spark_post_list_templates | Read | limit, offset | List email templates in SparkPost. Returns template IDs, names, and published status. |
spark-post.spark_post_get_template | Read | id, draft | Get a specific email template by ID from SparkPost. Can retrieve the draft or published version. |
spark-post.spark_post_send_transmission | Write | content, recipients | Send an email transmission via SparkPost. Provide sender address, subject, content (HTML and/or text), and a list of recipients. |
spark-post.spark_post_list_webhooks | Read | limit, offset | List webhooks configured in SparkPost. Returns webhook IDs, target URLs, and subscribed event types. |
spark-post.spark_post_get_current_user | Read | none | Get current SparkPost account information. Returns account status, subscription plan, and usage 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.