MCP tools
Endpoint: https://constitute.splashstudio.ai/api/mcp, Streamable HTTP. Authenticate with Authorization: Bearer cst_live_…. Every tool result begins with version: 1; errors are typed with a human-readable message; no tool ever returns a secret.
| Tool | Scope | What it does |
|---|---|---|
get_state | state:read | Draft counts and top drafts, lanes, Convention progress, pending amendments, publisher status, warnings. |
get_constitution | corpus:read | Preamble, boundaries, voice, workflow rules, position index and samples. Call this before drafting. |
search_corpus | corpus:read | Ranked Articles with provenance and a quotable flag. Input: query, types?, topics?, platform?, k?. |
list_drafts | drafts:read | Drafts with bodies and cited Articles. Input: status?, platform?, limit?. |
submit_draft | drafts:write | Submit a draft. It always lands as Draft. Input: platform, title, body, citedEntryIds?, clientRequestId?, notes?. Returns an error until the Bill of Rights is complete. |
ratify_draft | drafts:decide | Ratify a draft. Replay-safe. |
veto_draft | drafts:decide | Veto with an optional reason. Always ask the person for a reason; reasons teach the Constitution. |
edit_draft | drafts:decide | Replace a draft's text. It stays a Draft. |
run_convention | convention:run | action: next, file, skip, status, preamble or file_preamble. |
run_session | convention:run | action: open, next, answer or skip, with questionId?, verdict?, text?. |
propose_entry | corpus:propose | Propose an Article. It lands as a pending amendment, never directly. |
list_amendments | amendments:decide or state:read | List amendments, optionally by status. |
decide_amendment | amendments:decide | Accept or reject. Accepting changes the Constitution. |
get_kpis | kpis:read | Ratified-as-drafted, edit and veto rates over 7 or 28 days. |
Doctrine the tools carry
- Load the Constitution before drafting and search before every claim.
- Cite the Articles you used. Never state a non-quotable Article as fact.
- Always ask the person for a veto reason.
- Never ratify without the person’s explicit say-so.
Prompts
constitutional_convention, weekly_session and draft_as_me, for clients that support the prompts primitive. The tools work everywhere.
Scopes
New keys default to state:read, corpus:read, drafts:read, drafts:write, convention:run, corpus:propose and kpis:read. The two decide scopes, drafts:decide and amendments:decide, are off by default and opt-in, because a delegate holding both write and decide could ratify its own drafts.