Preview: SendMock has no stable release yet. These docs follow develop.

MCP reference

Tag rules tools

sendmock_tag_rule_create

Add a tag rule at the end of the list.

Toolset rules.

    InputTypeDescription
    namerequiredstring
    A name for the rule, shown in the list.Example: Tag password resets
    filterobject
    The webhook rule filter, over email fields; null matches every email.
    tagrequiredstring
    The tag added to each matching email.Example: password-reset
    is_enabledrequiredboolean
    Off rules are kept but skipped.Example: true

    Example call

    {
      "name": "sendmock_tag_rule_create",
      "arguments": {
        "name": "Tag password resets",
        "tag": "password-reset",
        "is_enabled": true
      }
    }

    Result: TagRule

    API
    POST/api/v1/tag-rules
    CLI
    sendmock email tag-rules create
    In the app
    Settings > Email > Tag rules > Add rule

    sendmock_tag_rule_delete

    Delete a tag rule.

    Toolset rules.

    • Destructive
    • Idempotent
    InputTypeDescription
    rule_idrequiredstring
    The rule's ID, from the list of rules of the same kind.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D

    Example call

    {
      "name": "sendmock_tag_rule_delete",
      "arguments": {
        "rule_id": "01JB7T9Q2R5W8X3Y6Z1A4B7C9D"
      }
    }

    Result: nothing

    API
    DELETE/api/v1/tag-rules/{ruleId}
    CLI
    sendmock email tag-rules delete <ruleId>
    In the app
    Settings > Email > Tag rules > Delete

    sendmock_tag_rule_list

    Every tag rule, in the order they run.

    Toolset rules.

    • Read only

    No inputs.

    Example call

    {
      "name": "sendmock_tag_rule_list",
      "arguments": {}
    }

    Result: TagRule[]

    API
    GET/api/v1/tag-rules
    CLI
    sendmock email tag-rules list
    In the app
    Settings > Email > Tag rules

    sendmock_tag_rule_move

    Move a tag rule up or down.

    Toolset rules.

      InputTypeDescription
      rule_idrequiredstring
      The rule's ID, from the list of rules of the same kind.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D
      directionrequiredstring
      up moves the rule one place earlier in the order, down one place later.One of: up, downExample: up

      Example call

      {
        "name": "sendmock_tag_rule_move",
        "arguments": {
          "rule_id": "01JB7T9Q2R5W8X3Y6Z1A4B7C9D",
          "direction": "up"
        }
      }

      Result: TagRule[]

      API
      POST/api/v1/tag-rules/{ruleId}/move
      CLI
      sendmock email tag-rules move <ruleId>
      In the app
      Settings > Email > Tag rules > Move up, Move down

      sendmock_tag_rule_update

      Change a tag rule, or switch it on or off.

      Toolset rules.

      • Idempotent
      InputTypeDescription
      rule_idrequiredstring
      The rule's ID, from the list of rules of the same kind.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D
      namestring
      A name for the rule, shown in the list.Example: Tag password resets
      filterobject
      The webhook rule filter, over email fields; null matches every email.
      tagstring
      The tag added to each matching email.Example: password-reset
      is_enabledboolean
      Off rules are kept but skipped.Example: true

      Example call

      {
        "name": "sendmock_tag_rule_update",
        "arguments": {
          "rule_id": "01JB7T9Q2R5W8X3Y6Z1A4B7C9D",
          "name": "Tag password resets",
          "tag": "password-reset"
        }
      }

      Result: TagRule

      API
      PATCH/api/v1/tag-rules/{ruleId}
      CLI
      sendmock email tag-rules update <ruleId>
      In the app
      Settings > Email > Tag rules > Edit, enabled switch