Permissions & tools

MCP server · Beta

When you connect, you decide what the assistant may do. It only sees the tools you granted, so an assistant without the Send permission can't send a campaign, however it's asked.

Four kinds of permission

Choosing permissions

When you log in, Mailrelay asks how much access the assistant should have:

The areas are Contacts, Email campaigns, Transactional email, SMS, Transactional SMS, WhatsApp, Transactional WhatsApp, Ecommerce, Media library and Webhooks. Reading your account information (stats and package usage) is always included. You can only grant permissions that your own user has.

Each section of this reference is available to the assistant as up to four tools, one per permission, such as subscribers_read or campaigns_send.

• Send emails
  • POST /send_emails — Send email to one or more recipients
• A/B tests
  • GET /ab_tests — Lists A/B tests
  • POST /ab_tests — Add a new A/B test
  • GET /ab_tests/{id} — Get an A/B test by id
  • DELETE /ab_tests/{id} — Remove an A/B test
  • PATCH /ab_tests/{id}/cancel — Cancel A/B test
  • POST /ab_tests/{id}/choose_winning_combination — Choose which A/B test combination should be sent to the remaining subscribers
  • PATCH /ab_tests/{id}/set_as_manual — Set A/B test as manual
• Campaigns
  • GET /campaigns — Lists campaigns
  • POST /campaigns — Add a new campaign
  • GET /campaigns/{id} — Get a campaign by id
  • DELETE /campaigns/{id} — Remove a campaign
  • PATCH /campaigns/{id} — Update a campaign
  • POST /campaigns/{id}/send_all — Send a campaign
  • POST /campaigns/{id}/send_test — Send a campaign to test emails
• Campaign folders
  • GET /campaign_folders — Lists campaign folders
  • POST /campaign_folders — Add a new campaign folder
  • GET /campaign_folders/{id} — Get a campaign folder by id
  • DELETE /campaign_folders/{id} — Remove a campaign folder
  • PATCH /campaign_folders/{id} — Update a campaign folder
• Custom fields
  • GET /custom_fields — Lists custom fields
  • POST /custom_fields — Add a new custom field
  • GET /custom_fields/{id} — Get a custom field by id
  • DELETE /custom_fields/{id} — Remove a custom field
  • PATCH /custom_fields/{id} — Update a custom field
• Imports
  • GET /imports — Lists imports
  • POST /imports — Import a new file
  • GET /imports/{id} — Get an import by id
  • PATCH /imports/{id}/cancel — Cancel an import that is in progress
  • GET /imports/{id}/data — Get line by line data of an import
• Groups
  • GET /groups — Lists groups
  • POST /groups — Add a new group
  • GET /groups/{id} — Get a group by id
  • DELETE /groups/{id} — Remove a group
  • PATCH /groups/{id} — Update a group
• Media files
  • GET /media_files — Lists media files
  • POST /media_files — Add a new media file
  • GET /media_files/trashed — List media files in trash
  • GET /media_files/{id} — Get a single media file
  • DELETE /media_files/{id} — Hard delete a media file
  • PATCH /media_files/{id}/move_to_trash — Move media file to trash
  • PATCH /media_files/{id}/restore — Restore a file that is in trash
• Media folders
  • GET /media_folders — Lists media folders
  • POST /media_folders — Add a new media folder
  • GET /media_folders/{id} — Get a media folder by id
  • DELETE /media_folders/{id} — Remove a media folder
  • PATCH /media_folders/{id} — Update a media folder
• RSS Campaigns
  • GET /rss_campaigns — Lists RSS campaigns
  • POST /rss_campaigns — Add a new RSS campaign
  • GET /rss_campaigns/{id} — Get a RSS campaign by id
  • DELETE /rss_campaigns/{id} — Remove a RSS campaign
  • PATCH /rss_campaigns/{id} — Update a RSS campaign
  • GET /rss_campaigns/{id}/processed_entries — Get RSS campaign's processed entries
• Senders
  • GET /senders — Lists senders
  • POST /senders — Add a new sender
  • GET /senders/{id} — Get a sender by id
  • DELETE /senders/{id} — Remove a sender
  • PATCH /senders/{id} — Update a sender
  • POST /senders/{id}/send_confirmation_email — Send confirmation email
