# SidClaw MCP server

> Intercepts AI agent tool calls to evaluate policies, require human approval for risky actions, and maintain tamper-evident audit trails.

- Repository: https://github.com/sidclawhq/platform
- Page: https://hostedmcp.org/servers/sidclawhq/platform
- Transport: stdio
- Stars: 15
- License: Apache-2.0
- Latest version: 0.1.13

## Install

### Claude Code

```sh
claude mcp add --env 'SIDCLAW_API_KEY=<YOUR_SIDCLAW_API_KEY>' --env 'SIDCLAW_AGENT_ID=<SIDCLAW_AGENT_ID>' --env 'SIDCLAW_UPSTREAM_ARGS=<SIDCLAW_UPSTREAM_ARGS>' --env 'SIDCLAW_UPSTREAM_CMD=<SIDCLAW_UPSTREAM_CMD>' platform -- npx -y @sidclaw/sdk
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "platform": {
      "command": "npx",
      "args": [
        "-y",
        "@sidclaw/sdk"
      ],
      "env": {
        "SIDCLAW_API_KEY": "<YOUR_SIDCLAW_API_KEY>",
        "SIDCLAW_AGENT_ID": "<SIDCLAW_AGENT_ID>",
        "SIDCLAW_UPSTREAM_ARGS": "<SIDCLAW_UPSTREAM_ARGS>",
        "SIDCLAW_UPSTREAM_CMD": "<SIDCLAW_UPSTREAM_CMD>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "platform": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sidclaw/sdk"
      ],
      "env": {
        "SIDCLAW_API_KEY": "<YOUR_SIDCLAW_API_KEY>",
        "SIDCLAW_AGENT_ID": "<SIDCLAW_AGENT_ID>",
        "SIDCLAW_UPSTREAM_ARGS": "<SIDCLAW_UPSTREAM_ARGS>",
        "SIDCLAW_UPSTREAM_CMD": "<SIDCLAW_UPSTREAM_CMD>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"platform","type":"stdio","command":"npx","args":["-y","@sidclaw/sdk"],"env":{"SIDCLAW_API_KEY":"<YOUR_SIDCLAW_API_KEY>","SIDCLAW_AGENT_ID":"<SIDCLAW_AGENT_ID>","SIDCLAW_UPSTREAM_ARGS":"<SIDCLAW_UPSTREAM_ARGS>","SIDCLAW_UPSTREAM_CMD":"<SIDCLAW_UPSTREAM_CMD>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "platform": {
      "command": "npx",
      "args": [
        "-y",
        "@sidclaw/sdk"
      ],
      "env": {
        "SIDCLAW_API_KEY": "<YOUR_SIDCLAW_API_KEY>",
        "SIDCLAW_AGENT_ID": "<SIDCLAW_AGENT_ID>",
        "SIDCLAW_UPSTREAM_ARGS": "<SIDCLAW_UPSTREAM_ARGS>",
        "SIDCLAW_UPSTREAM_CMD": "<SIDCLAW_UPSTREAM_CMD>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add platform --env 'SIDCLAW_API_KEY=<YOUR_SIDCLAW_API_KEY>' --env 'SIDCLAW_AGENT_ID=<SIDCLAW_AGENT_ID>' --env 'SIDCLAW_UPSTREAM_ARGS=<SIDCLAW_UPSTREAM_ARGS>' --env 'SIDCLAW_UPSTREAM_CMD=<SIDCLAW_UPSTREAM_CMD>' -- npx -y @sidclaw/sdk
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.platform]
command = "npx"
args = ["-y", "@sidclaw/sdk"]

[mcp_servers.platform.env]
SIDCLAW_API_KEY = "<YOUR_SIDCLAW_API_KEY>"
SIDCLAW_AGENT_ID = "<SIDCLAW_AGENT_ID>"
SIDCLAW_UPSTREAM_ARGS = "<SIDCLAW_UPSTREAM_ARGS>"
SIDCLAW_UPSTREAM_CMD = "<SIDCLAW_UPSTREAM_CMD>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SIDCLAW_API_KEY=<YOUR_SIDCLAW_API_KEY>' -e 'SIDCLAW_AGENT_ID=<SIDCLAW_AGENT_ID>' -e 'SIDCLAW_UPSTREAM_ARGS=<SIDCLAW_UPSTREAM_ARGS>' -e 'SIDCLAW_UPSTREAM_CMD=<SIDCLAW_UPSTREAM_CMD>' platform npx -- -y @sidclaw/sdk
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "platform": {
      "command": "npx",
      "args": [
        "-y",
        "@sidclaw/sdk"
      ],
      "env": {
        "SIDCLAW_API_KEY": "<YOUR_SIDCLAW_API_KEY>",
        "SIDCLAW_AGENT_ID": "<SIDCLAW_AGENT_ID>",
        "SIDCLAW_UPSTREAM_ARGS": "<SIDCLAW_UPSTREAM_ARGS>",
        "SIDCLAW_UPSTREAM_CMD": "<SIDCLAW_UPSTREAM_CMD>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SIDCLAW_API_KEY` | yes | yes | SidClaw API key for policy evaluation and audit logging |
| `SIDCLAW_AGENT_ID` | yes | no | Agent identity for policy matching and audit trails |
| `SIDCLAW_UPSTREAM_ARGS` | yes | no | Comma-separated args for the upstream MCP server |
| `SIDCLAW_UPSTREAM_CMD` | yes | no | Command for the upstream MCP server (e.g., npx) |
| `SIDCLAW_APPROVAL_MODE` | no | no | Approval mode: error (default, returns immediately) or block (waits for approval) |
| `SIDCLAW_BASE_URL` | no | no |  |

## FAQ

### What does SidClaw do?

SidClaw intercepts AI agent tool calls, checks them against defined policies, and can hold high-risk actions for human review before execution.

### How can I use SidClaw with an existing MCP server?

You can wrap any MCP server using the MCP Governance Proxy by adding it to your .mcp.json configuration.
