SidClaw GovernanceMCPServer

by sidclawhq

Not rated
GitHub

About

Governance proxy for MCP servers — wraps any server with policy evaluation, human approval workflows, and hash-chain audit trails.

Details

Author
sidclawhq
Categories
Developer Tools, Security, Automation

Setup

Install SidClaw GovernanceMCPServer in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/sidclawhq/platform

Follow the installation instructions in the repository README, then restart your MCP client.

Governance proxy for MCP servers — wraps any server with policy evaluation, human approval workflows, and hash-chain audit trails.

Approve, deny, and audit AI agent tool calls.

Works with MCP, LangChain, OpenAI Agents, Claude Agent SDK, and 15+ more.

Website·Documentation·Live Demo·SDK on npm·SDK on PyPI

Your agents call tools without oversight. SidClaw intercepts every tool call, checks it against your policies, and holds risky actions for human review before they execute.

Opens a local governance dashboard athttp://localhost:3030with four pre-loaded scenarios (Claude Coderm -rf, fintech trade, DevOps scale-to-zero, clinical lab order). No signup, no Docker, no API key — just the approval card UX running in your browser.

Agent wants to send an email → policy flags it → reviewer sees full context → approves or denies → trace recorded.

SidClaw integrates with18+ frameworks and platforms— including OpenClaw (329K+ users), LangChain, OpenAI, MCP, Claude Agent SDK, Google ADK, NemoClaw, Copilot Studio, GitHub Copilot, and more. Add governance in one line of code.See all integrations →

Customer Support Agent (Financial Services)

An AI agent wants to send a customer email. Policy flags it for review. The reviewer sees full context — who, what, why — and approves with one click. Every step is traced.

An AI agent wants to scale production services. High-risk deployments require human approval. Read-only monitoring is allowed instantly.

An AI assistant recommends lab orders. The physician reviews the clinical context and approves. Medication prescribing is blocked by policy — only physicians can prescribe.

Agent wants to act → SidClaw evaluates → Policy decides → Human approves (if needed) → Action executes → Trace recorded

Four primitives govern every agent action:

┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ Identity │ → │ Policy │ → │ Approval │ → │ Trace │ │ │ │ │ │ │ │ │ │ Every │ │ Every │ │ High-risk│ │ Every │ │ agent │ │ action │ │ actions │ │ decision │ │ has an │ │ evaluated│ │ get human│ │ creates │ │ owner & │ │ against │ │ review │ │ tamper- │ │ scoped │ │ explicit │ │ with rich│ │ evident │ │ perms │ │ rules │ │ context │ │ audit │ └──────────┘ └──────────┘ └──────────┘ └──────────┘

- allow→ action executes immediately, trace recorded
- approval_required→ human sees context card, approves/denies, trace recorded
- deny→ blocked before execution, no data accessed, trace recorded

Railway is the recommended one-click deploy — it spins up Postgres + API + Dashboard together. Vercel hosts only the Next.js dashboard; pair it with a hosted API.

https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fsidclawhq%2Fplatform&root-directory=apps%2Fdashboard&env=NEXT_PUBLIC_API_URL&envDescription=Your%20SidClaw%20API%20base%20URL%20(e.g.%20https%3A%2F%2Fapi.sidclaw.com)

Vercel can only host the dashboard (Next.js). The API is Fastify — deploy it to Railway, Fly, Render, or run via Docker. SetNEXT_PUBLIC_API_URLon the dashboard project to point at it.

Under 3 minutes to a working instance on Railway.

For Claude Code users. EveryBash,Write,Agent,mcp__tool call is governed by SidClaw:

# In the SidClaw platform repo npm run hooks:install # Then set two env vars export SIDCLAW_BASE_URL=https://api.sidclaw.com export SIDCLAW_API_KEY=ai_your_key_here

Restart Claude Code.rm -rfpauses for approval,git push --forcegets flagged, every tool call is traced with a hash-chained audit trail. Seehooks/README.md.

Option 2:create-sidclaw-app(interactive scaffold)

npx create-sidclaw-app my-agent cd my-agent npm start

Option 3: MCP Governance Proxy (zero code, wraps any MCP server)

Jump to theMCP Governance Proxy section below.

Option 4: SDK wrapper (one line per tool)

