CouchLoop EQ - MCP Server

Behavioral governance layer for safer, more consistent AI conversations.

🌐 Landing Page • 📦 npm • ⭐ GitHub

📖 Choose Your Guide

What is CouchLoop EQ?

CouchLoop EQ is a behavioral governance layer for AI assistants. Built on MCP (Model Context Protocol), it monitors for hallucination, inconsistency, and unsafe reasoning patterns while managing stateful AI sessions.

Why CouchLoop EQ?

Unlike raw LLMs that can hallucinate packages, generate insecure code, and lose context mid-conversation, CouchLoop EQ catches problems before they ship:

Architecture

CouchLoop EQ uses a modular pipeline:

Request -> Classify -> Policy -> Plan -> Execute -> Compose

• Intent Classifier: Confidence-based routing with multi-intent detection
• Policy Engine: Health-aware routing with fallbacks and crisis override
• Execution Planner: DAG generation for parallel operations
• Tool Registry: Health tracking and circuit breakers
• OpenTelemetry: Distributed tracing across all stages

Key Safety Features

Behavioral Governance

• Hallucination Detection: Monitors for fabricated facts and unsupported claims
• Consistency Checking: Identifies contradictions and logical incoherence across turns
• Tone Monitoring: Detects emotional escalation, manipulation, or dependency-forming language
• Safety Guardrails: Prevents harmful advice, clinical overreach, and inappropriate moralizing

Session Management

• Stateful Conversations: Maintains context across multiple interactions
• Progress Tracking: Remember where users left off in guided journeys
• Crisis Detection: Integrated crisis detection with guided self-reflection journeys
• Memory Context: Preserves important insights and checkpoints

Privacy by Design

• No personal data stored: No emails, names, passwords, or API keys
• Session-based isolation: Each session is anonymous and isolated
• Your data stays yours: Insights and context are tied to session IDs, not identities
• No tracking: No analytics, no telemetry, no third-party data sharing

Quick Start

CouchLoop EQ is a standard MCP server that works with any MCP-compatible client - Claude Desktop, ChatGPT, Cursor, Windsurf, VS Code, and more.

Option 1: Connect to Hosted Server (Easiest)

Production endpoint: https://mcp.couchloop.com/mcp

For Claude Desktop (v0.7.0+), add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "couchloop-eq": {
      "url": "https://mcp.couchloop.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Restart Claude and try: "Start a daily reflection session"

Option 2: Run Locally

npm install -g couchloop-eq-mcp

Add to Claude Desktop configuration:

{
  "mcpServers": {
    "couchloop-eq": {
      "command": "couchloop-eq-mcp",
      "env": {
        "COUCHLOOP_SERVER": "https://mcp.couchloop.com"
      }
    }
  }
}

Sessions automatically persist locally to ~/.couchloop-mcp/identity.json - no signup required.

For ChatGPT (Developer Mode)

ChatGPT supports MCP servers through Developer Mode. See CHATGPT_SETUP.md for detailed setup instructions.

For Other MCP Clients

Any MCP-compatible client (Cursor, Windsurf, Continue, etc.) can connect using:

• URL: https://mcp.couchloop.com/mcp
• Transport: streamable-http
• Auth: None required (session-based isolation)

Production Server Available: https://mcp.couchloop.com/mcp

Quick steps:

1. Enable Developer Mode in ChatGPT Settings
2. Add as MCP connector with URL: https://mcp.couchloop.com/mcp
3. No authentication required - uses session-based isolation

For local development:

• Use ngrok or deploy your own server
• Follow setup in CHATGPT_SETUP.md

Available Tools (10 Primary)

CouchLoop EQ provides 10 MCP tools with intelligent routing. The couchloop intent router handles ambiguous or multi-intent requests, while high-confidence intents can call tools directly.

Universal Entry Point

Governance

Core Tools

Usage Examples

# Via intent router (recommended for loose commands)
"end session"          -> couchloop routes to conversation(action: end)
"save this for later"  -> couchloop routes to remember(action: save)
"review my code"       -> couchloop routes to code_review
"brainstorm a feature" -> couchloop routes to brainstorm
"what can you do"      -> couchloop returns capabilities list

# Direct tool calls (for precise control)
conversation(action: "start", message: "Begin daily reflection")
brainstorm(message: "Design a caching layer")  # Dev ideation
remember(action: "recall")  # Get saved context
verify(type: "packages", content: "lodash-utils")  # Validate before install
code_review(code: "function foo()...")  # Analyze code

Real-World Usage

CouchLoop EQ is actively used in production development. Here is what 2 weeks of actual usage looked like:

Usage Statistics

Development Areas Tracked

Featured Insight: Complex Bug Resolution

PAYMENT FLOW BUG ROOT CAUSE IDENTIFIED:

Issue: Race condition between frontend state and backend data caused
inconsistent user experience during payment retry flows.

Analysis: Traced through 5 components across iOS and backend to find
the state synchronization gap.

FIX OPTIONS:
A) Data cleanup - reset stale records
B) Frontend fix - stricter validation
C) Backend fix - additional verification step

Recommended: Defense-in-depth approach combining A + B

This insight was captured mid-debugging session, preserved across context window resets, and referenced 3 days later when implementing the fix.

Best Practices for Sprint Development

Start of sprint: Create a session to establish context

"Create a session for Sprint 42 - user authentication overhaul"

After completing a feature: Save insights, context, or checkpoints depending on complexity

Why this matters: When you need to review or debug later, you can retrieve the exact context of what was just built - even weeks later, across different AI sessions.

"Get my insights tagged 'auth-refactor'" -> Instant recall of decisions made
"Resume my Sprint 42 session" -> Pick up exactly where you left off

Available Journeys

• Daily Reflection (5 min) - A brief check-in to process your day
• Gratitude Practice (3 min) - Notice and name three things you appreciate
• Weekly Review (10 min) - Look back on your week and set intentions

Example Usage

Start a daily reflection:

"Start a daily reflection session"

Resume where you left off:

"Resume my last session"

Save an insight:

"Save this insight: I notice I'm more energized in the mornings"

Support

• Issues: github.com/wisenbergg/couchloop-mcp/issues
• Email: support@couchloop.com

License

MIT