Siren Model Context Protocol Server

The Siren Model Context Protocol server allows you to integrate with Siren APIs through function calling. This protocol supports various tools to interact with Siren's messaging, templates, users, workflows, and webhooks.

Quick Start

To run the Siren MCP server using npx, use the following command:

# To set up all available tools
npx -y @trysiren/mcp --tools=all --api-key=YOUR_SIREN_API_KEY

# To set up specific tools
npx -y @trysiren/mcp --tools=messaging.send,templates.list,workflows.trigger --api-key=YOUR_SIREN_API_KEY

Make sure to replace YOUR_SIREN_API_KEY with your actual Siren API key. Alternatively, you could set the SIREN_API_KEY in your environment variables.

Client Setup

Claude Desktop

Add the following to your claude_desktop_config.json. See here for more details.

{
  "mcpServers": {
    "siren": {
      "command": "npx",
      "args": [
        "-y",
        "@siren/mcp",
        "--tools=all",
        "--api-key=YOUR_SIREN_API_KEY"
      ]
    }
  }
}

Or if you're using Docker:

{
  "mcpServers": {
    "siren": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "siren/mcp",
        "--tools=all",
        "--api-key=YOUR_SIREN_API_KEY"
      ]
    }
  }
}

VS Code

Workspace Configuration

Add a .vscode/mcp.json file in your workspace:

{
  "mcp": {
    "servers": {
      "siren": {
        "command": "npx",
        "args": [
          "-y",
          "@siren/mcp",
          "--tools=messaging.send,templates.list,workflows.trigger",
          "--api-key=YOUR_SIREN_API_KEY"
        ]
      }
    }
  }
}

User Settings

Add to your VS Code user settings:

{
  "mcp.servers": {
    "siren": {
      "command": "npx",
      "args": [
        "-y",
        "@siren/mcp",
        "--tools=all",
        "--api-key=YOUR_SIREN_API_KEY"
      ]
    }
  }
}

Cursor

Cursor uses the same configuration format as VS Code. Add to your settings:

{
  "mcp.servers": {
    "siren": {
      "command": "npx",
      "args": [
        "-y",
        "@siren/mcp",
        "--tools=all",
        "--api-key=YOUR_SIREN_API_KEY"
      ]
    }
  }
}

Amazon Q CLI

Configure Amazon Q CLI to use the Siren MCP server:

q configure mcp add-server siren \
  --command "npx" \
  --args "-y,@siren/mcp,--tools=all,--api-key=YOUR_SIREN_API_KEY"

Other MCP Clients

The Siren MCP server is compatible with any MCP client. Here are some popular ones:

5ire Desktop

Configure in 5ire's MCP settings:

{
  "servers": {
    "siren": {
      "command": "npx",
      "args": ["-y", "@siren/mcp", "--tools=all", "--api-key=YOUR_SIREN_API_KEY"]
    }
  }
}

FLUJO

Add to FLUJO's workflow configuration:

{
  "mcp_servers": {
    "siren": {
      "command": "npx -y @siren/mcp --tools=all --api-key=YOUR_SIREN_API_KEY"
    }
  }
}

Zed Editor

Configure in Zed's assistant settings:

{
  "assistant": {
    "mcp_servers": {
      "siren": {
        "command": "npx",
        "args": ["-y", "@siren/mcp", "--tools=all", "--api-key=YOUR_SIREN_API_KEY"]
      }
    }
  }
}

Replit

Add to your Replit project's MCP configuration:

{
  "mcp": {
    "servers": {
      "siren": "npx -y @siren/mcp --tools=all --api-key=YOUR_SIREN_API_KEY"
    }
  }
}

Codeium

Configure in Codeium's extensions:

{
  "mcp.servers.siren": {
    "command": "npx",
    "args": ["-y", "@siren/mcp", "--tools=all", "--api-key=YOUR_SIREN_API_KEY"]
  }
}

Available Tools

Tool Categories

You can use predefined tool categories for easier configuration:

• Communication: messaging.send, messaging.getStatus, messaging.getReplies
• Content: templates.list, templates.create, templates.update, templates.delete, templates.publish
• Identity: users.add, users.update, users.delete
• Automation: workflows.trigger, workflows.triggerBulk, workflows.schedule
• Integration: webhooks.configureNotification, webhooks.configureInbound

Configuration Options

API Key Format

Siren supports multiple API key formats:

• sk_siren_... - Standard Siren API key
• sk_test_... - Test environment key
• sk_live_... - Production environment key

Workspace Configuration

If you're working with multiple Siren workspaces, specify the workspace ID:

npx @siren/mcp --tools=all --api-key=YOUR_API_KEY --workspace=ws_your_workspace_id

Environment Variables

You can set environment variables instead of passing API keys as arguments:

export SIREN_API_KEY=sk_siren_your_api_key
npx @siren/mcp --tools=all

Debugging

Using MCP Inspector

To debug your server, you can use the MCP Inspector.

First, build the server:

npm run build

Run the following command in your terminal:

# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js --tools=all --api-key=YOUR_SIREN_API_KEY

Docker Debugging

First, build the Docker image:

docker build -t siren/mcp .

Run with MCP Inspector:

docker run -p 3000:3000 -p 5173:5173 -v /var/run/docker.sock:/var/run/docker.sock \
  mcp/inspector docker run --rm -i siren/mcp --tools=all --api-key=YOUR_SIREN_API_KEY

Health Check

Test your configuration with a simple health check:

npx @siren/mcp --tools=messaging.send --api-key=YOUR_SIREN_API_KEY

If the server starts successfully, you'll see:

✅ Siren MCP Server running on stdio

Troubleshooting

Common Issues

1. Invalid API Key Format

   • Ensure your API key starts with sk_siren_, sk_test_, or sk_live_
   • Check that the key is correctly set in your environment or arguments

2. Tool Not Found

   • Verify the tool name matches exactly (case-sensitive)
   • Check the available tools list above

3. Connection Issues

   • Ensure you have an active internet connection
   • Check if your firewall is blocking the connection
   • Verify the Siren API endpoint is accessible

4. Permission Denied

   • Verify your API key has the necessary permissions for the tools you're using
   • Check your workspace access if using workspace-specific tools

Getting Help

For additional support:

• Visit the Siren Documentation
• Check the Model Context Protocol Documentation
• Open an issue on the Siren Agent Toolkit repository

Examples

Basic Messaging

# Configure for basic messaging
npx @siren/mcp --tools=messaging.send,messaging.getStatus --api-key=YOUR_API_KEY

Template Management

# Configure for template operations
npx @siren/mcp --tools=templates.list,templates.create,templates.update --api-key=YOUR_API_KEY

Workflow Automation

# Configure for workflow automation
npx @siren/mcp --tools=workflows.trigger,workflows.schedule --api-key=YOUR_API_KEY

Full Access

# Configure all available tools
npx @siren/mcp --tools=all --api-key=YOUR_API_KEY