⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
authorizing-api-requests
>-
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
Mailtrap user skills
Agent skills for Mailtrap end users and builders using LLM-assisted coding. They summarize product flows, API bases and paths, and links to official documentation. They are not a substitute for docs.mailtrap.io or the developer API documentation.
Standard
These skills follow the Agent Skills open standard (Anthropic, Dec 2025). Each skill is a directory containing a SKILL.md with YAML frontmatter (name, description) plus Markdown instructions. Compliant agents read only the frontmatter at startup and pull the body on demand (progressive disclosure), so the same folder works across multiple tools.
The repository is an Agent Plugin: root plugin.json plus mcp.json. A compatible client loads the skills under skills/ and the Mailtrap MCP server from that one package. Native manifests for Claude Code, OpenAI Codex, and Cursor stay for clients that install those formats directly. Windsurf loads the same skills from its skills directory and does not require a plugin manifest.
Install
Plugin
Install this repository as one plugin in any compatible client: Kiro, GitHub Copilot, Cursor, OpenClaw, VS Code, NanoClaw, Hermes Agent, Grok Bot, ChatGPT, and Codex.
Use the repository URL, or a local clone, in that client's plugin install flow (marketplace, Git URL, or local folder):
https://github.com/mailtrap/mailtrap-skills
The client reads plugin.json, loads every skill under skills/, and starts the MCP server in mcp.json (npx -y mcp-mailtrap). Start a new session after install.
The plugin does not embed credentials. Set MAILTRAP_API_TOKEN in the client environment before using the MCP server. See Tokens and account_id.
Manual install
If the client does not load Agent Plugins, copy or symlink the skill folders into the skills directory it reads. The examples below assume you cloned this repo to /path/to/mailtrap-skills. After install, restart or reload the agent if it does not pick up new skills.
Cursor
- Project:
.cursor/skills/<skill-name>/ - User (all projects):
~/.cursor/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.cursor/skills/
Claude Code (Anthropic)
- Project:
.claude/skills/<skill-name>/ - User:
~/.claude/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.claude/skills/
Codex CLI (OpenAI)
- Project:
.agents/skills/<skill-name>/ - User:
~/.agents/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.agents/skills/
Gemini CLI (Google)
- Project:
.gemini/skills/<skill-name>/(also accepts.agents/skills/) - User:
~/.gemini/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.gemini/skills/
GitHub Copilot
- Project:
.github/skills/<skill-name>/(also accepts.claude/skills/and.agents/skills/) - User:
~/.copilot/skills/<skill-name>/(also accepts~/.agents/skills/)
ln -s /path/to/mailtrap-skills/skills/* ~/.copilot/skills/
Windsurf (Cascade)
- Project:
.windsurf/skills/<skill-name>/ - User:
~/.codeium/windsurf/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.codeium/windsurf/skills/
Other agents
Most other agents that support the Agent Skills standard also accept ~/.agents/skills/ (user scope) and .agents/skills/ (project scope). If your tool uses a different path, point it at this repository's skills/ folder.
Tokens and account_id
Skill examples reference these environment variables instead of literal secrets:
| Variable | Used for |
|---|---|
MAILTRAP_API_TOKEN | General API: Email Send (transactional and bulk), Templates, Contacts, Sending Domains |
MAILTRAP_SANDBOX_API_TOKEN | Sandbox / Email Testing (separate scope) |
MAILTRAP_ACCOUNT_ID | Path parameter for account-scoped endpoints (resolve at runtime, do not hardcode) |
Full guidance — token scope, where to store tokens, auth header forms, and how to resolve MAILTRAP_ACCOUNT_ID from GET https://mailtrap.io/api/accounts — lives in the authorizing-api-requests skill. Every other skill in this repo points at it instead of duplicating the rules.
Contents
| Skill | Purpose |
|---|---|
authorizing-api-requests | API tokens, env vars, auth headers, account_id resolution |
sending-emails | Live sending via Email API and SMTP (transactional vs bulk) |
testing-with-sandbox | Email Sandbox, Testing API, safe capture in dev/staging |
using-email-templates | Account-scoped templates, Handlebars, API template send |
converting-email-templates | Convert templates from SendGrid, Mailgun, Mandrill, Postmark, Brevo, SES to Mailtrap Handlebars |
setting-up-sending-domain | Domain verification, DNS (add all records), compliance |
managing-contacts | Contacts API, lists, segments, CRM-style sync |
References
- Product documentation: docs.mailtrap.io
- Developer and API documentation: docs.mailtrap.io/developers
- Agent Skills standard: agentskills.io
- Agent Plugins standard: agent-plugins.org
- Mailtrap MCP server: mcp-mailtrap
// HOW IT'S BUILT
KEY FILES