> For the complete documentation index, see [llms.txt](https://docs.mailtrap.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mailtrap.io/for-ai-agents/tools/skills.md).

# Skills

Mailtrap offers official agent skills you can use to give your AI coding assistant accurate Mailtrap context for sending emails, receiving emails, testing with sandbox, using email templates, setting up a sending domain, and managing contacts.

For more information, read the official [GitHub repository](https://github.com/mailtrap/mailtrap-skills).

{% hint style="info" %}
Skills are not a substitute for [docs.mailtrap.io](http://docs.mailtrap.io) or the developer [API documentation](https://docs.mailtrap.io/developers).
{% endhint %}

### How to use Mailtrap Skills

To install, simply copy the [skills folders](https://github.com/mailtrap/mailtrap-skills) into the directory your agent reads. For example, for Cursor, that’s `.cursor/skills/`. Or, you can install via npx:

```
npx skills add mailtrap/mailtrap-skills
```

Mailtrap skills and their purpose:

| sending-emails            | Use when integrating, configuring, or troubleshooting Mailtrap (Email API or SMTP).                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| testing-with-sandbox      | Use when capturing outbound email in development or staging in a fake inbox.                                                               |
| using-email-templates     | Use when creating, managing, and sending Mailtrap-hosted email templates.                                                                  |
| setting-up-sending-domain | Use when adding or verifying a Mailtrap sending domain.                                                                                    |
| managing-contacts         | Use when using Mailtrap Contacts API or UI to add, update, bulk import, list, segment marketing contacts, custom fields, or custom events. |

### Why use Mailtrap Skills

* **Ship email integrations faster** – AI coding assistants (Cursor, Claude Code) get correct Mailtrap endpoints, auth patterns, and stream choices without the developer leaving their editor
* **Fewer integration mistakes** – Skills encode the "common mistakes", catching errors before they happen
* **Lower time-to-first-send** – New users get a guided path from domain verification to first sent email
* **Always-current reference in context** – Skills point to live docs and OpenAPI specs, so the AI agent generates code against current APIs


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mailtrap.io/for-ai-agents/tools/skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.