← Files MailrithARCHIVED FILE

mailrith-mcp-contract.json

20.1 KB · Nov 21, 2026 · 00:11 UTC

↓ Download file

See the change to this file →

{
  "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