Counsel MCP Server

An open-source Model Context Protocol (MCP) server that connects AI agents to the Counsel API for strategic reasoning and multi-perspective analysis.

Features

• Hosted & Self-Hosted - Use the hosted server instantly or run your own instance
• Strategic Reasoning - Access Counsel’s debate and multi-perspective reasoning engines
• Advisor Sessions - Run interactive intake and profile tuning sessions
• Native OAuth 2.0 - Standard MCP authentication handled automatically by clients
• Dual Transport - STDIO for local clients, HTTP for web clients and shared servers

---

Table of Contents

• Quick Start (Hosted)
• Installation (Self-Hosted)
  • Claude Desktop
  • Claude Code (CLI)
  • Cursor
  • Windsurf
  • VS Code with Copilot
  • Other MCP Clients
• Authentication
• Available Tools
• Usage Examples
• Configuration
• Troubleshooting
• Development
• Contributing
• License

---

Quick Start (Hosted)

Connect instantly to the hosted Counsel MCP server - no installation required:

http://counsel-mcp.getmason.dev/mcp

For MCP clients that support HTTP transport, simply add:

{
  "mcpServers": {
    "counsel": {
      "url": "http://counsel-mcp.getmason.dev/mcp",
      "transport": "http"
    }
  }
}

OAuth authentication is handled automatically by your MCP client.

---

Installation (Self-Hosted)

Run your own instance of the Counsel MCP server locally.

Prerequisites

1. Node.js 18+ installed on your system
2. A Counsel account at counsel.getmason.dev

Claude Desktop

Add to your claude_desktop_config.json:

Claude Code (CLI)

claude mcp add counsel -- npx -y counsel-mcp-server start