> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.