# Prontuno MCP

Prontuno MCP connects your Prontuno account to MCP-compatible AI assistants. You can use natural language to review email delivery, configure sending domains, verify DNS records, and manage your suppression list without switching between tools.

**Current release:** Prontuno MCP v1.0.0 can inspect and manage your email infrastructure, but it cannot send emails. Email-sending tools are not available in this version.

## Features

- **Email delivery visibility:** Review sent emails and inspect the delivery status, timestamps, provider response, and error details for a specific email.
- **Sending-domain setup:** Create a sending domain, retrieve the required DNS records, and check its verification state.
- **Suppression management:** Find suppressed recipients, add manual suppressions, and remove manual suppressions when needed.
- **Delivery troubleshooting:** Combine email, domain, and suppression information to identify a likely delivery problem and the next action to take.
- **Natural-language workflows:** Ask questions in plain English. Your MCP client selects and calls the relevant Prontuno tools.
- **Cursor-based pagination:** Review large sets of emails, domains, or suppressions, with automatic pagination of up to 1,000 records per request.
- **Secure account access:** Authenticate with Prontuno OAuth or a Prontuno API key. Tools only access data available to the authenticated Prontuno account.

## Connect to Prontuno MCP

You need a Prontuno account and an MCP client that supports remote Streamable HTTP servers.

1. Open the MCP integrations, connectors, or custom tools section in your AI client.
2. Add a remote MCP server.
3. Enter the Prontuno MCP endpoint: `https://mcp.prontuno.net/mcp`
4. When prompted, sign in to Prontuno and approve access.
5. Test the connection with: “Check whether my Prontuno account is ready to send email.”

OAuth is the recommended authentication method. If your client does not support the Prontuno OAuth flow but supports custom request headers, configure your Prontuno API key as a bearer token:

```
Authorization: Bearer <your-prontuno-api-key>
```

**Keep credentials out of prompts.** Add your API key only in your MCP client’s secure connection settings. Never paste it into a chat message.

## Available tools

Prontuno MCP v1.0.0 exposes nine tools. Your AI assistant normally calls them for you, but the reference below shows exactly what each tool can do and which inputs it accepts.

### Email delivery

#### `get_email_status`

Retrieves the delivery status and metadata for one previously sent email.

- **Required:** `id` — the Prontuno email ID.

#### `list_emails`

Lists sent emails for the authenticated account using cursor-based pagination.

- **Optional:** `limit` — records per page, from 0 to 100.
- **Optional:** `cursor` — the `next_cursor` from a previous response.
- **Optional:** `auto_paginate` — fetch multiple pages automatically.
- **Optional:** `max_items` — maximum records to return when automatic pagination is enabled, from 1 to 1,000. The default is 100.

### Sending domains

#### `create_domain`

Creates a sending domain and returns the DNS records required for verification. This tool does not make changes at your DNS provider.

- **Required:** `domain` — a domain such as `example.com`.

#### `list_domains`

Lists sending domains and their metadata. The list response does not include DNS records; use `get_domain` for full DNS and verification details.

- **Optional:** `limit` — records per page, from 0 to 100.
- **Optional:** `cursor` — the `next_cursor` from a previous response.
- **Optional:** `auto_paginate` — fetch multiple pages automatically.
- **Optional:** `max_items` — maximum records to return when automatic pagination is enabled, from 1 to 1,000. The default is 100.

#### `get_domain`

Retrieves one sending domain, including its DNS records and current verification status.

- **Required:** `id` — the Prontuno domain ID.

### Suppressions

#### `list_suppressions`

Lists suppressed recipients, with optional exact email filtering and cursor-based pagination.

- **Optional:** `email` — an exact email address to filter by.
- **Optional:** `limit` — records per page, from 0 to 100.
- **Optional:** `cursor` — the `next_cursor` from a previous response.
- **Optional:** `auto_paginate` — fetch multiple pages automatically.
- **Optional:** `max_items` — maximum records to return when automatic pagination is enabled, from 1 to 1,000. The default is 100.

