Siren Model Context Protocol Server

The Siren Model Context Protocol server enables seamless integration with Siren APIs through function calling. This protocol provides a comprehensive suite of tools for interacting with Siren's messaging, templates, users, workflows, and webhooks systems.

🚀 Quick Start

📋 Requirements

• A Siren API key (get one from Siren Dashboard)

Installation

# Install globally
npm install -g @trysiren/mcp

# Or use with npx without installation
npx -y @trysiren/mcp

Basic Usage

To run the Siren MCP server:

# 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

Important: Replace YOUR_SIREN_API_KEY with your actual Siren API key. You can also set the SIREN_API_KEY environment variable instead.

🔌 Client Setup

This section covers how to configure various AI assistants and development environments to work with the Siren MCP server.

Claude Desktop

Add the following to your claude_desktop_config.json. See Claude MCP documentation for more details.

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

Or if you're using Docker:

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

VS Code

VS Code supports both workspace-specific and user-level MCP configurations.

Workspace Configuration

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

{
  "mcp": {
    "servers": {
      "siren": {
        "command": "npx",
        "args": [
          "-y",
          "@trysiren/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",
        "@trysiren/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",
        "@trysiren/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,@trysiren/mcp,--tools=all,--api-key=YOUR_SIREN_API_KEY"

Other MCP Clients

The Siren MCP server is compatible with any client that supports the Model Context Protocol standard. Here are configuration examples for popular MCP-compatible platforms:

5ire Desktop

Configure in 5ire's MCP settings:

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

FLUJO

Add to FLUJO's workflow configuration:

{
  "mcp_servers": {
    "siren": {
      "command": "npx -y @trysiren/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", "@trysiren/mcp", "--tools=all", "--api-key=YOUR_SIREN_API_KEY"]
      }
    }
  }
}

Replit

Add to your Replit project's MCP configuration:

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

Codeium

Configure in Codeium's extensions:

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

🛠️ Available Tools

The Siren MCP server provides the following tools for integration:

Messaging Tools

Template Management Tools

User Management Tools

Workflow Tools

Webhook Configuration Tools

📦 Tool Categories

For convenience, you can use predefined tool categories in your configuration:

You can combine categories with specific tools:

npx @trysiren/mcp --tools=communication,templates.create,automation --api-key=YOUR_API_KEY

⚙️ Configuration Options

Command Line Arguments

API Key Format

Siren supports multiple API key formats:

Workspace Configuration

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

npx @trysiren/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:

# API key
export SIREN_API_KEY=sk_siren_your_api_key

# Workspace ID (optional)
export SIREN_WORKSPACE=ws_your_workspace_id

# Run with environment variables
npx @trysiren/mcp --tools=all

🔍 Debugging

Debug Mode

Enable verbose logging with the --debug flag:

npx @trysiren/mcp --tools=all --api-key=YOUR_API_KEY --debug

Using MCP Inspector

The MCP Inspector provides a visual interface for debugging your MCP server.

1. First, build the server:

npm run build

2. Run with the MCP Inspector:

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

3. Open the inspector in your browser at http://localhost:6274

Docker Debugging

For Docker-based debugging:

1. Build the Docker image:

docker build -t trysiren/mcp .

2. 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 trysiren/mcp --tools=all --api-key=YOUR_SIREN_API_KEY

Health Check

Verify your configuration with a simple health check:

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

If the server starts successfully, you'll see:

✅ Siren MCP Server running on stdio

You can also check the version:

npx @trysiren/mcp --version

❓ Troubleshooting

Common Issues

Logs and Diagnostics

Enable detailed logs for troubleshooting:

# Enable debug mode
npx @trysiren/mcp --tools=all --api-key=YOUR_API_KEY --debug > mcp_debug.log

Getting Help

For additional support:

• 📚 Siren Documentation
• 🔄 Model Context Protocol Documentation
• 🐛 Open an issue on GitHub
• 💬 Join the Siren Community for discussions
• 📧 Contact support at support@trysiren.io

📋 Examples

Basic Messaging

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

Template Management

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

Workflow Automation

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

Full Access

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