# Smtp2go — how to use (mcp.ai)

Connect your Smtp2go account and use 32 tools for transactional email straight from your AI agent. Connect with your own API key. SMTP2GO is a reliable email delivery service that ensures your emails reach recipients' inboxes efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_smtp2go?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `smtp2go_activity_search`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/smtp2go`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/smtp2go/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/smtp2go/activity/search` — Tool to search activity events like sends, opens, clicks, and bounces. Use when you need to filter account email activity by date, event, recipient, or message ID.
  - body: { limit?: integer, offset?: integer, search?: object }
- `POST https://api.mcp.ai/api/smtp2go/allowed/senders/add` — Tool to add a new allowed sender email address. Use when you need to whitelist a sender before sending email. Example: Add "user@example.com" to allowed senders list.
  - body: { email_address: string }
- `POST https://api.mcp.ai/api/smtp2go/allowed/senders/remove` — Tool to remove a sender email address from the allowed senders list. Use when you need to revoke send permissions for a validated address.
  - body: { email_address: string }
- `POST https://api.mcp.ai/api/smtp2go/allowed/senders/update` — Tool to update (replace) the entire allowed senders list in your SMTP2GO account. This action overwrites the current list with the provided email addresses and domain names. Use when you need to set o
  - body: { mode: string, subaccount_id?: string, allowed_senders: string[] }
- `POST https://api.mcp.ai/api/smtp2go/allowed/senders/view` — Tool to view the list of allowed senders configured in your account. Use after setting up SMTP2GO authentication to retrieve your allowed-senders list. Example: 'Show me all verified allowed senders.'
- `POST https://api.mcp.ai/api/smtp2go/domain/add` — Tool to add a new sender domain for SPF/DKIM verification. Use when you need to register a domain and optionally set tracking/return-path subdomains.
  - body: { domain: string, auto_verify?: boolean, subaccount_id?: string, tracking_subdomain?: string, returnpath_subdomain?: string }
- `POST https://api.mcp.ai/api/smtp2go/email/search` — Tool to search sent emails. Use when filtering your SMTP2GO account's email activity by criteria like date, sender, or recipient. Call after authentication.
  - body: { event?: string, limit?: integer, offset?: integer, sender?: string, status?: string, sort_by?: string, subject?: string, date_end?: string, email_id?: string, recipient?: string, date_start?: string, sort_order?: string }
- `POST https://api.mcp.ai/api/smtp2go/ip/allow/list/add` — Tool to add a public IP address to your account's IP allow list. Use when you need to whitelist specific sending sources by IP after confirming accuracy. Note: Only plain IP addresses are supported (n
  - body: { ip: string, note?: string }
- `POST https://api.mcp.ai/api/smtp2go/ip/allow/list/remove` — Tool to remove an IP address from your account's IP allow list. Use after identifying the IP you wish to revoke.
  - body: { ip_address: string }
- `POST https://api.mcp.ai/api/smtp2go/ip/allow/list/view` — Tool to view the list of IP addresses in your IP allow list. Use after confirming your SMTP2GO API key is set.
- `POST https://api.mcp.ai/api/smtp2go/sms/view/received` — Tool to retrieve received SMS replies for your SMTP2GO account. Use when you need to fetch incoming SMS messages for analysis or display. Pagination supported via limit and offset.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/smtp2go/stats/email/bounces` — Tool to retrieve email bounces statistics. Use after sending emails to analyze bounce metrics over a time period.
  - body: { email?: string, limit?: integer, offset?: integer, date_end?: string, date_start?: string, sort_field?: string, sort_direction?: string }
- `POST https://api.mcp.ai/api/smtp2go/stats/email/cycle` — Tool to retrieve current email cycle/quota statistics. Use when you need to check the account's monthly email allowance, usage, and remaining quota for the current billing cycle.
- `POST https://api.mcp.ai/api/smtp2go/stats/email/history` — Tool to retrieve email history statistics. Use when you need detailed delivery metrics within a date range.
  - body: { tag?: string, email?: string, limit?: integer, offset?: integer, sender?: string, date_end?: string, date_start?: string }
- `POST https://api.mcp.ai/api/smtp2go/stats/email/spam` — Tool to retrieve email spam report statistics. Use when analyzing spam trends for sent emails.
  - body: { limit?: integer, offset?: integer, sender?: string, date_end: string, recipient?: string, date_start: string, transaction_id?: string }
