> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trysiren.io/llms.txt
> Use this file to discover all available pages before exploring further.

# QuickSend

> To send notification directly without setting up a workflow.

Need to send a critical update or one-off announcement? You can use Siren to send a notification without setting up a workflow. This lets you directly send messages to a user over your desired channel.
To send a message, you just need to include the channel, recipient details (matching that channel), and optionally a template name with variables, as shown below. The request must be authorized using your API key.
Once sent, Siren will return a `notificationId`, which you can use to check the message status or fetch replies
Here's a simplified example:

```json theme={null}
{
  "channel": "EMAIL",
  "recipient": {
    "email": "user@example.com"
  },
  "template": {
    "name": "welcome_template"
  },
  "templateVariables": {
    "firstName": "John",
    "offerCode": "ABCD123"
  }
}
```

> [!NOTE]
>
> If you are not using the default provider configured in the Siren account, you can specify which provider to use by adding the `providerIntegration` field in the request. Please take a look at [API Reference](https://docs.trysiren.io/docs/API-Reference/CreateProviderIntegrationAPI.md) for the details.

Once a message is sent, you can use the following endpoints to track it:

* `GET /message-status/{notificationId}` - Check whether the message was delivered, failed, or is still pending.
* `GET /get-reply/{notificationId}` - Fetch replies to a message (currently supported for Slack only). This includes main messages and threaded responses from users.
  These endpoints help you build a full feedback loop between your system, the provider, and the user. For the complete details, refer to  [API Reference](https://docs.trysiren.io/docs/API-Reference/GetMessageRepliesAPI.md).
  You can also send notifications using **MCP**, **AI Agent Toolkit**, or **SDK**, depending on your system architecture.

### Using MCP (Model Context Protocol)

If you are using MCP to send a notification quickly, follow these steps:

**1. Install or run the MCP server**

You can either install it globally using `npm install -g @trysiren/mcp`, or run it directly with `npx -y @trysiren/mcp`.

**2. Start the server with messaging tool enabled**

Run the following command to enable the QuickSend tool:\
`npx -y @trysiren/mcp --tools=messaging.send --api-key=YOUR_SIREN_API_KEY`

**3. Configure your development environment**

Connect your MCP-compatible environment (e.g., Claude, VS Code, Replit, Cursor) to the running MCP server.\
Refer to the [MCP documentation](https://docs.trysiren.io/docs/AI-Agent-Toolkit/MCP/Overview.md) for environment-specific setup.

**4. Call the `messaging.send` tool**

Once configured, use your assistant or client to trigger a notification using the `messaging.send` method — no workflow setup required.

**5. Track message status**

Use tools like `messaging.getStatus` or the `/message-status/{id}` endpoint to monitor delivery.

### Using AI Agent Toolkit

If you are using AI Agent toolkit to send a notification quickly, follow these steps:

**1. Install the Agent Toolkit**

Install the SDK using your preferred package manager:\
`npm install @trysiren/agent-toolkit`\
or\
`yarn add @trysiren/agent-toolkit`

**2. Initialize the toolkit with your API key**

Import `SirenToolkit` and pass your API key during initialization.\
You can optionally configure the messaging tool permissions.

**3. Expose tools to your AI framework**

Use the `getTools()` method to expose Siren tools (like `send_message`) to frameworks like OpenAI, LangChain, or Vercel AI SDK.

**4. Trigger messages using `send_message` tool**

The agent can now use function calls to send notifications on supported channel,— just like an API or MCP request.

**5. Monitor delivery with `get_message_status` or logs**

Use status-checking tools within the agent environment, or fallback to Siren’s tracking endpoints and logs.

Refer to the [AI Agent Toolkit documentation](https://docs.trysiren.io/docs/AI-Agent-Toolkit/AI%20Agent%20Toolkit) for full implementation details.

### Using SDK

If you are using the Siren SDK to send a notification quickly, follow these steps:

**1. Install the SDK**

```python theme={null}
pip install trysiren
```

**2. Initialize the client**

```python theme={null}
from siren import SirenClient
client = SirenClient()  # Uses SIREN_API_KEY from environment
```

**3. Send a message**

```python theme={null}
client.message.send(
    recipient_value="user@example.com",
    channel="EMAIL",
    template_name="welcome_template",
    template_variables={
        "firstName": "John",
        "offerCode": "ABCD123"
    }
)
```

**4. (Optional) Track delivery status**

```python theme={null}
client.message.get_status("notificationId")
```

> [!NOTE]
>
> This example demonstrates usage with the Python SDK. Siren also provides a TypeScript SDK, and the same procedures can be followed using TypeScript as well. For details on the TypeScript SDK and complete SDK usage, refer to the [SDK Documentation](https://docs.trysiren.io/docs/SDK/backend/python-sdk.md).

For more complex orchestration, you can utilise the workflow editor and start designing your own [notification workflow](https://docs.trysiren.io/docs/Workflow/CreatingWorkflow.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.