Agent skill

Mailtrap Sending Emails

by sickn33 in sickn33/agentic-awesome-skills

Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.

MITAuto-check passedBackend & APIs

Install Mailtrap Sending Emails

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill mailtrap-sending-emails -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills mailtrap-sending-emails --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mailtrap-sending-emails .claude/skills/mailtrap-sending-emails && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mailtrap-sending-emails
GitHub stars
47k
Used in
1 other repo
Token cost
~2.8k tokens
SKILL.md length
803 words
Files
1
Skills in repo
1,497
Repo updated
First seen
Licence
MIT

At a glance

Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.

  • Works in 4 steps: Plugin or integration for the user's… → Official SDK for your language when one… → HTTP Email API when there is no SDK or… → …
  • Tasks that involve Transactional email
  • SKILL.md covers Overview, When to Use, How to integrate (preference… and Choosing how to send, plus 5 more sections
  • Calls curl; reaches send.api.mailtrap.io and bulk.api.mailtrap.io; needs MAILTRAP_API_TOKEN

What it does

Mailtrap Sending Emails is an agent skill from sickn33/agentic-awesome-skills. Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Transactional email. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Tasks that involve Transactional email

Example prompts

  • “/mailtrap-sending-emails”

Requirements

  • Node.js
  • A credential in MAILTRAP_API_TOKEN

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Plugin or integration for the user's platform (no-code or minimal-config) where available
  2. Official SDK for your language when one exists (maintained clients, typed helpers, less room for URL/auth mistakes).
  3. HTTP Email API when there is no SDK or the SDK does not fit (direct POST to /api/send or /api/batch with JSON).
  4. SMTP only when you really need it (legacy stack, host/platform that only speaks SMTP, or hard constraints that rule out HTTP).

What it can do on your machine

Read from SKILL.md and the folder at commit b84d35a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • send.api.mailtrap.io
    • bulk.api.mailtrap.io

    Also links to:

    • github.com
    • docs.mailtrap.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MAILTRAP_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mailtrap Sending Emails loads about 2.8k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 803 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit b84d35a, republished under its MIT licence (© sickn33). 803 words, ~2,806 tokens.

Download SKILL.mdSave it as .claude/skills/mailtrap-sending-emails/SKILL.md (or your agent's skills folder).
name
mailtrap-sending-emails
description
Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.
risk
critical
source
community
date_added
2026-06-19

Sending emails (Mailtrap)

Overview

Mailtrap sends live email over Email API (REST) or SMTP. Two streams apply for API/SMTP: Transactional (non-promotional, app-generated) and Bulk (promotional / marketing volume). Batch is not a third stream: it is how you submit many messages in one request on whichever stream matches the content. Campaigns are a separate product path for promotional mail to Mailtrap contacts. Pair this sheet with the Transactional / Bulk developer pages when building or debugging integrations (including with AI-assisted coding).

When to Use

Use when integrating, configuring, or troubleshooting Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batch requests.

How to integrate (preference order)

Preferred order:

  1. Plugin or integration for the user's platform (no-code or minimal-config) where available
  2. Official SDK for your language when one exists (maintained clients, typed helpers, less room for URL/auth mistakes).
  3. HTTP Email API when there is no SDK or the SDK does not fit (direct POST to /api/send or /api/batch with JSON).
  4. SMTP only when you really need it (legacy stack, host/platform that only speaks SMTP, or hard constraints that rule out HTTP).

Choosing how to send

ApproachUse when
Transactional, single messageEmail generated by your app (password resets, receipts, notifications, alerts). One logical message per POST https://send.api.mailtrap.io/api/send
BulkPromotional email to contacts that you manage on your side and send at volume through Mailtrap. Not the same as "batch": bulk is the stream, not the batch endpoint.
BatchYou have multiple different messages to hand off at the same time (up to 500 per request). Cuts HTTP overhead; can be applied to both transactional and bulk
CampaignsPromotional email to recipients stored as Mailtrap contacts, using Mailtrap Campaigns (audiences, scheduling, reporting in the product). Recommended to avoid implementing contact management and email sending logic; requires UI setup before sends flow—this skill does not replace that workflow.

Before generating SDK code: read the README of the relevant SDK repository linked in the SDKs section below for current method signatures, constructor options, and examples. Do not rely on memory.

Related skills: mailtrap-testing-with-sandbox (safe testing) and mailtrap-setting-up-sending-domain (verification before send).

When not to use

  • Sandbox only—capturing mail without delivery, reading messages in a sandbox (mailtrap-testing-with-sandbox).
  • The main ask is webhooks, step-by-step Campaigns UI setup, or deliverability deep-dives.
  • Exhaustive API reference—once the user's path is clear, link the official send docs for full schemas, optional fields, and edge cases.

Quick reference

Email API
StreamSend EndpointBatch EndpointAuthorization Header
TransactionalPOST https://send.api.mailtrap.io/api/sendPOST https://send.api.mailtrap.io/api/batchAuthorization: Bearer $MAILTRAP_API_TOKEN
Bulk (promotional / marketing volume)POST https://bulk.api.mailtrap.io/api/sendPOST https://bulk.api.mailtrap.io/api/batchAuthorization: Bearer $MAILTRAP_API_TOKEN
SMTP
SettingTransactionalBulk
Hostlive.smtp.mailtrap.iobulk.smtp.mailtrap.io
Port587 (also 25, 2525, 465 with SSL)587 (also 25, 2525, 465 with SSL)
Usernameapiapi
PasswordAPI token ($MAILTRAP_API_TOKEN)API token ($MAILTRAP_API_TOKEN)
Show full SKILL.md (341 more words)Show less
Tokens

Use $MAILTRAP_API_TOKEN in either Authorization: Bearer ... or Api-Token: .... The same token works on both send.api.mailtrap.io and bulk.api.mailtrap.io as long as its scope covers the stream. Store tokens in environment variables or a secrets manager and rotate them when access changes.

Rate limits
ScopeLimitWindow
Sending API (per token)150 requests10 seconds

Use backoff on 429.

JSON body (non-template)

Typical fields include from, to, subject, and text and/or html. Optional: category, custom_variables. Exact request bodies: Transactional send and Bulk send.

Examples (curl)

Transactional send (send.api.mailtrap.io):

bash
curl -X POST https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"email": "hello@yourdomain.com", "name": "Your App"},
    "to": [{"email": "user@example.com"}],
    "subject": "Hello",
    "text": "Plain text body"
  }'

