# Senderkit Mcp Messaging Operations

> Send and operate transactional messages — email, SMS, push, or web-push — at runtime through the connected SenderKit MCP server. Use whenever the SenderKit MCP tools (senderkit_*) are available and a user wants to actually send a message (a test or live send, a welcome/OTP/notification message), check delivery or message status, debug a failed or stuck send, look up/draft/regenerate templates, fi…

- **Type:** Skill
- **Install:** `agentstack add skill-senderkit-senderkit-skills-senderkit-mcp-messaging-operations`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [senderkit](https://agentstack.voostack.com/s/senderkit)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [senderkit](https://github.com/senderkit)
- **Source:** https://github.com/senderkit/senderkit-skills/tree/main/skills/senderkit-mcp-messaging-operations
- **Website:** https://www.senderkit.com

## Install

```sh
agentstack add skill-senderkit-senderkit-skills-senderkit-mcp-messaging-operations
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SenderKit MCP messaging operations

Use this skill when SenderKit is connected as an MCP server and the user wants you to operate SenderKit through tool calls. The documented MCP surface is small and tool-only: ten tools, all prefixed with `senderkit_`.

This skill **operates SenderKit at runtime via MCP** and does not change application code. To add or wire SenderKit into a codebase (SDK/REST integration, migrating a provider), use the `senderkit-integration` skill instead.

## Source of truth and drift

The connected MCP server's advertised tool list is the runtime source of truth, not this document.

- The tool map below mirrors the published surface at `https://docs.senderkit.com/mcp/tools` (ten tools). Treat that page as canonical when the two disagree, and prefer the live tool list over both.
- If the connected server advertises an additional `senderkit_*` tool that is not listed here, you may use it after reading its tool schema. Do not assume a tool exists because it appears here; if a listed tool is absent at runtime, skip it and tell the user.
- Older or restricted servers may expose fewer tools (for example without the template-authoring tools). Confirm a tool is present before relying on it.

## Required workflow

1. Check context before acting.
   - Call `senderkit_context` before any send or cancellation.
   - Tell the user whether the active connection is `test` or `live`.
   - In `live` mode, do not send or cancel unless the user's request clearly authorizes that real-world action.

2. Prefer template sends.
   - Use `senderkit_send` when the user names or implies an existing template.
   - If the template slug is uncertain, call `senderkit_templates_list`.
   - Before sending with an unfamiliar slug, call `senderkit_templates_get` to inspect the template's channel, status, and published version.
   - Pass template variables in `vars` as a JSON object.
   - Use `version` only when the user asks to pin a specific template version or the workflow requires a known version.

3. Use raw sends narrowly.
   - Use `senderkit_send_raw` only for explicit one-off inline content.
   - For email raw sends, provide `subject` and `html`; include `text` when practical.
   - For SMS, push, and web-push raw sends, provide the channel-specific required body/title fields.
   - Set `interpolate: true` only when the user wants server-side variable substitution over the inline content.

4. Make sends traceable and retry-safe.
   - Include `idempotencyKey` for retryable sends, scheduled sends, or any send that might be repeated by an agent or job.
   - Use stable keys such as `//`.
   - Include scalar `metadata` values for later filtering, such as flow, internal entity ID, tenant/workspace ID, or reason.
   - Do not put secrets, message bodies, or unnecessary PII in metadata.

5. Inspect messages for status and debugging.
   - Use `senderkit_messages_list` for recent sends, filtered searches, failures, template-specific history, channel-specific history, or metadata lookups.
   - Use `senderkit_messages_get` when the user provides a message ID or when a list result needs full detail.
   - Explain that accepted sends are asynchronous; a returned message ID is not proof of delivery.
   - When reporting failures, include the status, relevant provider response or event timeline if returned, and the next concrete check.

6. Cancel only pending messages.
   - Call `senderkit_context` first.
   - Use `senderkit_messages_get` if the current status is unknown.
   - Use `senderkit_cancel_message` only for messages that are `scheduled` or `queued`.
   - If the status is later than queued, explain that delivery has already started or reached a terminal state and is not reversible through MCP.

## Authoring templates (drafts only)

`senderkit_templates_create` and `senderkit_templates_regenerate` author AI-composed templates. Both produce **drafts** — they never send and never publish.

- `senderkit_templates_create` - generate a new draft from a plain-language `brief` for a given `channel`. Required: `channel`, `brief`. Optional: `slug` (auto-derived from the brief if omitted; a numeric suffix is added on collision) and `description`. It returns a deep link to review the draft in the editor; the template is not usable for live sends until a human publishes it. May return `template_limit_reached` if the workspace template cap is hit.
- `senderkit_templates_regenerate` - replace a **draft's** content from a new `brief`. Required: `slug`, `brief`. This discards any manual edits made in the editor and only affects drafts (published templates are untouched). Confirm the slug is a draft with `senderkit_templates_get` first, and warn the user that manual edits will be lost before calling.
- After creating or regenerating, tell the user the draft must be reviewed and published in the dashboard before it can be sent — especially in `live` mode.

## Tool map

- `senderkit_context` - confirm workspace and `test` or `live` mode.
- `senderkit_send` - send a registered template to one recipient.
- `senderkit_send_raw` - send inline email, SMS, push, or web-push content to one recipient.
- `senderkit_templates_list` - discover available templates.
- `senderkit_templates_get` - inspect one template by slug.
- `senderkit_templates_create` - generate a new draft template from a brief (does not publish or send).
- `senderkit_templates_regenerate` - regenerate a draft template's content from a new brief (drafts only; discards manual edits).
- `senderkit_messages_list` - list and filter message history.
- `senderkit_messages_get` - inspect one message by ID.
- `senderkit_cancel_message` - cancel a still-pending scheduled or queued message.

## Boundaries

The surface can author **draft** templates (`senderkit_templates_create`, `senderkit_templates_regenerate`) but cannot publish them, edit a published version's content, or render templates over MCP — publishing and content editing happen in the dashboard. Do not claim MCP support for webhooks, suppressions, contacts, campaigns, analytics, provider setup, or domain configuration unless the active MCP server exposes tools for those operations.

When a user asks for an unsupported operation, explain the supported MCP alternatives: discover/inspect templates, draft a new template, send templated or raw messages, inspect message history, or cancel pending messages.

## Reference

Read `references/sources.md` when you need the canonical SenderKit MCP documentation links used to build this skill.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [senderkit](https://github.com/senderkit)
- **Source:** [senderkit/senderkit-skills](https://github.com/senderkit/senderkit-skills)
- **License:** MIT
- **Homepage:** https://www.senderkit.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-senderkit-senderkit-skills-senderkit-mcp-messaging-operations
- Seller: https://agentstack.voostack.com/s/senderkit
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.