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

MCP reference

Automation tools

sendmock_ai_agents

For each AI agent, the install command and its MCP configuration.

Toolset core.

  • Read only
InputTypeDescription
targetstring
Only this agent.One of: claude-code, codex, cursor, gemini, vscodeExample: claude-code

Example call

{
  "name": "sendmock_ai_agents",
  "arguments": {
    "target": "claude-code"
  }
}

Result: AiAgentSetup[]

API
GET/api/v1/ai/agents
CLI
sendmock ai install --target <agent>
In the app
Settings > Connection > AI agents

sendmock_events_recent

The latest events, newest first: the polling twin of the live stream.

Toolset core.

  • Read only
InputTypeDescription
sincestring
Only events newer than this time.Example: 2026-10-26T09:30:00Z
typestring
An event type, e.g. http.captured.Example: http.captured
limitinteger
At most this many (default 50).Example: 50
projectstring
Only events about this project's emails, SMS and verifications (its key); every event when not set.Example: shop

Example call

{
  "name": "sendmock_events_recent",
  "arguments": {
    "since": "2026-10-26T09:30:00Z",
    "type": "http.captured"
  }
}

Result: AppEvent[]

API
GET/api/v1/events/recent
CLI
sendmock events tail
In the app
Notification bell

sendmock_integration_snippet

Copy-ready settings for a stack, as Settings > Connection shows them.

Toolset core.

  • Read only
InputTypeDescription
stackrequiredstring
Your app's stack: a language (laravel, node, python, go, java, ruby, dotnet, curl) or a framework (php, express, nestjs, django, flask, fastapi, spring, rails, aspnet).Example: laravel
channelstring
email, sms or http (default email).Example: email
hoststring
Where the app runs: local, docker-host or compose.Example: local

Example call

{
  "name": "sendmock_integration_snippet",
  "arguments": {
    "stack": "laravel",
    "channel": "email",
    "host": "local"
  }
}

Result: IntegrationSnippet

API
GET/api/v1/integrations/{stack}
CLI
sendmock integrate <stack>
In the app
Settings > Connection

sendmock_scenario_run

Run a scenario file step by step and report each step.

Toolset scenario.

    InputTypeDescription
    scenariorequiredstring
    The scenario file's text, in TOML.Example: name = "otp-login" [[steps]] run = "sample.send" with = { kind = "sms" }

    Example call

    {
      "name": "sendmock_scenario_run",
      "arguments": {
        "scenario": "name = \"otp-login\"\n\n[[steps]]\nrun = \"sample.send\"\nwith = { kind = \"sms\" }"
      }
    }

    Result: ScenarioReport

    API
    POST/api/v1/scenarios/run
    CLI
    sendmock scenario run <file>
    In the app
    Scenarios > Run

    sendmock_scenario_validate

    Check a scenario file without running it.

    Toolset scenario.

    • Read only
    InputTypeDescription
    scenariorequiredstring
    The scenario file's text, in TOML.Example: name = "otp-login" [[steps]] run = "sample.send" with = { kind = "sms" }

    Example call

    {
      "name": "sendmock_scenario_validate",
      "arguments": {
        "scenario": "name = \"otp-login\"\n\n[[steps]]\nrun = \"sample.send\"\nwith = { kind = \"sms\" }"
      }
    }

    Result: ScenarioValidation

    API
    POST/api/v1/scenarios/validate
    CLI
    sendmock scenario validate <file>
    In the app
    Scenarios > Validate

    sendmock://docs/skill

    The SendMock agent skill as Markdown.

    Resource, read as text/markdown.

    API
    GET/api/v1/ai/skill
    CLI
    sendmock ai skill
    In the app
    Settings > Connection > AI agents > Download the skill