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

MCP reference

Push tools

sendmock_push_delete

Delete one push notification.

Toolset core.

  • Destructive
  • Idempotent
InputTypeDescription
push_idrequiredstring
The notification's id, from GET /api/v1/push.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D

Example call

{
  "name": "sendmock_push_delete",
  "arguments": {
    "push_id": "01JB7T9Q2R5W8X3Y6Z1A4B7C9D"
  }
}

Result: nothing

API
DELETE/api/v1/push/{pushId}
CLI
sendmock push delete <pushId>
In the app
Push > open a notification > Delete

sendmock_push_delete_all

Delete every push notification, or one project's.

Toolset core.

  • Destructive
  • Idempotent
InputTypeDescription
projectstring
Only this project's notifications (its key); every project's when not set.Example: shop
device_tokenstring
Only notifications to this device token.Example: dQw4w9WgXcQ:APA91bE1
providerstring
fcm, expo or onesignal.One of: fcm, expo, onesignalExample: fcm
statusstring
sent or failed.One of: sent, failedExample: sent

Example call

{
  "name": "sendmock_push_delete_all",
  "arguments": {
    "project": "shop",
    "device_token": "dQw4w9WgXcQ:APA91bE1"
  }
}

Result: nothing

API
DELETE/api/v1/push
CLI
sendmock push clear
In the app
Push > Clear all

sendmock_push_get

One push notification with its request and answer.

Toolset core.

  • Read only
InputTypeDescription
push_idrequiredstring
The notification's id, from GET /api/v1/push.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D

Example call

{
  "name": "sendmock_push_get",
  "arguments": {
    "push_id": "01JB7T9Q2R5W8X3Y6Z1A4B7C9D"
  }
}

Result: PushNotification

API
GET/api/v1/push/{pushId}
CLI
sendmock push show <pushId>
In the app
Push > open a notification

sendmock_push_list

Push notifications, newest first, with filters.

Toolset core.

  • Read only
InputTypeDescription
cursorstring
The next_cursor of the previous page.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D
limitinteger
Items per page, 1 to 200 (default 50).Example: 50
projectstring
Only this project's notifications (its key); every project's when not set.Example: shop
device_tokenstring
Only notifications to this device token.Example: dQw4w9WgXcQ:APA91bE1
providerstring
fcm, expo or onesignal.One of: fcm, expo, onesignalExample: fcm
statusstring
sent or failed.One of: sent, failedExample: sent

Example call

{
  "name": "sendmock_push_list",
  "arguments": {
    "cursor": "01JB7T9Q2R5W8X3Y6Z1A4B7C9D",
    "limit": 50
  }
}

Result: PageOf_PushNotification

API
GET/api/v1/push
CLI
sendmock push list
In the app
Push

sendmock_push_wait

Wait until a matching push notification arrives; 408 on timeout.

Toolset core.

  • Read only
InputTypeDescription
device_tokenstring
The device token.Example: dQw4w9WgXcQ:APA91bE1
projectstring
Only this project's notifications (its key); every project's when not set.Example: shop
sincestring
Only notifications sent after this time (default: 30 s ago).Example: 2026-11-07T10:00:00Z
timeoutstring
How long to wait, e.g. 10s (default 10s, at most 60s).Example: 10s

Example call

{
  "name": "sendmock_push_wait",
  "arguments": {
    "device_token": "dQw4w9WgXcQ:APA91bE1",
    "project": "shop"
  }
}

Result: PushNotification

API
GET/api/v1/wait/push
CLI
sendmock push wait
In the app
Push (new notifications appear live)