@cstack-protocol/mcp

The official Model Context Protocol (MCP) server for the CSTACK ecosystem. CSTACK MCP (powered by the CSTACK Engine) acts as an architectural substrate that monitors, audits, and validates the tool-stacks used by human operators and autonomous agents like Pingala.

Technical Overview

The CSTACK MCP implements the 5:3:1 Rule from Conscious Stack Design™ — a structural constraint system designed to minimize cognitive overhead and architectural fragmentation. It provides a standardized interface for LLMs to understand their own operating environment (the "Stack") and prevents "Software Drift."

Key Capabilities

• Architectural Auditing: Scans project workspaces for .agent and .csp configurations to evaluate structural integrity.
• CSI (Conscious Stack Index): Provides quantitative metrics on stack health, fragmentation, and "Decision Provenance."
• Governance Guardrails: Injects real-time constraints into LLM prompts to prevent the unmanaged expansion of tools and dependencies.
• Hybrid Identity: Operates in Sovereign Mode (Local-only, private) or Collective Mode (Cloud-sync via Convex for pattern registry matching).

Installation

Global CLI (Recommended)

You can run the auditor or configure your environment directly via npx:

# Perform a local architectural audit
npx @cstack-protocol/mcp audit

# Automatically configure Claude Desktop with CSTACK MCP
npx @cstack-protocol/mcp setup-claude

Manual Integration

If you prefer manual configuration in claude_desktop_config.json:

{
  "mcpServers": {
    "cstack": {
      "command": "npx",
      "args": ["-y", "@cstack-protocol/mcp@latest"],
      "env": {
        "CSTACK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available MCP Tools

| Tool | Description | |------|-------------| | cs_audit | Analyzes the current project workspace for protocol violations. | | validate_stack_change | Simulation tool for evaluating the CSI impact of adding/removing a tool. | | get_governance_context | Injects current maturity levels and architectural constraints into the session. | | analyze_stack | Deep-level analysis of tool categorizations and functional overlap. |

Data Privacy & Sovereignty

The CSTACK MCP is "Anonymous by Design."

1. Categorical Hashing: In Collective Mode, tool names are never uploaded. Only the Functional Category (e.g., "Vector Database") is sent to the pattern registry.
2. Local First: All auditing logic runs on your local hardware. Cloud syncing is optional and requires an explicit CSTACK_API_KEY.

License

ISC © 2026 Faiabrand Pte Ltd ("Faiā").