mcpField
A
aws-ses

aws-ses

github.com/amazon-sesCloud & DevOps8100 installsUpdated 22w ago
Repository

About aws-ses

A skill for developers using Amazon SES V2 to send email and manage identity verification, configuration, and deliverability. It includes executable scripts for templated and bulk sending, address validation, and tenant setup.

Key features

  1. 01Send email through the V2 API or SMTP
  2. 02Send templated and bulk email
  3. 03Verify domains and email identities
  4. 04Configure event tracking and suppression lists
  5. 05Validate addresses and monitor deliverability
  6. 06Set up tenants and associated resources

Use cases

  1. 01Send password resets or order notices from an application
  2. 02Build a multi-tenant email platform
  3. 03Migrate email services and configure authentication
  4. 04Check email addresses and sender reputation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/amazon-ses/skills --skill aws-ses

After installing, type/aws-sesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
java-examples.md
references/configuration/
configuration-sets.md
suppression-lists.md
references/deliverability/
dedicated-ips.md
reputation-management.md
references/identity/
verify-domain-identity.md
references/quickstart/
send-first-email.md
references/sending/
send-bulk-email.md
send-with-sdk.md
send-with-smtp.md
references/tenants/
tenant-setup.md
references/troubleshooting/
common-issues.md
references/validation/
email-validation.md

Details

From the project README

Amazon Simple Email Service (SES)

Amazon SES is a cloud-based email sending and receiving service. It provides APIs and SMTP access for transactional, marketing, and notification email, designed to scale with your needs.

Key Capabilities

  • Email Sending — V2 API (sesv2), SMTP interface, templated and bulk sends
  • Email Receiving — For inbound email processing, see the Mail Manager Agent Context Pack (coming soon)
  • Identity Management — Domain and email verification with DKIM, SPF, DMARC, BIMI
  • Tenants — Isolated workloads with per-tenant reputation monitoring and enforcement
  • Configuration Sets — Event tracking, suppression management, IP pool assignment
  • Email Validation — Validate addresses before sending to reduce bounces
  • Deliverability — VDM dashboard, reputation monitoring, dedicated IP management
  • Suppression Lists — Global, account-level, and configuration-set-level suppression

When to Use This Skill

  • Building email sending into an application
  • Setting up transactional email (password resets, order confirmations, notifications)
  • Building a multi-tenant email platform (ISV/SaaS)
  • Migrating from another email service (SendGrid, Postmark, Mailgun)
  • Setting up email authentication (DKIM, SPF, DMARC)
  • Monitoring email deliverability and sender reputation
  • Validating email addresses for deliverability

Common Mistakes (Quick Reference)

MistakeFix
Using V1 API (ses)Use sesv2 — V1 is legacy
Sending before verifying identityVerify domain/email first
Ignoring sandbox modeUse simulator addresses for testing; request production access before going live
Skipping DKIM/SPF/DMARCGmail and Yahoo reject unauthenticated bulk email
No configuration setYou lose all observability — always create one
No tenantsIsolate mail streams from day one — tenants provide per-stream reputation monitoring
Misdiagnosing throttlingTPS limit is a ceiling; check your own app's rate limiting first
Ignoring bounces/complaintsBounce > 5% or complaint > 0.1% triggers enforcement
No delivery delay eventsGmail defers for up to 14 hours — enable notifications
SPF on wrong domainSPF checks MAIL FROM, not From header — use custom MAIL FROM
Cold dedicated IPsWarm up 2-4 weeks or use managed dedicated IPs
Sending to invalid addressesValidate with GetEmailAddressInsights first

See AGENTS.md for detailed explanations of each mistake.

Executable Scripts

Scripts in scripts/ accept command-line arguments and can be run directly. Available in Python and Node.js.

ScriptDescriptionUsage
send-emailSend a simple emailpython scripts/send-email.py --from [email protected] --to [email protected]
send-templatedSend with a templatepython scripts/send-templated.py --from [email protected] --to [email protected] --template name --data '{"key":"val"}'
send-bulkSend bulk templated emailpython scripts/send-bulk.py --from [email protected] --template name --recipients '[{"email":"[email protected]","data":{"name":"Alice"}}]'
verify-domainVerify domain + get DKIM recordspython scripts/verify-domain.py --domain example.com
setup-config-setCreate config set + event destinationspython scripts/setup-config-set.py --name my-config --enable-cloudwatch
handle-bouncesSet up bounce/complaint Amazon SNS notificationspython scripts/handle-bounces.py --config-set my-config --email [email protected]
setup-tenantCreate tenant + associate resourcespython scripts/setup-tenant.py --name my-tenant --identity-arn arn:... --config-set-arn arn:...
validate-emailValidate email addressespython scripts/validate-email.py --email [email protected]

For Java examples, see references/java-examples.md.

What This Skill Does NOT Cover

  • Mail Manager / Inbound Email — SES Mail Manager handles inbound email processing (ingress, routing, archiving, SMTP relay). Classic SES receipt rules (V1 API) are not covered by this skill. See the Mail Manager Agent Context Pack (coming soon) for inbound use cases.
  • Global Endpoints — Cross-region failover configuration is an advanced topic.
  • V1 API — Intentionally excluded. All guidance and examples use V2.

Resource Links

Comments

Markdown supported