#### `get_suppression`

Looks up one suppression using an exact email address.

- **Required:** `email` — a valid email address.

#### `create_suppression`

Creates a manual suppression. A duplicate active suppression for the same email address is rejected.

- **Required:** `email` — a valid email address.

#### `delete_suppression`

Deletes a suppression by ID. Only suppressions with the `manual` type can be removed.

- **Required:** `id` — the Prontuno suppression ID.

## Resources and built-in workflows

In addition to tools, Prontuno MCP exposes read-only resources that compatible clients can browse or use as context:

- `prontuno://domains` — all visible sending domains.
- `prontuno://domains/{id}` — one domain’s DNS records and verification state.
- `prontuno://emails` — recent sent emails.
- `prontuno://emails/{email_id}` — one sent email’s details.
- `prontuno://suppressions` — visible suppression records.
- `prontuno://suppressions/{email}` — exact suppression lookup by email address.

Compatible clients can also offer these reusable Prontuno prompt workflows:

- `check_account_readiness` — check sending-domain readiness before a send.
- `setup_sending_domain` — create or inspect a sending domain and report its setup state.
- `verify_domain_dns` — summarize required DNS records and the current verification state.
- `investigate_email_delivery` — inspect one sent email and recommend the next action.
- `review_recent_emails` — summarize recent activity, failures, and delivery trends.
- `troubleshoot_delivery_issue` — combine email, suppression, and domain state for diagnosis.
- `manage_suppression` — inspect, add, or remove a suppression for one email address.

## Sample prompts

You do not need to mention tool names. Ask Prontuno questions naturally and include a domain, email ID, or email address when the task needs one.

### Check account and domain readiness

- “Check whether my Prontuno account is ready to send email.”
- “List my sending domains and tell me which ones are verified.”
- “Set up `mail.example.com` as a Prontuno sending domain.”
- “Show me the exact DNS records I need for `example.com` and explain which records are still pending.”
- “Why is my sending domain still unverified, and what should I check next?”

### Review email delivery

- “Review my 50 most recent emails and summarize delivery failures or repeated issues.”
- “Check the delivery status of email ID `EMAIL_ID`.”
- “Troubleshoot email ID `EMAIL_ID`. Check its status, the recipient’s suppression state, and the sending domain if relevant.”
- “Review up to 200 recent emails and group any failures by likely cause.”
- “Which recent emails need attention, and what should I do next for each one?”

### Manage suppressions

- “Is `person@example.com` currently suppressed? Show me the type and date.”
- “Add a manual suppression for `person@example.com`.”
- “Remove the manual suppression for `person@example.com`. Look it up first and confirm it is removable.”
- “Review up to 100 suppressions and summarize the suppression types you find.”
- “Check whether the recipient of email ID `EMAIL_ID` is suppressed.”

## Limits and troubleshooting

- **Email sending:** The `send_email` and `send_batch_email` tools are not available in Prontuno MCP v1.0.0.
- **DNS changes:** Prontuno MCP returns the records you need, but you must add or update those records at your DNS provider.
- **Suppression deletion:** Only manual suppressions can be deleted. Other suppression types are retained to protect email deliverability.
- **Rate limits:** Authenticated MCP requests are limited to 20 requests per minute per credential. If your client receives a `429` response, wait for the time shown by `Retry-After` before trying again.
- **Pagination:** List tools return up to 100 records per page. Automatic pagination can combine multiple pages, up to the requested `max_items` limit of 1,000.

### Common connection issues

- **Authentication required or `401`:** Reconnect the integration and complete the Prontuno sign-in flow. For API-key connections, verify the bearer token in your client’s secure settings.
- **No Prontuno tools appear:** Confirm that the server URL ends in `/mcp`, then refresh or reconnect the MCP integration.
- **Domain remains pending:** Compare the DNS records returned by `get_domain` with the records at your DNS provider, allow time for DNS propagation, and check again.
- **Suppression not found:** There is no active suppression matching that exact email address. Check the spelling and try again.