Ver en español

MCP Server

We currently grant access to the MCP server on a case-by-case basis. To request access, email hello@preflight.qa.

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
  1. Add a remote MCP server in your assistant’s settings using the URL above.
  2. Enter the OAuth client ID supplied by Preflight when we grant access.
  3. 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.

TaskCost
Take screenshots1 credit per email app and mode
Check account limits, list email apps, or read resultsFree

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.

ToolWhat it does
get_account_limitsShows the organisation’s credit allowance and rate limits.
list_email_clientsLists email apps and modes you can test.
start_email_renderingStarts a screenshot test.
get_email_test_resultsGets 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 queued to running, then completed, partial_failure, or failed.
  • stalled means 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.