// Before: the agent decides, nobody reviews await sendEmail({ to: "customer@example.com", subject: "Follow-up", body: "..." }); // After: wrap with SidClaw — now policies apply const sendEmail = withGovernance(client, { operation: 'send_email', data_classification: 'confidential', }, sendEmailFn); await sendEmail({ to: "customer@example.com", subject: "Follow-up", body: "..." }); // → allow (executes) | approval_required (human reviews) | deny (blocked)
@with_governance(client, GovernanceConfig( operation="send_email", data_classification="confidential", )) def send_email(to, subject, body): email_service.send(to=to, subject=subject, body=body)
import { AgentIdentityClient, withGovernance } from '@sidclaw/sdk'; const client = new AgentIdentityClient({ apiKey: process.env.SIDCLAW_API_KEY, apiUrl: 'https://api.sidclaw.com', agentId: process.env.SIDCLAW_AGENT_ID, }); const sendEmail = withGovernance(client, { operation: 'send_email', target_integration: 'email_service', resource_scope: 'customer_emails', data_classification: 'confidential', }, async (to, subject, body) => { await emailService.send({ to, subject, body }); }); await sendEmail('customer@example.com', 'Follow-up', 'Hello...'); // allow → executes | approval_required → waits for human | deny → throws
import os from sidclaw import SidClaw from sidclaw.middleware.generic import with_governance, GovernanceConfig client = SidClaw( api_key=os.environ["SIDCLAW_API_KEY"], agent_id=os.environ["SIDCLAW_AGENT_ID"], ) @with_governance(client, GovernanceConfig( operation="send_email", target_integration="email_service", data_classification="confidential", )) def send_email(to, subject, body): email_service.send(to=to, subject=subject, body=body)

Wrap any MCP server with policy evaluation and approval workflows. Works with Claude Desktop, Cursor, VS Code, GitHub Copilot — any MCP client. Listed on theofficial MCP Registry.

{ "mcpServers": { "postgres-governed": { "command": "npx", "args": ["-y", "@sidclaw/sdk", "sidclaw-mcp-proxy", "--transport", "stdio"], "env": { "SIDCLAW_API_KEY": "ai_your_key", "SIDCLAW_AGENT_ID": "your-agent-id", "SIDCLAW_UPSTREAM_CMD": "npx", "SIDCLAW_UPSTREAM_ARGS": "-y,@modelcontextprotocol/server-postgres,postgresql://localhost/mydb" } } } }

- SELECT FROM customersallowed(~50ms overhead)
- DELETE FROM customers WHERE id = 5held for human approval
- DROP TABLE customersdenied by policy

Why not just auth / sandboxing / logging?

SidClaw sits at thetool-call layer: the moment an agent decides to act in the real world.

SidClaw wraps your existing agent tools — no changes to your agent logic.

Approval requests are delivered to your team's preferred channels. Reviewers can approve or deny directly from chat.

Start with just the SDK?You don't need the platform. The SDK works standalone with the free hosted API atapp.sidclaw.com, or you canself-host everything.

AI agents are being deployed in production, but the governance layer is missing:

- 73% of CISOsfear AI agent risks, but only30%are ready (NeuralTrust 2026)
- 79% of enterpriseshave blind spots where agents act without oversight
- FINRA 2026explicitly requires "documented human checkpoints" for AI agent actions in financial services
- EU AI Actmandates human oversight, automatic logging, and risk management for high-risk AI systems — obligations apply from2 December 2027(Annex III) and2 August 2028(product-embedded), deferred from August 2026 by the 2026 Digital Omnibus
- OpenClawhas 329K+ stars and 13,700+ skills — but
1,184 malicious skills were foundin the ClawHavoc campaign. There's no policy layer governing what skills can do.

The big vendors (Okta, SailPoint, WorkOS) handle identity and authorization. But none of them ship theapproval step— the part where a human sees rich context and makes an informed decision before an agent acts.

SidClaw maps to regulatory requirements across the US, EU, Switzerland, and Singapore:

🇺🇸FINRA 2026· 🇪🇺EU AI Act· 🇨🇭FINMA· 🇸🇬MAS TRM· 🇺🇸NIST AI RMF· 🌐OWASP Agentic

- 60-second setupnpx create-sidclaw-appscaffolds a working governed agent
- <50ms evaluation overhead— the governance layer is invisible to your users
- 5-minute integration— wrap existing tools, no code changes
- MCP-native— governance proxy for any MCP server
- Framework-agnostic— LangChain, Vercel AI, OpenAI, CrewAI, Pydantic AI, Composio, Claude Agent SDK, Google ADK, LlamaIndex, NemoClaw, or plain functions
- Typed SDKs— TypeScript (npm) + Python (PyPI)

- Policy engine— allow / approval_required / deny with priority ordering and classification hierarchy
- Approval workflow— context-rich cards with agent reasoning, risk classification, and separation of duties
- Audit trails— correlated traces with integrity hash chains (tamper-evident)
- SIEM export— JSON and CSV, continuous webhook delivery