Bulk stream uses the same path and JSON shape on the bulk host (same env var; the token only needs bulk-stream scope):

bash
curl -X POST https://bulk.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"email": "hello@yourdomain.com", "name": "Your App"},
    "to": [{"email": "user@example.com"}],
    "subject": "Promotional",
    "html": "<p>HTML body</p>"
  }'

Batch (array of messages; up to 500 per request — see API docs for full schema):

bash
curl -X POST https://send.api.mailtrap.io/api/batch \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"from":{"email":"a@example.com"},"to":[{"email":"b@example.com"}],"subject":"One","text":"..."}]}'
JSON body (template)

Use template_uuid and template_variables instead of raw text/html to use a template hosted by Mailtrap. Minimal example:

bash
curl -X POST https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"email": "hello@yourdomain.com", "name": "Your App"},
    "to": [{"email": "user@example.com"}],
    "template_uuid": "your-template-uuid",
    "template_variables": {"user_name": "Jane"}
  }'

Use the same API operations as non-template sends.

SDKs

Suppressions

Mailtrap automatically manages suppressions for addresses that hard bounce, report spam, or unsubscribe, and will not send emails to these suppressed recipients again. For details, see the Suppressions documentation.

Common mistakes

MistakeFix
Confusing batch with bulkBatch = many messages in one /api/batch request. Bulk = promotional stream/host and token
Promotional API mail on transactional hostUse bulk base URL and bulk token for promotional content you generate in code
Bulk traffic on send.api.mailtrap.ioPromotional/bulk stream uses bulk.api.mailtrap.io
Using sandbox SMTP host for live sendingLive sending uses live.smtp.mailtrap.io or bulk.smtp.mailtrap.io
SMTP username is an email addressUsername is api; password is the API token
Sending before domain is verifiedComplete Sending Domains setup and compliance (see mailtrap-setting-up-sending-domain)
Guessing SDK API from memoryRead the SDK README and OpenAPI-linked examples; do not invent constructors or method names
Choosing SMTP first for a greenfield appPrefer platform integration if one exists, then SDK, then HTTP API; SMTP only when necessary (see How to integrate)

