# SynthBoard MCP Server

> Run the SynthBoard boardroom from Claude Desktop, Cursor, Windsurf, ChatGPT, Zed, or any MCP client. 27 tools, 13 resources, 10 prompts. OAuth 2.1 + Bearer auth. Production-grade.

**Canonical URL:** https://www.synthboard.ai/mcp  
**Markdown source:** https://www.synthboard.ai/mcp.md  
**MCP endpoint:** https://www.synthboard.ai/api/mcp  
**Setup guide:** https://www.synthboard.ai/mcp/help

## What it is

The Model Context Protocol (MCP) is the open standard for connecting AI clients to external tools and data. SynthBoard ships an MCP server that exposes the entire boardroom — sessions, Synths, decisions, integrations, shares — as MCP tools. Any MCP-compatible client can run a SynthBoard session without leaving the client.

Concrete example: from Claude Desktop, you say *"convene a board of 5 Synths to stress-test our pricing change"* — the SynthBoard MCP tools run the session, return the synthesis, and the entire flow happens inside Claude Desktop with full results streamed back.

## Compatible clients

- **Claude Desktop** (Anthropic) — full support, OAuth 2.1.
- **Cursor** — full support.
- **Windsurf** — full support.
- **Zed** — full support.
- **ChatGPT** (Connectors) — full support, OAuth 2.1.
- **VS Code Copilot** — when MCP is enabled.
- **Any MCP 1.0+ client** — Bearer or OAuth 2.1.

## What you can do from your MCP client

### Session lifecycle (13 tools)
- Start a new boardroom session with a chosen mode and Synth lineup.
- Continue, fork, archive, cancel, or delete a session.
- Pull the live summary, plan, outcomes, or full export.
- Update session metadata in place.

### Interactive (5 tools)
- Send a synth-chat message into a running session.
- Trigger cross-round summaries on demand.
- Capture an explicit decision against a session.

### Actions on connected tools (2 tools)
- Execute a board-recommended action against connected integrations (Slack, Gmail, Linear, Notion, etc.) with your approval.
- Undo any action within 30 seconds.

### Shares (4 tools)
- Generate a share link (live or static), with or without password.
- List, revoke, or verify share-link passwords.

### Utilities (3 tools)
- Ping, list integrations, search the catalog.

## Resources (13)

Read-only data sources the client can subscribe to:
- Recent sessions, drafts, tier limits, account credits.
- Per-session: outcomes, plan, summary, full transcript.
- Catalog: Synth library, mode list, integration list.
- Brand context for the board you are running.

## Prompts (10)

Pre-tuned prompt templates the client can invoke directly: stress-test, pre-mortem, decision autopsy, scenario forecast, hire-decision frame, pricing change, market-entry, fundraise prep, exec hire, vendor selection.

## Auth

- **OAuth 2.1** — recommended for end-user clients (Claude Desktop, ChatGPT). The client redirects to SynthBoard, the user approves, the client gets a refresh token.
- **Bearer token** — for headless and programmatic use (CI, agent frameworks). Generate from your dashboard.

## Production-grade behavior

- **Per-Synth multi-LLM** — Synths are routed to the best model for the question type.
- **Idempotency** — every tool call accepts an idempotency key.
- **Budget alerts** — server-pushed notifications when a session crosses a credit threshold.
- **Stuck-task sweep** — sessions that hang are auto-recovered.
- **CORS** — strict, origin-allowlisted.
- **Correlation IDs** — every request tagged for end-to-end debugging.
- **Outbound webhooks** — session.complete, outcomes.ready, action.executed.

## Quick setup

1. Generate a token at https://www.synthboard.ai/settings/api-keys (Bearer) or use the OAuth flow from your client.
2. Add the SynthBoard MCP endpoint to your client config: `https://www.synthboard.ai/api/mcp`.
3. Restart the client; the SynthBoard tools appear automatically.
4. Test with the `synthboard_ping` tool.

Per-client step-by-step: [https://www.synthboard.ai/mcp/help](https://www.synthboard.ai/mcp/help)

## Pricing

The MCP server is included on every paid tier (Pro, Max, Ultra). Free tier supports MCP for sessions within the free credit budget. Sessions run via MCP draw from the same credit pool as web sessions — same pricing, same cost-per-session as the web app.

## Why MCP, not "yet another API"

REST APIs are great for embedding the board in your own product. MCP is better when *you* are the user — when you live inside Claude Desktop, Cursor, or ChatGPT all day and you want the board reachable from there without context switching.

You can use both. They share the same backend and the same credits.

## Further reading

- [MCP setup walkthrough](https://www.synthboard.ai/mcp/help)
- [REST API](https://www.synthboard.ai/api)
- [Integrations](https://www.synthboard.ai/docs/integrations)
- [API reference](https://www.synthboard.ai/docs/api)
- [Webhooks](https://www.synthboard.ai/docs/webhooks)

## How to cite this page

> SynthBoard MCP server — run the AI boardroom from any MCP client. https://www.synthboard.ai/mcp

Site: https://www.synthboard.ai