MCP Tool Reference
All tools authenticate using the X-API-Key header you provided in your MCP config. They communicate with the Zyntra API at https://api.zyntra.app. Get your key at app.zyntra.app under Settings → API Keys.
| Tool | Read-only | Destructive |
|---|---|---|
list_emails | Yes | — |
get_email | Yes | — |
get_last_email | Yes | — |
list_attachments | Yes | — |
delete_email | — | Yes |
list_emails
List emails in a Zyntra mailbox with pagination.
Inputs:
| Parameter | Type | Required | Description |
|---|---|---|---|
inbox | string | Yes | Full inbox address, e.g. [email protected] |
skip | number | No | Emails to skip (default: 0) |
limit | number | No | Emails to return, max 100 (default: 20) |
Output: JSON object with items array (email summaries) and total count.
Example prompt:
"List the last 5 emails in [email protected]"
get_email
Get the full content of a specific email including HTML body, plain text, headers, and attachment UUIDs.
Inputs:
| Parameter | Type | Required | Description |
|---|---|---|---|
inbox | string | Yes | Full inbox address |
message_uuid | string | Yes | UUID of the email |
Output: Full EmailDetail object with subject, body, html, headers, attachments_uuid, etc.
Example prompt:
"Get the content of email 550e8400-e29b-41d4-a716-446655440000 in [email protected]"
delete_email
Delete an email from an inbox.
Inputs:
| Parameter | Type | Required | Description |
|---|---|---|---|
inbox | string | Yes | Full inbox address |
message_uuid | string | Yes | UUID of the email to delete |
Output: { "message": "Email deleted" }
Example prompt:
"Delete all emails in [email protected] after the test passes"
get_last_email
Retrieve the most recently received email for an inbox. Uses Redis for fast lookup — ideal for polling in automation flows.
Inputs:
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Full inbox address |
Output: EmailSummary object with uuid, subject, from_address, preview, received_at.
Example prompt:
"Get the last email in [email protected] and extract the verification code"
list_attachments
List all attachments for a specific email. Returns metadata for each attachment (filename, MIME type, ID) — use the attachment ID to download via the REST API directly.
Inputs:
| Parameter | Type | Required | Description |
|---|---|---|---|
message_uuid | string | Yes | UUID of the email |
Output: Array of Attachment objects with id, filename, mime_type, uploaded_at.
Example prompt:
"List the attachments in email 550e8400-e29b-41d4-a716-446655440000"