Open-source MCP server for connecting AI agents to the Counsel API
Counsel MCP MCP server is a hosted integration for AI assistants that speak the Model Context Protocol. Open-source MCP server for connecting AI agents to the Counsel API.
Connect instantly to the hosted Counsel MCP server - no installation required:
Once Counsel MCP is connected, these are the calls the assistant has available:
Prerequisites — 1. Node.js 18+ installed on your system 2. A Counsel account at counsel.getmason.devCursor — Add to your Cursor MCP configuration (.cursor/mcp.json in your project or global settings):Windsurf — The Windsurf tool exposed by this serverstart_consultation — Start a new strategic consultation (debate) to analyze a complex question with multiple perspectivesget_consultation_status — The get_consultation_status tool exposed by this serverget_consultation_report — Retrieve the final synthesis report from a completed consultationlist_consultations — The list_consultations tool exposed by this serversharpen_question — Refine and improve a strategic question before starting a consultationconsult_advisor — Start an interactive advisor session for brainstorming or scoping problemsSetup — The Setup tool exposed by this serverCommands — The Commands tool exposed by this serverSecurity — See CONTRIBUTING.md for detailsBeing a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.
You will need 2 environment variables: COUNSEL_API_KEY, COUNSEL_API_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Counsel MCP's toolset — Prerequisites, Cursor, Windsurf and 9 more — is a fair guide to whether it matches your workflow. It is maintained by mercurialsolo; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Prerequisites | 1. **Node.js 18+** installed on your system 2. A **Counsel account** at [counsel.getmason.dev](https://counsel.getmason.dev) |
| Cursor | Add to your Cursor MCP configuration (.cursor/mcp.json in your project or global settings): |
| Windsurf | The Windsurf tool exposed by this server. |
| start_consultation | Start a new strategic consultation (debate) to analyze a complex question with multiple perspectives. |
| get_consultation_status | The get_consultation_status tool exposed by this server. |
| get_consultation_report | Retrieve the final synthesis report from a completed consultation. |
| list_consultations | The list_consultations tool exposed by this server. |
| sharpen_question | Refine and improve a strategic question before starting a consultation. |
| consult_advisor | Start an interactive advisor session for brainstorming or scoping problems. |
| Setup | The Setup tool exposed by this server. |
| Commands | The Commands tool exposed by this server. |
| Security | See [CONTRIBUTING.md](CONTRIBUTING.md#security-checks) for details. |
{
"mcpServers": {
"counsel": {
"command": "npx",
"args": ["-y", "counsel-mcp-server", "start"]
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| COUNSEL_API_KEY | Credential the server authenticates with. | Yes |
| COUNSEL_API_URL | Endpoint or connection string the server talks to. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.