SenderKit Skills — Notificações Transacionais para Agentes IA
senderkit/senderkit-skills
Notificações transacionais multi-canal para agentes IA, sem lock-in
Ver no GitHubMCP server que permite a agentes IA (Claude Code, Cursor, etc.) adicionar email transacional, SMS, push e web-push a aplicações sem travamento de vendor. Compatível com múltiplos provedores (Resend, SendGrid, Twilio, FCM, etc.) através de um único skill portável. Inclui operações de envio em runtime, inspeção de status e autenticação de domínio (SPF/DKIM/DMARC).
Instalação
npx convez-ai senderkit/senderkit-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Adicionar emails de boas-vindas e recuperação de senha via agente IA
- Implementar SMS OTP e códigos de verificação automaticamente
- Enviar notificações push web-push diretamente do agent
- Migrar ou rotear entre provedores de email/SMS sem refatoração
- Diagnosticar falhas de entrega e configurar autenticação de domínio
Veredito

Solução robusta e verificada (HOL Guard 95/130, OpenSSF Scorecard) que resolve um problema real: adicionar notificações transacionais sem lock-in de vendor através de agentes IA. Especialmente útil para desenvolvedores que querem delegar integração de comunicação ao seu coding agent, mantendo portabilidade entre provedores.
README
A tradução para o português deste README ainda está na fila.
SenderKit Skills
Add transactional email, SMS, push, and web-push notifications to any app — straight from your AI coding agent. Portable AI-agent skills for SenderKit, packaged as a plugin for Claude Code, OpenAI Codex, Cursor, opencode, and other Agent Skills-compatible coding assistants.
SenderKit sends email, SMS, push, and web-push directly, and can also route through providers like Resend, SendGrid, Postmark, Mailgun, SES, Twilio, FCM, APNs, and Expo — so your app isn't locked into one vendor. These skills let an agent wire SenderKit into your codebase and operate it at runtime over MCP.
This repository contains one senderkit plugin with three related skills:
senderkit-integration- add SenderKit to an app, or replace/route an existing email, SMS, or push provider through it.senderkit-mcp-messaging-operations- send and inspect messages at runtime through the SenderKit MCP connector.senderkit-email-deliverability- authenticate a sending domain (SPF/DKIM/DMARC) so email reaches the inbox.
What can I ask?
You don't need to name SenderKit — these skills activate on everyday messaging requests. Examples:
| You ask | Skill that helps |
|---|---|
| "Add a welcome email when a user signs up" | senderkit-integration |
| "Set up SMS OTP / verification codes" | senderkit-integration |
| "Add push notifications to this project" | senderkit-integration |
| "Send password-reset and receipt emails" | senderkit-integration |
| "Switch my email provider to SenderKit (or route through it, no lock-in)" | senderkit-integration |
| "Send a test email and check its delivery status" | senderkit-mcp-messaging-operations |
| "Why did this message fail? Cancel that scheduled send" | senderkit-mcp-messaging-operations |
| "Why are my emails going to spam? Set up DKIM/SPF/DMARC" | senderkit-email-deliverability |
Rule of thumb: integration writes SenderKit into your code; messaging operations sends and inspects messages at runtime via MCP.
Install
This repo ships per-platform metadata — Claude Code (.claude-plugin/), OpenAI Codex (.codex-plugin/), Cursor (.cursor-plugin/), and opencode (opencode.json) — and the authored skills under ./skills/. Pick your agent below; each path ends with a quick check so you know it worked.
Claude Code
From the marketplace (recommended):
/plugin marketplace add senderkit/senderkit-skills
/plugin install senderkit@senderkit-skills
From a local checkout (for development):
claude --plugin-dir .
This loads both skills and the SenderKit MCP server from the repo's .mcp.json (OAuth, no key stored). Run /mcp, sign in, and pick a workspace and test/live mode.
Check it works: run /mcp — the senderkit server should be connected — or ask "Use senderkit-integration to add a welcome email."
OpenAI Codex
"ChatGPT" support means Codex, OpenAI's coding agent (CLI / IDE extension / app). The ChatGPT chat app does not load skills.
Codex discovers skills from .agents/skills/ directories. Vendor the skills into your user scope (available in every repo) or a single repo's scope:
git clone https://github.com/senderkit/senderkit-skills.git
mkdir -p ~/.agents/skills
cp -R senderkit-skills/skills/senderkit-integration ~/.agents/skills/
cp -R senderkit-skills/skills/senderkit-mcp-messaging-operations ~/.agents/skills/
# repo-scoped instead? copy into <your-repo>/.agents/skills/
Restart Codex so it picks them up. Connect MCP: the bundled .codex-plugin/mcp.json points Codex at https://mcp.senderkit.com over OAuth — run codex mcp login senderkit to sign in (no key stored). Prefer an API key? See API key (optional) below, or run senderkit mcp install --client codex.
Check it works: run /skills (the SenderKit skills should be listed) or invoke one explicitly with $senderkit-integration.
Distributing the full plugin (skills + MCP) to a team? Publish this repo as a Codex marketplace and install via codex → /plugins. See https://developers.openai.com/codex/plugins/build.
Cursor
For an individual install, load this repo as a local plugin:
git clone https://github.com/senderkit/senderkit-skills.git
ln -s "$(pwd)/senderkit-skills" ~/.cursor/plugins/local/senderkit
Reload Cursor (Developer: Reload Window). Skills show up under Settings → Rules & Skills and can be invoked with /senderkit-integration. Connect MCP: the bundled .cursor-plugin/plugin.json points Cursor at https://mcp.senderkit.com over OAuth — open Settings → MCP, toggle the server on, and sign in (no key stored). Prefer an API key? See API key (optional) below, or run senderkit mcp install --client cursor.
For teams, import this GitHub repo as a Team Marketplace (Dashboard → Settings → Plugins; Teams/Enterprise plans). See https://cursor.com/docs/plugins.
Check it works: type /senderkit-integration in chat, or ask "Send a test email and check its status via SenderKit MCP."
opencode
opencode auto-discovers Agent Skills (one folder per skill, SKILL.md inside) from ~/.config/opencode/skills/ (user scope, every repo) or .opencode/skills/ (repo scope) — and also reads .claude/skills/ and .agents/skills/, so the same skill folders work unchanged. Vendor them in:
git clone https://github.com/senderkit/senderkit-skills.git
mkdir -p ~/.config/opencode/skills
cp -R senderkit-skills/skills/senderkit-integration ~/.config/opencode/skills/
cp -R senderkit-skills/skills/senderkit-mcp-messaging-operations ~/.config/opencode/skills/
cp -R senderkit-skills/skills/senderkit-email-deliverability ~/.config/opencode/skills/
# repo-scoped instead? copy into <your-repo>/.opencode/skills/
Connect MCP: merge the mcp block from this repo's opencode.json into your own opencode.json (project root or ~/.config/opencode/opencode.json). It points opencode at https://mcp.senderkit.com as a "type": "remote" server with no auth, so opencode runs the OAuth flow on first use (no key stored). Sign in with opencode mcp auth senderkit. Prefer an API key? See API key (optional) below.
Check it works: run opencode mcp list (the senderkit server should be listed) or ask "Use senderkit-integration to add a welcome email."
Connect the SenderKit MCP server
Installing the plugin/skills gives you the senderkit_* MCP tools. Auth differs per client:
- Claude Code — OAuth via the repo's
.mcp.json. Run/mcp, sign in, pick a workspace and test/live mode. No API key is stored in the repo. - Cursor — OAuth via the bundled
.cursor-plugin/plugin.json. Toggle the server under Settings → MCP and sign in. No API key is stored in the repo. - Codex — OAuth via the bundled
.codex-plugin/mcp.json. Runcodex mcp login senderkitto sign in. No API key is stored in the repo. - opencode — OAuth via the bundled
opencode.json("type": "remote",urlonly). Runopencode mcp auth senderkitto sign in. No API key is stored in the repo.
API key (optional)
Every shipped manifest is OAuth-only, so no credential is committed. mcp.senderkit.com also accepts an API key if you'd rather skip OAuth — set SENDERKIT_API_KEY (the sk_live_ / sk_test_ prefix selects mode) and add it in your own MCP config:
- Cursor / Claude Code / Windsurf — add an
Authorizationheader, e.g. in~/.cursor/mcp.json:{ "mcpServers": { "senderkit": { "url": "https://mcp.senderkit.com", "headers": { "Authorization": "Bearer ${env:SENDERKIT_API_KEY}" } } } } - Codex — add
"bearer_token_env_var": "SENDERKIT_API_KEY"to thesenderkitserver in your own.codex-plugin/mcp.json(or~/.codex/config.toml). - opencode — in your own
opencode.json, set"oauth": falseon thesenderkitserver and add a header:"headers": { "Authorization": "Bearer {env:SENDERKIT_API_KEY}" }(opencode interpolates{env:VAR}).
Other clients (Windsurf, VS Code, Zed, Claude Desktop) and manual config: see skills/senderkit-mcp-messaging-operations/README.md and https://docs.senderkit.com/mcp/installation. The SenderKit CLI can also write the config for you: senderkit mcp install --client cursor (or codex, claude-code, vscode, zed, all).
Skills
SenderKit Integration
Use senderkit-integration when an agent needs to modify an application: detect the stack, add SenderKit, migrate provider calls, preserve existing notification behavior, and verify the integration before live traffic.
Suggested prompt:
Use $senderkit-integration to add SenderKit transactional messaging to this project.
Claude Code plugin command:
/senderkit:senderkit-integration
SenderKit MCP Messaging Operations
Use senderkit-mcp-messaging-operations when an agent has access to the SenderKit MCP server and needs to send messages, inspect templates, check message status, or cancel pending sends through MCP tool calls.
Suggested prompt:
Use $senderkit-mcp-messaging-operations to send a test message and verify its status through SenderKit MCP.
Claude Code plugin command:
/senderkit:senderkit-mcp-messaging-operations
SenderKit Email Deliverability
Use senderkit-email-deliverability when transactional email needs to be authenticated to reach the inbox: diagnose current SPF/DKIM/DMARC with dig, generate the exact records to add, point to the SenderKit dashboard for issued values, and verify publication.
Suggested prompt:
Use $senderkit-email-deliverability to diagnose and fix SPF, DKIM, and DMARC for my sending domain.
Claude Code plugin command:
/senderkit:senderkit-email-deliverability
Repository layout
senderkit-skills/
|-- .claude-plugin/
| |-- marketplace.json
| `-- plugin.json
|-- .codex-plugin/
| |-- mcp.json
| `-- plugin.json
|-- .cursor-plugin/
| |-- marketplace.json
| `-- plugin.json
|-- .github/
| |-- dependabot.yml
| `-- workflows/
| |-- validate.yml
| `-- hol-scanner.yml
|-- .codexignore
|-- .mcp.json
|-- opencode.json
|-- AGENTS.md
|-- LICENSE
|-- README.md
|-- SECURITY.md
|-- llms.txt
`-- skills/
|-- senderkit-email-deliverability/
|-- senderkit-integration/
`-- senderkit-mcp-messaging-operations/
Official docs
- SenderKit MCP overview:
https://docs.senderkit.com/mcp/overview - SenderKit MCP tools:
https://docs.senderkit.com/mcp/tools - SenderKit OpenAPI:
https://www.senderkit.com/openapi.yaml