# Prontuno MCP

Connect ChatGPT, Claude, Cursor, or another MCP client to Prontuno to send email and manage domains, suppressions, and webhooks.

Prontuno MCP connects your Prontuno account to MCP-compatible AI assistants, including ChatGPT, Claude, OpenCode, Gemini, Cursor, Grok, and goose. Ask in natural language to send transactional email, review delivery activity, set up sending domains, manage suppressions, and manage event webhooks.

## Features

- **Send email:** Compose and queue individual emails with To, CC, BCC, reply-to, custom headers, and attachments.
- **Send batches:** Queue up to 1,000 emails in one batch request.
- **Email delivery visibility:** Review sent emails and inspect delivery status, timestamps, provider responses, and error details.
- **Sending-domain setup:** Create a sending domain, retrieve its required DNS records, and check its verification status.
- **Suppression management:** Find suppressed addresses, add manual suppressions, and remove manual suppressions when appropriate.
- **Webhook management:** Create, inspect, update, and delete webhooks; manage event subscriptions and rotate signing secrets.
- **Delivery troubleshooting:** Bring together email, domain, and suppression information to investigate delivery issues.
- **Natural-language workflows:** Ask questions in plain English. Your MCP client selects and calls the relevant Prontuno tools.
- **Pagination:** Browse large result sets page by page or request automatic pagination, up to 1,000 records.

## Connect to Prontuno MCP

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

### Add Prontuno from the Claude directory