- RBAC— admin, reviewer, viewer roles with enforced permissions
- Tenant isolation— automatic tenant scoping on every query
- API key management— scoped keys with rotation
- Rate limiting— per-tenant, per-endpoint-category
- Webhooks— real-time notifications for approvals, traces, lifecycle events
- Chat integrations— approve/deny from Slack, Teams, or Telegram without opening the dashboard
- Self-serve signup— GitHub, Google, email/password

┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │ Your Agent │ │ SidClaw SDK │ │ SidClaw API │ │ │ ──► │ │ ──► │ │ │ LangChain │ │ evaluate() │ │ Policy Engine │ │ MCP Server │ │ withGovern() │ │ Approval Service │ │ OpenAI SDK │ │ governTools()│ │ Trace Store │ │ Any tool │ │ │ │ Webhook Delivery │ └─────────────┘ └──────────────┘ └──────────────────┘ │ ┌────────┴────────┐ ▼ ▼ ┌──────────────┐ ┌──────────────┐ │ Dashboard │ │ Notifications│ │ │ │ │ │ Agents │ │ Slack │ │ Policies │ │ Teams │ │ Approvals │ │ Telegram │ │ Traces │ │ Email │ │ Settings │ │ Webhooks │ └──────────────┘ └──────────────┘

Deploy from the GitHub repo to Railway. Add a PostgreSQL database, configure environment variables, and you're live.

Deploy the dashboard to Vercel (requires a separately hosted API).

curl -sSL https://raw.githubusercontent.com/sidclawhq/platform/main/deploy/self-host/setup.sh | bash
git clone https://github.com/sidclawhq/platform.git cd platform cp deployment/env.example .env # edit with your values docker compose -f docker-compose.production.yml up -d

No infrastructure to manage.Start free at app.sidclaw.com

Seedeployment documentationfor production configuration, environment variables, and upgrade guides.

- Quick Start— 2 minutes to first governed action
-
SDK Reference— every method documented
-
Integrations— MCP, OpenClaw, NemoClaw, LangChain, OpenAI, Claude Agent SDK, Google ADK, Copilot Studio, GitHub Copilot, and more
-
Policy Guide— authoring, versioning, testing
-
Compliance— 🇺🇸 FINRA · 🇪🇺 EU AI Act · 🇨🇭 FINMA · 🇸🇬 MAS TRM · 🇺🇸 NIST AI RMF · 🌐 OWASP
-
API Reference— every endpoint

We welcome contributions! SeeCONTRIBUTING.mdfor guidelines.

The SDK (packages/sdk/) is Apache 2.0. The platform (apps/) is FSL 1.1.

- SDK(packages/sdk/,packages/shared/):Apache License 2.0— use freely for any purpose
- Platform(apps/api/,apps/dashboard/,apps/docs/,apps/landing/,apps/demo*/):
Functional Source License 1.1— source-available. Cannot offer as a competing hosted service. Converts to Apache 2.0 after 2 years (March 2028).

- Website
-
Documentation
-
Dashboard
-
TypeScript SDK (npm)
-
Python SDK (PyPI)
-
Python SDK (GitHub)
-
create-sidclaw-app (npm)
-
GitHub Action
-
GitHub App
-
Contact

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Require a named human's offline-verifiable approval before an AI agent takes an irreversible action — payment release, record change, deploy. Two-person rule, Ed25519 Trust Receipts, IETF-drafted, Apache-2.0.

Wrap your local MCP servers to check every tool call against policy and live state before it runs - allow, block, or request a refresh, with a reason the agent can act on.

Paid remote MCP for AI agent safety replay checks, policy gates, eval receipts, control-fix suggestions, and release evidence exports.

Connect to your CISO Adapt workspace to search, analyse, export, and manage risks and policies with natural language

Boost security in your dev lifecycle via SAST, SCA, Secrets & IaC scanning with Cycode.

Cloud security insights, guardrail guidance, and compliance checking via Dawnguard.

Six-gate governance for AI agents: PROCEED/PAUSE/HALT decisions with hash-chained audit trails.

Paid remote MCP for agent data-access boundary reviews, permission scope evidence, sensitive data notes, and governance receipts.

Remote MCP server (Streamable HTTP) at https://mcp.agenticrail.nz/ — deterministic step-order enforcement for AI agents. evaluate_step returns ALLOW or DENY before a step runs; verify_receipt proves a sequence's Ed25519-signed, hash-chained receipt chain is intact. No auth required: omit the bearer token and calls run on the public demo key. That first clause matters — the form has no "remote/hosted" field, and putting the endpoint in the description is the convention on that list ("Fully REMOTE! Just use…"). The rest mirrors your own server card verbatim, so the listing and the card can't drift.

Paid remote MCP for agent memory MCP, structured receipts, usage logs, and audit-ready evidence for agent and CI workflows.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.