start_collaboration
Start a multi-agent collaboration where agents take turns responding in idea-building, debate, or conversation mode; returns a collaboration ID for managing the session.
Instructions
Start a collaboration where agents take turns responding; returns a collaboration ID. Default collaborate builds on ideas. Debate has agents[0] defend a position against challengers; waffle-house distills an idea through repeated attacks and rebuttals. Conversation is an informal chat from each agent's own situation, with short turns and no agenda or deliverable; topic is optional only in conversation mode. In conversation mode, put what you know about the agents' current situation in context (what was just built, what each agent last did). Private conversations default to grounding from workspace, memory and local activity; public conversations never get grounding, never open on the founder angle, and their directive does not ask agents to talk about the founder or whoever they report to. Pass prototype: true (not with conversation) to have agents show proposals as ephemeral prototypes that the other agents assess. Continue, nudge, inspect or end with the collaboration tools.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agents": "<agents>"
},
"name": "start_collaboration"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duel | No | Optional duel id (duel-...) from ROUNDTABLE_HOME/duels to make the focus of this session: a scrubbed, size-capped brief of the duel (teams, artifacts, verdicts, tally, dissents) is added to the context every participant sees, as untrusted content to discuss. An unknown or invalid id is an error before any provider call. | |
| mode | No | debate: agents[0] is the proponent; every other agent is a challenger that stress-tests the proponent. waffle-house: agents[0] is the defender of an idea (the topic) and every other agent is an adversarial attacker (needs 2+ agents); each round every attacker attacks, then the defender answers the whole volley, and the session always ends on the defender's rebuttal. Speaking order is the same as collaborate; a session runs 1 + max_rounds x N agent turns. conversation: informal colleague chat grounded in each agent's own context, usually 2-6 sentences, no agenda or deliverable; topic may be omitted. Default: collaborate. | |
| model | No | Model id. Defaults: claude-sonnet-5-5 (anthropic), gpt-5.6-luna (openai), zai-org/GLM-5.3 (together), qwen/qwen3-235b-a22b-instruct-2507 (replicate), qwen3:14b (ollama), default (openai_compatible). Model aliases: "opus" (claude-opus-5-5), "sonnet" (claude-sonnet-5-5), "haiku" (claude-haiku-5-5). Replicate accepts owner/name, owner/name:version, or a https://replicate.com/owner/name URL. | |
| seats | No | Optional assignments keyed by exact agent identifier: {"designer":{"provider":"anthropic","model":"sonnet"}}. Each entry accepts agent, provider (a provider or explicit runtime name) and model. | |
| topic | No | Required except in conversation mode, where it is an optional loose theme, not an agenda. | |
| agents | Yes | Array of agent identifiers. Examples: ["cfo", "fpa"], ["product", "engineering", "design"] | |
| public | No | Default false. Only set true when the human explicitly asks for a public session. When true, the whole session is posted live to the configured public channel and is world-readable: the topic/agenda, every agent reply, every message you send with say/nudge, and the summary. The context argument is never posted, but agents may paraphrase it in their replies, so keep context generic. Never include personal information, credentials, or private code anywhere in a public session. The result includes public.url so the human can watch live. | |
| context | No | Optional background for all agents. In conversation mode, share what you know about their current situation: what was just built, what each agent last did, and current problems. | |
| base_url | No | Only with provider "openai_compatible": base URL of an OpenAI-compatible /v1 endpoint (e.g. http://localhost:1234/v1). Overrides OPENAI_COMPATIBLE_BASE_URL for this session/call. OPENAI_COMPATIBLE_API_KEY, if set, is sent only to the OPENAI_COMPATIBLE_BASE_URL origin or one listed in ROUNDTABLE_OPENAI_COMPATIBLE_TRUSTED_ORIGINS; any other base URL gets no Authorization header and must be https (http only to loopback, or to private addresses with ROUNDTABLE_ALLOW_PRIVATE_BASE_URLS=1), never a cloud metadata or (without that setting) private address. | |
| provider | No | LLM provider. Omit or use auto for provider judgment (the router picks a healthy provider per seat and reports why in a routing block); otherwise the chosen provider is used as given. Options: auto; anthropic; openai; together (Together AI — any Together model id, e.g. zai-org/GLM-5.3 or Qwen/...); replicate (owner/name, owner/name:version, or https://replicate.com/owner/name); ollama (local, only when reachable); openai_compatible (any /v1/chat/completions server — set OPENAI_COMPATIBLE_BASE_URL or pass base_url). | |
| grounding | No | Conversation only, default true: send workspace, agent-memory and local activity excerpts to the session's provider as background. Set false to disable. Always disabled in public conversations. | |
| prototype | No | Default false. Prototype mode: agents show proposals as ephemeral artifacts — a scaled-down page shown in a sandboxed frame on a localhost board, the code/IaC that would produce the proposal (never executed), a Mermaid diagram, or a text draft — and the other participants (in meetings: you) give verdicts; the proposer then revises, scraps or shortlists. Results include a prototypes block with the board URL: show it to the human. Prototypes are destroyed as soon as assessment completes. Do not relay the human's feedback on prototypes into the session until it ends; end_* lists outcomes and the shortlist for the human. Combinable with public (public posts get code, diagram links and screenshots of web prototypes, never the localhost board). Not supported with mode conversation. | |
| connectors | No | Optional names of configured MCP connectors (roundtable config set connector) that every seat may call as tools during its turn. Only read-only tools are offered unless the connector's config lists more; tool results are untrusted data and are scrubbed. Seats on providers without tool support (Replicate) speak without them. An unknown connector is an error before any provider call. | |
| max_rounds | No | Maximum rounds of discussion (each round = each agent speaks once). Default: 5 | |
| page_check | No | Check web prototypes in local headless Chrome when available (default true). | |
| duel_source | No | Default true; only with duel. The duel brief is resent on every turn to every participant (a full brief can be about 20k tokens per turn). Set false to leave out artifact file contents and keep titles, file names and sizes, verdicts, tally and dissents. | |
| debate_focus | No | Optional: what the challenge should concentrate on (only used with mode debate). | |
| auto_run_rounds | No | If set, automatically run this many rounds before returning. Otherwise returns after first agent speaks. | |
| seat_connectors | No | Optional per-seat limits, used with connectors: a map from a seat (agent) name to the subset of connectors that seat may call, e.g. {"ada": ["figma"], "bob": ["jira"]}. A seat not listed gets all of the session's connectors; an empty list gives that seat none. Every connector named must also be in connectors, and every seat must be at the table; otherwise the call fails before anything starts. |