← Files MailrithARCHIVED FILE
mailrith-mcp-contract.json
20.1 KB · Nov 21, 2026 · 00:11 UTC
{
"schema_version": 1,
"profile": "submitted",
"contract_version": "1.0",
"source_contract_version": "v1",
"source_schema_digest": "sha256:59ecc1d2ca7da2151a7d9275e9144d26c54c5ff1fe3cc91b734daf4a42e80631",
"submitted_schema_digest": "sha256:d64c63049e5820ea4cdb07d1348d549a78b90eee212221b5ba28cd882adf4d9a",
"mcp_server_url": "https://api.mailrith.com/mcp",
"tool_count": 55,
"tools": [
{
"operation_id": "getPublicApiCapabilities",
"name": "discovery_get_capabilities",
"required_scopes": [],
"annotations": {
"title": "Get authenticated API capabilities",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "getWorkspace",
"name": "workspace_get",
"required_scopes": [
"workspace:read"
],
"annotations": {
"title": "Get the current workspace",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "listSenderIdentities",
"name": "sender_identities_list",
"required_scopes": [
"workspace:read"
],
"annotations": {
"title": "List sender identities",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "getSenderIdentity",
"name": "sender_identities_get",
"required_scopes": [
"workspace:read"
],
"annotations": {
"title": "Get a sender identity",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "createAnalyticsReport",
"name": "analytics_create_report",
"required_scopes": [
"analytics:read"
],
"annotations": {
"title": "Create or reuse an analytics report",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"operation_id": "getAnalyticsReport",
"name": "analytics_get_report",
"required_scopes": [
"analytics:read"
],
"annotations": {
"title": "Get an analytics report",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "listSubscribers",
"name": "subscribers_list",
"required_scopes": [
"subscribers:read"
],
"annotations": {
"title": "List subscribers",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "getSubscriber",
"name": "subscribers_get",
"required_scopes": [
"subscribers:read"
],
"annotations": {
"title": "Get a subscriber",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "upsertSubscriber",
"name": "subscribers_upsert",
"required_scopes": [
"live_actions:write",
"subscribers:write"
],
"annotations": {
"title": "Create or upsert a subscriber",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"operation_id": "updateSubscriber",
"name": "subscribers_update",
"required_scopes": [
"subscribers:write"
],
"annotations": {
"title": "Update a subscriber",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "updateSubscriberStatus",
"name": "subscribers_update_status",
"required_scopes": [
"live_actions:write",
"subscribers:write"
],
"annotations": {
"title": "Change Subscriber sending eligibility",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "addSubscriberTag",
"name": "subscribers_add_tag",
"required_scopes": [
"live_actions:write",
"subscribers:write"
],
"annotations": {
"title": "Add a Tag to a Subscriber",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "removeSubscriberTag",
"name": "subscribers_remove_tag",
"required_scopes": [
"live_actions:write",
"subscribers:write"
],
"annotations": {
"title": "Remove a tag from a subscriber",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "addSubscriberSequence",
"name": "subscribers_add_to_sequence",
"required_scopes": [
"live_actions:write",
"subscribers:write"
],
"annotations": {
"title": "Add a subscriber to a sequence",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "removeSubscriberSequence",
"name": "subscribers_remove_from_sequence",
"required_scopes": [
"live_actions:write",
"subscribers:write"
],
"annotations": {
"title": "Remove a subscriber from a sequence",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "listTags",
"name": "tags_list",
"required_scopes": [
"tags:read"
],
"annotations": {
"title": "List tags",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "getTag",
"name": "tags_get",
"required_scopes": [
"tags:read"
],
"annotations": {
"title": "Get a tag",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "createTag",
"name": "tags_create",
"required_scopes": [
"tags:write"
],
"annotations": {
"title": "Create a tag",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"operation_id": "listCustomFields",
"name": "custom_fields_list",
"required_scopes": [
"custom_fields:read"
],
"annotations": {
"title": "List custom fields",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "getCustomField",
"name": "custom_fields_get",
"required_scopes": [
"custom_fields:read"
],
"annotations": {
"title": "Get a custom field",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "listSegments",
"name": "segments_list",
"required_scopes": [
"segments:read"
],
"annotations": {
"title": "List segments",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "getSegment",
"name": "segments_get",
"required_scopes": [
"segments:read"
],
"annotations": {
"title": "Get a segment",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "previewSegment",
"name": "segments_preview",
"required_scopes": [
"segments:read"
],
"annotations": {
"title": "Preview a segment definition",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "listBroadcasts",
"name": "broadcasts_list",
"required_scopes": [
"broadcasts:read"
],
"annotations": {
"title": "List broadcasts",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "createBroadcast",
"name": "broadcasts_create",
"required_scopes": [
"broadcasts:write"
],
"annotations": {
"title": "Create a broadcast",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"operation_id": "getBroadcast",
"name": "broadcasts_get",
"required_scopes": [
"broadcasts:read"
],
"annotations": {
"title": "Get a broadcast",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "updateBroadcast",
"name": "broadcasts_update",
"required_scopes": [
"broadcasts:write"
],
"annotations": {
"title": "Update a broadcast",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "preflightBroadcast",
"name": "broadcasts_preflight",
"required_scopes": [
"broadcasts:read"
],
"annotations": {
"title": "Inspect broadcast readiness",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "testBroadcast",
"name": "broadcasts_send_test",
"required_scopes": [
"live_actions:write",
"subscribers:read",
"broadcasts:write"
],
"annotations": {
"title": "Send a broadcast test email",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"operation_id": "scheduleBroadcast",
"name": "broadcasts_schedule",
"required_scopes": [
"live_actions:write",
"broadcasts:write"
],
"annotations": {
"title": "Schedule or reschedule a broadcast",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "unscheduleBroadcast",
"name": "broadcasts_unschedule",
"required_scopes": [
"live_actions:write",
"broadcasts:write"
],
"annotations": {
"title": "Unschedule a broadcast",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "sendBroadcast",
"name": "broadcasts_send",
"required_scopes": [
"live_actions:write",
"broadcasts:write"
],
"annotations": {
"title": "Send a broadcast now",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"operation_id": "cancelBroadcastSend",
"name": "broadcasts_cancel",
"required_scopes": [
"live_actions:write",
"broadcasts:write"
],
"annotations": {
"title": "Cancel a broadcast send",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"operation_id": "getBroadcastSendProgress",
"name": "broadcasts_get_send_progress",
"required_scopes": [
"broadcasts:read"
],
"annotations": {
"title": "Get broadcast send progress",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "listSequences",
"name": "sequences_list",
"required_scopes": [
"sequences:read"
],
"annotations": {
"title": "List sequences",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "createSequence",
"name": "sequences_create",
"required_scopes": [
"sequences:write"
],
"annotations": {
"title": "Create a sequence",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"operation_id": "getSequence",
"name": "sequences_get",
"required_scopes": [
"sequences:read"
],
"annotations": {
"title": "Get a sequence",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "updateSequence",
"name": "sequences_update",
"required_scopes": [
"sequences:write"
],
"annotations": {
"title": "Update a sequence",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "preflightSequence",
"name": "sequences_preflight",
"required_scopes": [
"sequences:read"
],
"annotations": {
"title": "Check sequence readiness",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "previewSequenceJourney",
"name": "sequences_preview_journey",
"required_scopes": [
"subscribers:read",
"sequences:read"
],
"annotations": {
"title": "Preview a sequence journey",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "testSequence",
"name": "sequences_send_test",
"required_scopes": [
"live_actions:write",
"subscribers:read",
"sequences:write"
],
"annotations": {
"title": "Send sequence test messages",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"operation_id": "updateSequenceStatus",
"name": "sequences_update_status",
"required_scopes": [
"live_actions:write",
"sequences:write"
],
"annotations": {
"title": "Activate or pause a sequence",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "listAutomations",
"name": "automations_list",
"required_scopes": [
"automations:read"
],
"annotations": {
"title": "List automations",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "createAutomation",
"name": "automations_create",
"required_scopes": [
"automations:write"
],
"annotations": {
"title": "Create an automation",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"operation_id": "getAutomation",
"name": "automations_get",
"required_scopes": [
"automations:read"
],
"annotations": {
"title": "Get an automation",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "updateAutomation",
"name": "automations_update",
"required_scopes": [
"automations:write"
],
"annotations": {
"title": "Update an automation",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "preflightAutomation",
"name": "automations_preflight",
"required_scopes": [
"automations:read"
],
"annotations": {
"title": "Check automation readiness",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "previewAutomationJourney",
"name": "automations_preview_journey",
"required_scopes": [
"subscribers:read",
"automations:read"
],
"annotations": {
"title": "Preview an automation journey",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "testAutomation",
"name": "automations_send_test",
"required_scopes": [
"live_actions:write",
"subscribers:read",
"automations:write"
],
"annotations": {
"title": "Send automation test messages",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"operation_id": "updateAutomationStatus",
"name": "automations_update_status",
"required_scopes": [
"live_actions:write",
"automations:write"
],
"annotations": {
"title": "Change an automation status",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"operation_id": "listEmailTemplates",
"name": "email_templates_list",
"required_scopes": [
"email_templates:read"
],
"annotations": {
"title": "List email templates",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "createEmailTemplate",
"name": "email_templates_create",
"required_scopes": [
"email_templates:write"
],
"annotations": {
"title": "Create an email template",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"operation_id": "getEmailTemplate",
"name": "email_templates_get",
"required_scopes": [
"email_templates:read"
],
"annotations": {
"title": "Get an email template",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "previewEmailTemplate",
"name": "email_templates_preview",
"required_scopes": [
"subscribers:read",
"email_templates:read"
],
"annotations": {
"title": "Preview an email template for a Subscriber",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"operation_id": "updateEmailTemplate",
"name": "email_templates_update",
"required_scopes": [
"email_templates:write"
],
"annotations": {
"title": "Update an email template",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
}
]
}
SHA-256: f4bd4fb25f0db8effebecba6db105e7fac7912598d26d5415a81d403e5c13cde