> ## 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.

# Debugging

## **Debug Mode**

Enable verbose logging with the `--debug` flag:

```bash theme={null}
npx @trysiren/mcp --tools=all --api-key=YOUR_API_KEY --debug
```

## **Using MCP Inspector**

The [**MCP Inspector**](https://modelcontextprotocol.io/docs/tools/inspector) provides a visual interface for debugging your MCP server.

<Steps>
  <Step title="First, build the server:">
    ```bash theme={null}
    npm run build
    ```
  </Step>

  <Step title="Run with the MCP Inspector:">
    ```bash theme={null}
    # Start MCP Inspector and server with all tools
    npx @modelcontextprotocol/inspector node dist/index.js --tools=all --api-key=YOUR_SIREN_API_KEY
    ```
  </Step>

  <Step title="Open the inspector in your browser at `http://localhost:6274`">
    ECHO is off.
  </Step>
</Steps>

## **Docker Debugging**

For Docker-based debugging:

<Steps>
  <Step title="Build the Docker image:">
    ```bash theme={null}
    docker build -t trysiren/mcp .
    ```
  </Step>

  <Step title="Run with MCP Inspector:">
    ```bash theme={null}
    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
    ```
  </Step>
</Steps>

## **Health Check**

* Verify your configuration with a simple health check:
  ```bash theme={null}
  npx @trysiren/mcp --tools=messaging.send --api-key=YOUR_SIREN_API_KEY
  ```
* If the server starts successfully, you will see:
  ```bash theme={null}
  ✅ Siren MCP Server running on stdio
  ```
* You can also check the version:
  ```bash theme={null}
  npx @trysiren/mcp --version
  ```

# Troubleshooting

Some of the common issues and solutions are stated below.

<AccordionGroup>
  <Accordion title="Invalid API Key">
    **Possible Causes**

    * Incorrect format
    * Expired key
    * Key not set properly
      **Solutions**
    * Ensure key starts with `sk_siren_`, `sk_test_`, or `sk_live_`
    * Check your environment variables or CLI argument
    * Generate a new API key from the Siren dashboard if needed
  </Accordion>

  <Accordion title="Tool Not Found">
    **Possible Causes**

    * Typo in tool name
    * Tool not enabled
    * Outdated MCP package
      **Solutions**
    * Verify tool name (case-sensitive)
    * Add the tool to the `--tools` list in the command
    * Update to the latest MCP version
  </Accordion>

  <Accordion title="Connection Issues">
    **Possible Causes**

    * Network problems
    * Firewall blocking
    * API endpoint down
      **Solutions**
    * Check your internet connection
    * Configure firewall exceptions for outbound calls
    * Verify Siren API availability at [status.trysiren.io](https://status.trysiren.io)
  </Accordion>

  <Accordion title="Permission Denied">
    **Possible Causes**

    * Insufficient API key permissions
    * Workspace-specific access restrictions
      **Solutions**
    * Ensure your API key has required scopes
    * Check your workspace access level
    * Contact [Siren Support](mailto:support@trysiren.io) if the issue persists
  </Accordion>

  <Accordion title="Rate Limiting">
    **Possible Causes**

    * Too many requests in a short time
    * Plan quota exceeded
      **Solutions**
    * Implement retry logic or request throttling
    * Upgrade your Siren plan if you are consistently hitting limits
  </Accordion>
</AccordionGroup>

# Examples

## Basic Messaging

```bash theme={null}
# Configure for basic messaging
npx @siren/mcp --tools=messaging.send,messaging.getStatus --api-key=YOUR_API_KEY
```

## Template Management

```bash theme={null}
# Configure for template operations
npx @siren/mcp --tools=templates.list,templates.create,templates.update --api-key=YOUR_API_KEY
```

## Workflow Automation

```bash theme={null}
# Configure for workflow automation
npx @siren/mcp --tools=workflows.trigger,workflows.schedule --api-key=YOUR_API_KEY
```

## Full Access

```bash theme={null}
# Configure all available tools
npx @siren/mcp --tools=all --api-key=YOUR_API_KEY
```