- `POST https://api.mcp.ai/api/smtp2go/stats/email/unsubs` — Tool to retrieve email unsubscribe statistics. Use when you need unsubscribe data for your account over a date range.
  - body: { date_end?: string, date_start?: string, result_limit?: integer, email_address?: string, result_offset?: integer }
- `POST https://api.mcp.ai/api/smtp2go/subaccounts/search` — Tool to search subaccounts. Use after authenticating to filter and paginate your subaccounts by name, email, or status.
  - body: { name?: string, email?: string, limit?: integer, active?: boolean, offset?: integer }
- `POST https://api.mcp.ai/api/smtp2go/subaccounts/usage` — Tool to retrieve usage statistics for subaccounts. Use when you need to monitor per-subaccount email usage.
  - body: { subaccount_id?: string }
- `POST https://api.mcp.ai/api/smtp2go/suppression/add` — Tool to add email addresses or domains to the suppression list. Use when you need to block sending emails to specific recipients or entire domains after unsubscribes or bounces.
  - body: { type?: string, description?: string, email_address: string }
- `POST https://api.mcp.ai/api/smtp2go/suppression/remove` — Tool to remove an email address or domain from the suppression list. Use when you want to resume sending to the address or domain.
  - body: { email?: string, domain?: string, subaccount_id?: string }
- `POST https://api.mcp.ai/api/smtp2go/suppression/view` — Tool to view the suppression list. Use when you need to inspect suppressed email addresses in your account.
  - body: { limit?: integer, offset?: integer, end_date?: string, start_date?: string, email_address?: string, suppression_type?: string }
- `POST https://api.mcp.ai/api/smtp2go/template/edit` — Tool to edit details of an existing email template. Use when you need to update template properties after confirming its ID.
  - body: { name?: string, subject?: string, html_body?: string, text_body?: string, editor_code?: string, is_archived?: boolean, template_id: string }
- `POST https://api.mcp.ai/api/smtp2go/template/search` — Tool to search your collection of email templates by ID or name. Use when you need to find templates matching specific criteria after authentication.
  - body: { name?: string, limit?: integer, offset?: integer, template_id?: string }
- `POST https://api.mcp.ai/api/smtp2go/template/view` — Tool to view details of a specific email template. Use after you have the template ID to inspect.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/smtp2go/users/smtp/add` — Tool to add a new SMTP user. Use when you need to provision a fresh SMTP credential after collecting username and password.
  - body: { user_data: object }
- `POST https://api.mcp.ai/api/smtp2go/users/smtp/edit` — Tool to edit details of an existing SMTP user. Use when you need to update username, password, sender restrictions, or enable/disable a user after confirming the target username.
  - body: { disabled?: boolean, password?: string, username: string, allowed_ips?: string[], reset_stats?: boolean, new_username?: string, allow_senders?: string[], sender_domain?: string, disable_senders?: boolean }
- `POST https://api.mcp.ai/api/smtp2go/users/smtp/remove` — Tool to remove an SMTP user from your account. Use when you need to revoke SMTP access for a user.
  - body: { username: string }
- `POST https://api.mcp.ai/api/smtp2go/users/smtp/view` — Tool to list all SMTP users configured on your account. Use when you need to retrieve SMTP user configurations.
- `POST https://api.mcp.ai/api/smtp2go/webhook/add` — Tool to create a new webhook. Use when you need real-time notifications of email or SMS events.
  - body: { name?: string, events: string[], webhook_url: string }
- `POST https://api.mcp.ai/api/smtp2go/webhook/edit` — Tool to edit an existing webhook’s settings. Use when you need to update a webhook's configuration after creation.
  - body: { url: string, users?: string[], sms_events?: string[], webhook_id: string, output_type?: string, email_events: string[], email_headers?: string[], authorization_header?: string }
- `POST https://api.mcp.ai/api/smtp2go/webhook/remove` — Tool to remove a webhook. Use when you want to delete a webhook by its ID from your SMTP2GO account.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/smtp2go/webhook/view` — Tool to view all webhooks configured in your account. Use when you need to inspect existing webhook configurations after setup.
  - body: { subaccount_id?: string }

## Example prompts
- "What can I do in Smtp2go?"
- "Show me a summary of my Smtp2go account"

## More
- Page: https://mcp.ai/smtp2go
- Agent spec (llms.txt): https://mcp.ai/smtp2go/llms.txt
- Postman collection: https://mcp.ai/smtp2go/postman.json