Skip to main content
Glama
DeAlgo MCP Server

DeAlgo MCP Server

Official

DeAlgo MCP Server

Runtime decision firewall for AI agents. Exposes the CSC engine (via the dealgo-portal control layer) as a Model Context Protocol server so any MCP-aware client — Claude Desktop, Claude Code, Cursor, custom agents — can consult CSC before executing risky actions.

Claude / agent
      ↓
MCP tool: csc_check(...)
      ↓
dealgo-portal /api/csc/check  (Bearer dealgo_sk_live_…)
      ↓
CSC engine: reality · policy · throttle gates
      ↓
{ decision, action, reason, v2_bias, latency_ms }

Tools

csc_check(feed, risk?, volatility?, confidence?, symbol?, source?, intent?, v2_aware=True)

Primary tool. Score one signal/action against CSC. Returns

{ "decision": "APPROVE" | "DELAY" | "DENY",
  "action":   "EXECUTE" | "WAIT" | "REJECT",
  "reason":   "...",
  "v2_bias":  -0.018,
  "stimulus_id": "stim_…",
  "latency_ms": 41 }

Proceed only on APPROVE. On DELAY, retry with backoff. On DENY, do not retry — surface the reason to the user.

check_action(intent, action, actor_id, domain, environment, metadata)

Backwards-compat shim. Maps the legacy governance payload onto csc_check so existing demos and Claude Desktop configs keep working. Prefer csc_check directly in new code.

Related MCP server: RecourseOS

Resource

governance://decisions/recent — last 20 decisions logged for the configured API key. Lets agents introspect their own history.

  1. Install:

    pip install dealgo-mcp
  2. Get a sandbox key from your portal at https://api.dealgo.io/keys (or https://api.dealgo.io/quickstart for a one-click reveal). Use a dealgo_sk_test_… key for a no-meter sandbox, dealgo_sk_live_… for prod.

  3. Wire into Claude Desktop. Merge this into the config:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    {
      "mcpServers": {
        "dealgo-csc": {
          "command": "dealgo-mcp",
          "env": {
            "DEALGO_API_KEY": "dealgo_sk_test_…",
            "DEALGO_API_URL": "https://api.dealgo.io"
          }
        }
      }
    }
  4. Restart Claude Desktop. Then ask Claude:

    "Use csc_check before doing anything risky."

    Every risky action will now consult /v1/decide and surface the verdict.

Setup (local dev — from source)

git clone https://github.com/dealgo-systems/dealgo-mcp-server
cd dealgo-mcp-server
pip install -e .            # editable install — picks up changes immediately

Then point Claude Desktop config to the editable install ("command": "dealgo-mcp" still works after pip install -e . — entry point is registered system-wide).

Smoke test

DEALGO_API_KEY=dealgo_sk_test_... python smoke_test.py

Exercises all three CSC gates (reality, policy, throttle), the backwards-compat shim, and the recent-decisions resource. Pass = CSC governance is live over MCP.

Configuration

Env var

Default

Required

DEALGO_API_KEY

(none)

yes

DEALGO_API_URL

https://api.dealgo.io

no

Now Claude can call CSC before executing actions.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for AI agent security guardrails. Provides input validation, prompt injection detection, PII redaction, output filtering, policy enforcement, rate limiting, and comprehensive audit logging.
      72 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      MCP server that evaluates Terraform plans, shell commands, and tool calls to assess recoverability and risk before execution, enabling safe AI agent actions.
      151 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enforces runtime governance on AI agent actions — file access, command execution, delegation chains, and permission escalation.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that acts as an AI assumption firewall, intercepting risky decisions, detecting contradictions, and routing human approval requests via Telegram or Slack.
      8
      1
      MIT