Overview
Connect Preflight to a compatible AI assistant or coding agent to see how your email looks in real inboxes. Request screenshots for different email apps in light or dark mode, then review them as you refine your draft.
Connect to Preflight
You need a Preflight account with administrator access to your organisation, plus an assistant that supports MCP, such as ChatGPT.
Server URL
https://mcp.preflight.qa
- Add a remote MCP server in your assistant’s settings using the URL above.
- Enter the OAuth client ID supplied by Preflight when we grant access.
- Sign in to Preflight, choose your organisation, and approve the connection. Your assistant can now request screenshots using that organisation’s credits.
What does it cost?
MCP uses the same screenshot credits as the Preflight API, at the same rate. There’s no additional fee for using MCP.
| Task | Cost |
|---|---|
| Take screenshots | 1 credit per email app and mode |
| Check account limits, list email apps, or read results | Free |
Apple Mail in light and dark mode costs 2 credits. Preflight charges credits when it accepts the screenshot request.
See Preflight pricing for monthly allowances and add-ons.
Test an email
Give your assistant the email’s HTML, pasted into chat or attached as a file. A website link alone will not work.
Show me how this email looks in Apple Mail in light and dark mode.
Your assistant requests the screenshots and checks their progress. Open the screenshot gallery when it’s available to compare the results.
After making changes, ask for a new screenshot test to compare the updated draft. Each new run uses more credits.
Tools your assistant uses
Your assistant chooses these tools for you. You do not need to call them yourself.
| Tool | What it does |
|---|---|
get_account_limits | Shows the organisation’s credit allowance and rate limits. |
list_email_clients | Lists email apps and modes you can test. |
start_email_rendering | Starts a screenshot test. |
get_email_test_results | Gets screenshot progress and available image and gallery links. |
Tool inputs for developers
list_email_clients takes no arguments. Use the client IDs and modes it returns in start_email_rendering:
{
"subject": "Spring launch",
"html": "<html lang=\"en\"><body><h1>Spring launch</h1></body></html>",
"clients": [
{ "id": "apple_mail_mac", "modes": ["light", "dark"] }
],
"idempotency_key": "spring-launch-screenshots-1"
}
Pass the returned test_id to get_email_test_results. Follow poll_after_seconds when checking progress.
The idempotency_key is a retry key. Reuse it with identical input within 24 hours to get the original run without another charge. Use a new key when the input changes. An expired key can start a new paid run.
Understanding results
Screenshots can finish at different times. Your assistant can show which are ready and which failed, and report the credits charged for the run.
If a test fails to finish, ask your assistant to check its status before starting another paid run. A screenshot test can also return some images while others fail.
Technical limits and statuses
- Runs move from
queuedtorunning, thencompleted,partial_failure, orfailed. stalledmeans no activity for ten minutes. Polling reports the status of the existing run.- HTML is limited to 1 MiB of UTF-8 text. The full JSON request is limited to 8 MiB.
- Default limits are 12 requests per minute and one new screenshot test per 45 seconds. Your organisation’s limits may differ. Up to two MCP requests can run at once per organisation.
- On a rate-limit response, wait for the suggested retry interval. Results are collected by polling; custom webhooks are not supported.
- The server uses Streamable HTTP and OAuth with a registered client. Automatic client registration is not supported. Your assistant refreshes access tokens without asking you to reconnect.
- Usage history includes accepted runs, even if still running or failed. Free retries add no usage. API-key activity and other connections are excluded.
Your connection and data
Each connection works with one organisation and stays active until you disconnect it. You must remain an administrator to use it. To use another organisation, create another connection.
In Manage Organisation → App Connections, you can see each connection’s screenshots and credits used over the last 30 days, or disconnect it. The connection also stops when your subscription ends.
Screenshot links last up to 7 days after the image is captured. Download any images you want to keep. Disconnecting blocks new opens of those links.
Submitted HTML and screenshots are kept for 30 days, or deleted within five calendar days after your subscription ends if sooner.
Need help? Email hello@preflight.qa.