• Sent campaigns
  • GET /sent_campaigns — Lists sent campaigns
  • GET /sent_campaigns/{id} — Get a single sent campaign
  • GET /sent_campaigns/{id}/clicks — Get sent campaign's clicks
  • GET /sent_campaigns/{id}/impressions — Get sent campaign's impressions
  • GET /sent_campaigns/{id}/sent_emails — Get sent campaign's sent emails
  • GET /sent_campaigns/{id}/unsubscribe_events — Get sent campaign's unsubscribe events
  • PATCH /sent_campaigns/{id}/pause — Pause a campaign that is being sent
  • PATCH /sent_campaigns/{id}/resume — Resume a campaign that is paused
  • PATCH /sent_campaigns/{id}/cancel — Cancel a campaign
• SignupForms
  • GET /signup_forms — Lists signup forms
• SMTP emails
  • GET /smtp_emails — Get SMTP emails
  • GET /smtp_emails/{id} — Get an SMTP email by id
• SMTP tags
  • GET /smtp_tags — Lists SMTP tags
• Subscribers
  • GET /subscribers — Get subscribers
  • POST /subscribers — Add a new subscriber
  • GET /subscribers/{id} — Get a subscriber by id
  • DELETE /subscribers/{id} — Remove a subscriber
  • PATCH /subscribers/{id} — Update a subscriber
  • POST /subscribers/{id}/resend_confirmation_email — Resend confirmation email to an inactive subscriber
  • PATCH /subscribers/{id}/ban — Ban a subscriber
  • PATCH /subscribers/{id}/unban — Unban a subscriber
  • GET /subscribers/deleted — Get deleted subscribers
  • PATCH /subscribers/{id}/restore — Restore a deleted subscriber
  • POST /subscribers/sync — Create or update a subscriber
  • PATCH /subscribers/bulk_update — Bulk update subscribers
  • GET /subscribers/{subscriber_id}/tags — Lists a subscriber's tags
  • PUT /subscribers/{subscriber_id}/tags — Replace a subscriber's tags
  • POST /subscribers/{subscriber_id}/tags — Add tags to a subscriber
  • DELETE /subscribers/{subscriber_id}/tags — Remove tags from a subscriber
• Tags
  • GET /tags — Lists tags
  • POST /tags — Add a new tag
  • GET /tags/{id} — Get a tag by id
  • DELETE /tags/{id} — Remove a tag
  • PATCH /tags/{id} — Update a tag
• Unsubscribe events
  • GET /unsubscribe_events — Lists unsubscribe events
  • POST /unsubscribe_events — Add a new unsubscribe event
  • GET /unsubscribe_events/{id} — Get an unsubscribe event by id
  • DELETE /unsubscribe_events/{id} — Remove an unsubscribe event
• Bounces
  • DELETE /bounces — Delete bounces
• General
  • GET /stats — Get stats summary
  • GET /package — Get account package info
  • GET /ping — Ping the API
• API batches
  • GET /api_batches — Lists API batches
  • POST /api_batches — Add a new API batch
  • GET /api_batches/{id} — Get an API batch by id
• Event Subscriptions
  • GET /event_subscriptions — Lists event subscriptions
  • POST /event_subscriptions — Add a new event subscription
  • GET /event_subscriptions/{id} — Get an event subscription by id
  • DELETE /event_subscriptions/{id} — Remove an event subscription
  • PATCH /event_subscriptions/{id} — Update an event subscription
• Send transactional SMS
  • POST /sms/send — Send SMS to one or more recipients
• SMS campaigns
  • GET /sms/campaigns — Lists SMS campaigns
  • POST /sms/campaigns — Add a new SMS campaign
  • GET /sms/campaigns/{id} — Get SMS campaign by id
  • DELETE /sms/campaigns/{id} — Remove SMS campaign
  • PATCH /sms/campaigns/{id} — Update SMS campaign
  • POST /sms/campaigns/{id}/send_all — Send SMS campaign
• SMS sent campaigns
  • GET /sms/sent_campaigns — Lists SMS sent campaigns
  • GET /sms/sent_campaigns/{id} — Get a single SMS sent campaign
  • GET /sms/sent_campaigns/{id}/sent_messages — Get SMS sent campaign's sent messages
  • GET /sms/sent_campaigns/{id}/unsubscribe_events — Get SMS sent campaign's unsubscribe events
  • PATCH /sms/sent_campaigns/{id}/pause — Pause a SMS campaign that is being processed
  • PATCH /sms/sent_campaigns/{id}/resume — Resume a SMS campaign that is paused
  • PATCH /sms/sent_campaigns/{id}/cancel — Cancel a SMS campaign