Prontuno is listed in the [Claude connectors directory](https://claude.ai/directory/04f91e48-8e8a-4c66-8b04-582dfcc0ce35) as a community connector. Community connectors have undergone automated review but are not verified by Anthropic. Open the Prontuno listing, add it to your Claude account, and sign in to Prontuno when prompted. You do not need to enter the endpoint yourself.

### Install Prontuno from the ChatGPT plugin directory

Prontuno is listed in the [ChatGPT plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6aad3d4f29a481918626a0898167864f). Open the Prontuno plugin and choose Install plugin, then sign in to Prontuno when ChatGPT asks you to connect your account. You do not need to enter the endpoint yourself. Plan eligibility and workspace settings can affect availability.

### Connect another client manually

For other MCP clients, or to connect Claude or ChatGPT by hand:

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. Sign in to Prontuno and approve access when prompted.
5. Try asking: “Check whether my Prontuno account is ready to send email.”

### Choose an API key type

OAuth is the recommended way to connect. If your MCP client requires an API key, create one from your Prontuno account and choose the key type based on where it will be used:

- **Sending:** For applications that send transactional email. The key is bound to one domain.
- **MCP:** For AI agents with account-wide access. You can optionally allow email sending from one verified domain.
- **Management:** For admin tools and scripts. The key has account-wide access and cannot send email.

For an MCP connection, choose the **MCP** key type. If you want the assistant to send email, enable **Allow email sending** and select the verified domain the key may send from. Keep the key in your MCP client’s secure connection settings. Do not paste it into a chat message or prompt.

## Available tools

Your AI assistant normally calls these tools for you. The list below describes the actions available through Prontuno MCP.

### Emails

- **`send_email`:** Queue one email with a sender, recipients, subject, and HTML or plain-text body. CC, BCC, reply-to, custom headers, and attachments are supported.
- **`send_batch_emails`:** Queue up to 1,000 email payloads in one request.
- **`get_email`:** Retrieve delivery status and metadata for one email by its Prontuno email ID.
- **`list_emails`:** List sent emails, with optional domain and status filters and cursor-based pagination.

Before sending, ask your AI client to show you a preview of the sender, recipients, reply-to, subject, message body, and attachment filenames, then confirm that exact email or batch. Check the result for each recipient: a queued email has not necessarily been delivered.

### Domains

- **`create_domain`:** Add a sending domain to Prontuno and return the DNS records needed for verification. You must add those records with your DNS provider.
- **`list_domains`:** List sending domains for your account.
- **`get_domain`:** Retrieve a domain’s DNS records and current verification status.

### Suppressions

- **`list_suppressions`:** List suppressions, optionally filtered by an exact email address.
- **`get_suppression`:** Look up a suppression by its ID or exact email address.
- **`create_suppression`:** Add a manual suppression. Future sends to that address will be blocked.
- **`delete_suppression`:** Remove a manual suppression by ID or exact email address. Other suppression types cannot be removed through MCP.

### Webhooks

- **`list_webhooks`:** List webhooks configured for your account.
- **`get_webhook`:** Inspect one webhook. Its signing secret is not included.
- **`create_webhook`:** Create a global or domain-scoped webhook for selected delivery events.
- **`update_webhook`:** Change a webhook’s name, destination URL, event subscriptions, domain scope, or enabled state.
- **`delete_webhook`:** Delete a webhook and stop future deliveries to it.
- **`rotate_webhook_secret`:** Replace a webhook’s signing secret. The new secret is returned once.

Supported webhook events are `email.sent`, `email.rejected`, `email.deferred`, `email.delivered`, `email.bounced`, `email.expired`, `email.complained`, and `email.received` (global webhooks only). Save a new webhook’s signing secret securely when it is shown. After rotating a secret, update your receiving application promptly: the previous secret becomes invalid immediately. Domain-scoped webhooks require a verified, enabled domain belonging to your team.

For webhook changes, your AI client should show the destination and settings before making the change. Deleting a webhook stops future deliveries; rotating its secret invalidates the previous secret. Confirm these actions when prompted.

## Resources and built-in workflows

Compatible clients can also browse these read-only resources:

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

Depending on your MCP client, reusable Prontuno prompts may also be available for checking account readiness, setting up a sending domain, verifying DNS, investigating delivery, reviewing recent emails, troubleshooting, and managing suppressions.

## Sample prompts

You do not need to mention tool names. Include a domain, email ID, webhook, or email address when the task needs one.

### Send email

- “Draft an email to `person@example.com` with the subject ‘Your receipt’ and this message: … Show me the complete preview before sending.”
- “Send these three transactional emails. Show me all recipients and message previews before sending the batch.”

### Review 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.”

### Manage domains and suppressions

- “List my sending domains and tell me which ones are verified.”
- “Show me the DNS records I need for `example.com` and explain which records are still pending.”
- “Is `person@example.com` currently suppressed?”
- “Add a manual suppression for `person@example.com`.”

### Manage webhooks

- “List my webhooks and show which events each one receives.”
- “Create a webhook at `https://example.com/email-events` for delivered and bounced events. Show me the settings before creating it.”
- “Update my webhook to include `email.deferred`. Show me the current and proposed settings first.”

## Limits and troubleshooting

- **Email sending:** Sending is available to an MCP key when email sending is enabled. That key can send only from its selected verified domain.
- **Batch sends:** A batch can contain up to 1,000 email payloads. Each email supports up to 100 recipients across To, CC, and BCC.
- **DNS changes:** MCP returns the records you need, but you must add or update them at your DNS provider. DNS changes may take time to propagate.
- **Suppression deletion:** Only manual suppressions can be deleted. Other suppression types are retained to protect email deliverability.
- **Webhook secrets:** Creation and rotation return the signing secret only once. Store it securely and configure your receiver to verify webhook signatures.
- **Pagination:** List tools return up to 100 records per page. Automatic pagination can collect up to 1,000 records.
- **Authentication required or `401`:** Reconnect the integration and complete the Prontuno sign-in flow. For API-key connections, check the key in your client’s secure settings.
- **No Prontuno tools appear:** Confirm the server URL ends in `/mcp`, then refresh or reconnect the MCP integration.
- **Domain remains pending:** Compare the records returned by `get_domain` with those at your DNS provider, allow time for propagation, and check again.