Limitations

  • This skill summarizes Mailtrap sending choices; use Mailtrap's current API docs for exhaustive schemas and product limits.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/mailtrap-sending-emails of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit b84d35a

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Mailtrap Sending Emails next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mailtrap Sending Emails compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mailtrap Sending Emails this skillsickn33/agentic-awesome-skills47k1 repos~2.8kAutomated safety check: PassMIT
Stripe Projectsfossasia/eventyay1.7k5 repos~2kAutomated safety check: NotesApache-2.0
WooCommerce Email Editor Developmentwoocommerce/woocommerce11k—~893Automated safety check: PassCustom licence
Email Best Practicesviclafouch/meme-studio1107 repos~787Automated safety check: PassNone
React Emailviclafouch/meme-studio1102 repos~3.6kAutomated safety check: PassMIT
Pinme Emailglitternetwork/pinme3.8k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Stripe Projects

    fossasia/eventyay

    A skill your agent uses when the user wants to provision infrastructure or third-party services using Stripe Projects.

    1.7k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check: notes
  • Sets up a local environment for the WooCommerce block email editor, with a watcher, Mailpit email capture and build and test commands for its PHP and JS packages.

    11k GitHub stars~893 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Email Best Practices

    viclafouch/meme-studio

    A skill your agent uses when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM…

    110 GitHub starsUsed in 7 repos~787 tokens
    Backend & APIsAuto-check passed
  • React Email

    viclafouch/meme-studio

    A skill your agent uses when creating HTML email templates with React components - welcome emails, password resets, notifications, order confirmations, newsletters, or transactional emails.

    110 GitHub starsUsed in 2 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • Pinme Email

    glitternetwork/pinme

    A skill your agent uses when a PinMe project (Worker TypeScript) needs to integrate email sending (sendemail).

    3.8k GitHub stars~1.2k tokensUpdated 28 days ago
    Backend & APIsAuto-check passed
  • Email Deliverability Audit

    growthenginenowoslawski/coldoutboundskills

    Diagnostic audit for a running cold email program. An agent skill from growthenginenowoslawski/coldoutboundskills.

    753 GitHub stars~3.4k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,497 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Categories

Questions about Mailtrap Sending Emails

What does Mailtrap Sending Emails do?

Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches. Mailtrap Sending Emails is an agent skill from sickn33/agentic-awesome-skills. Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.

When should I use Mailtrap Sending Emails?

Mailtrap Sending Emails fits situations like: tasks that involve Transactional email.

How do I install Mailtrap Sending Emails in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill mailtrap-sending-emails -a claude-code`. Or copy the skill folder (skills/mailtrap-sending-emails in sickn33/agentic-awesome-skills) into .claude/skills/mailtrap-sending-emails in your project. Claude Code loads it when a task matches its description.

How do I install Mailtrap Sending Emails in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill mailtrap-sending-emails -a codex`. Or copy the skill folder (skills/mailtrap-sending-emails in sickn33/agentic-awesome-skills) into .agents/skills/mailtrap-sending-emails in your project. Codex loads it when a task matches its description.

Can I use Mailtrap Sending Emails in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill mailtrap-sending-emails -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mailtrap-sending-emails, .gemini/skills/mailtrap-sending-emails, .github/skills/mailtrap-sending-emails and .opencode/skills/mailtrap-sending-emails in your project.

What does Mailtrap Sending Emails need to run?

Going by SKILL.md and its folder, Mailtrap Sending Emails needs the command-line tools its instructions call (curl) and credentials named MAILTRAP_API_TOKEN. Our summary lists: Node.js; A credential in MAILTRAP_API_TOKEN.

Does Mailtrap Sending Emails access the network?

SKILL.md names 4 domains. In commands or code: send.api.mailtrap.io and bulk.api.mailtrap.io; the agent is likely to contact these when it follows the instructions. As links in the text: github.com and docs.mailtrap.io. This is read from the text; nothing was executed.

Is Mailtrap Sending Emails safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mailtrap Sending Emails use?

Mailtrap Sending Emails is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mailtrap Sending Emails use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mailtrap Sending Emails?

Skills that share tags, products or a category with Mailtrap Sending Emails: Stripe Projects (fossasia/eventyay, 1.7k stars), WooCommerce Email Editor Development (woocommerce/woocommerce, 11k stars), Email Best Practices (viclafouch/meme-studio, 110 stars) and React Email (viclafouch/meme-studio, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mailtrap Sending Emails?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,405 GitHub stars. The repository holds 1,497 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.