• SMS sent messages
  • GET /sms/sent_messages — Lists SMS sent messages
  • GET /sms/sent_messages/{id} — Get a single SMS sent message
• Ecommerce Stores
  • GET /ecommerce/stores — Lists ecommerce stores
  • POST /ecommerce/stores — Add a new ecommerce store
  • GET /ecommerce/stores/{id} — Get an ecommerce store by id
  • DELETE /ecommerce/stores/{id} — Remove an ecommerce store
  • PATCH /ecommerce/stores/{id} — Update an ecommerce store
• Ecommerce Product Categories
  • GET /ecommerce/stores/{store_id}/product_categories — Lists product categories
  • POST /ecommerce/stores/{store_id}/product_categories — Add a new product category
  • GET /ecommerce/stores/{store_id}/product_categories/{id} — Get a product category by id
  • DELETE /ecommerce/stores/{store_id}/product_categories/{id} — Remove a product category from a store
  • PATCH /ecommerce/stores/{store_id}/product_categories/{id} — Update a product category
  • POST /ecommerce/stores/{store_id}/product_categories/sync — Create or update a product category
• Ecommerce Products
  • GET /ecommerce/stores/{store_id}/products — Lists products
  • POST /ecommerce/stores/{store_id}/products — Add a new product
  • GET /ecommerce/stores/{store_id}/products/{id} — Get a product by id
  • DELETE /ecommerce/stores/{store_id}/products/{id} — Remove a product
  • PATCH /ecommerce/stores/{store_id}/products/{id} — Update a product
  • POST /ecommerce/stores/{store_id}/products/sync — Create or update a product
• Ecommerce Carts
  • GET /ecommerce/stores/{store_id}/carts — Lists carts
  • POST /ecommerce/stores/{store_id}/carts — Add a new cart
  • GET /ecommerce/stores/{store_id}/carts/{id} — Get a cart by id
  • DELETE /ecommerce/stores/{store_id}/carts/{id} — Remove a cart
  • PATCH /ecommerce/stores/{store_id}/carts/{id} — Update a cart
  • POST /ecommerce/stores/{store_id}/carts/sync — Create or update a cart
• Send transactional WhatsApp messages
  • POST /whatsapp/send — Send WhatsApp messages to one or more recipients
• WhatsApp Phone Numbers
  • GET /whatsapp/phone_numbers — Lists WhatsApp phone numbers
  • GET /whatsapp/phone_numbers/{id} — Get a WhatsApp phone number by id
  • DELETE /whatsapp/phone_numbers/{id} — Remove a WhatsApp phone number
• WhatsApp Templates
  • GET /whatsapp/templates — Lists WhatsApp templates
  • POST /whatsapp/templates — Create a new WhatsApp template
  • GET /whatsapp/templates/{id} — Get a WhatsApp template by id
  • DELETE /whatsapp/templates/{id} — Delete a WhatsApp template
  • PATCH /whatsapp/templates/{id} — Update a WhatsApp template
  • POST /whatsapp/templates/{id}/submit_for_approval — Submit template for approval
• WhatsApp campaigns
  • GET /whatsapp/campaigns — Lists WhatsApp campaigns
  • POST /whatsapp/campaigns — Add a new WhatsApp campaign
  • GET /whatsapp/campaigns/{id} — Get WhatsApp campaign by id
  • DELETE /whatsapp/campaigns/{id} — Remove WhatsApp campaign
  • PATCH /whatsapp/campaigns/{id} — Update WhatsApp campaign
  • POST /whatsapp/campaigns/{id}/send_all — Send WhatsApp campaign
• WhatsApp sent campaigns
  • GET /whatsapp/sent_campaigns — Lists WhatsApp sent campaigns
  • GET /whatsapp/sent_campaigns/{id} — Get a single WhatsApp sent campaign
  • GET /whatsapp/sent_campaigns/{id}/sent_messages — Get WhatsApp sent campaign's sent messages
  • PATCH /whatsapp/sent_campaigns/{id}/pause — Pause a WhatsApp campaign that is being sent
  • PATCH /whatsapp/sent_campaigns/{id}/resume — Resume a WhatsApp campaign that is paused
  • PATCH /whatsapp/sent_campaigns/{id}/cancel — Cancel a WhatsApp campaign
• WhatsApp sent messages
  • GET /whatsapp/sent_messages — Lists WhatsApp sent messages
  • GET /whatsapp/sent_messages/{id} — Get a single WhatsApp sent message
• Connect an assistant
• Permissions & tools
• What you can ask
• Troubleshooting & FAQ