council-ai

Send a prompt to a council of frontier AI models across 9 labs (Anthropic, OpenAI, Google, xAI, DeepSeek, Qwen, Mistral, Moonshot, z.ai). Returns each model's independent response plus a moderator-synthesized consensus answer with an agreement score and the key point of disagreement, when one exists. Use when a single-model answer might hallucinate or when verification across labs matters (research, contracts, architecture, legal, medical, code review). Adaptive-cost pattern: for a quick check, call with 2-3 models; if consensusScore comes back low (or keyDisagreement matters to the decision), escalate by re-running with more models — easy questions stay cheap, disputed ones get more compute. TIMEOUTS: a full council can run for minutes. If your MCP client has a fixed tool-call timeout, set async=true — you get a queryId back immediately and fetch the finished result with council_result. Call council_models first to pick specific model IDs, and council_usage to check remaining budget. Bills against the user's Council AI monthly budget.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000,
      "description": "The question or task to send to the council. Include all needed context — every query is stateless. Example: \"Is optimistic locking or a distributed lock the better fit for this checkout flow? [paste flow description]\""
    },
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 10,
      "description": "Model IDs to include (2-10). Defaults to a cross-lab flagship council. Use council_models to list available IDs. Example: [\"claude-fable-5.1\", \"gpt-5.6-sol\", \"gemini-3.8-flash\"]"
    },
    "synthesize": {
      "type": "boolean",
      "default": true,
      "description": "When true (default), include the moderator synthesis + consensus score. Set false to get only the raw per-model responses (faster, cheaper)."
    },
    "synthesisDirective": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8000,
      "description": "Optional instructions for the moderator that synthesizes the council's answers. The council models never see this — it only shapes the synthesis. Use for special modes, e.g. devil's advocate: \"Argue against the majority position — find the strongest case that the consensus is wrong and surface every dissenting point.\" Or output contracts: \"Answer VERDICT: SAFE/UNSAFE first, then justification.\" Omit for the standard balanced synthesis."
    },
    "mode": {
      "type": "string",
      "enum": [
        "independent",
        "sequential"
      ],
      "default": "independent",
      "description": "Cross-model visibility. 'independent' (default): all models answer in parallel, blind to each other — best for unbiased comparison; the synthesis reconciles them. 'sequential': models answer one at a time and each later model sees the earlier answers, debate-style — takes the SUM of per-model latencies instead of the max, so strongly consider async=true with it."
    },
    "async": {
      "type": "boolean",
      "default": false,
      "description": "When true, return {queryId, status:\"running\"} immediately instead of waiting for the council. Fetch the finished result with council_result. Use whenever your MCP client enforces a fixed tool-call timeout (a full council typically runs 1-3 minutes) or when querying 4+ models."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "queryId": {
      "type": "string",
      "description": "Server-side ID of this council query. With async=true, pass it to council_result."
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "complete",
        "failed"
      ],
      "description": "Only present on async queries: \"running\" means poll council_result with the queryId."
    },
    "synthesis": {
      "type": "string",
      "description": "Moderator-synthesized consensus answer across all models. Empty when synthesize=false; absent while an async query is still running."
    },
    "consensusScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "Cross-model agreement score on the 0-100 scale. Null when synthesize=false; absent while an async query is still running."
    },
    "agreementType": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "high",
            "divergent"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Agreement classification from the moderator's analysis. Null when synthesize=false."
    },
    "keyDisagreement": {
      "type": [
        "string",
        "null"
      ],
      "description": "The main point the models disagreed on, when one was identified. Often more decision-relevant than the consensus itself — inspect it before acting on a low consensusScore. Null on high agreement or when synthesize=false."
    },
    "perModelResponses": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Each model's independent response, keyed by model name. Absent while an async query is still running."
    },
    "modelMapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Anonymous reviewer label (M1..Mn) to model name mapping used during synthesis."
    },
    "totalTokens": {
      "type": "object",
      "properties": {
        "input": {
          "type": "number",
          "description": "Prompt tokens across all council models."
        },
        "output": {
          "type": "number",
          "description": "Completion tokens across all council models."
        }
      },
      "required": [
        "input",
        "output"
      ],
      "additionalProperties": false,
      "description": "Aggregate token usage for this query across the whole council."
    },
    "durationMs": {
      "type": "number",
      "description": "Wall-clock duration of the council run (fan-out + synthesis), in milliseconds."
    },
    "budgetPercentUsed": {
      "type": [
        "number",
        "null"
      ],
      "description": "The user's monthly Council budget consumption after this query, as a percentage (0-100+). Use it to decide whether another query is affordable. Council never reports budget in dollar amounts — always reason and communicate in percentages."
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "modelId": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "modelId",
          "message"
        ],
        "additionalProperties": false
      },
      "description": "Per-model failures, if any. The synthesis covers the models that responded."
    },
    "droppedModelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Requested model IDs that were skipped (unknown or retired). Call council_models for current IDs."
    },
    "timedOutModelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Council members that failed by exceeding the per-model timeout. On a synchronous run (90s per model) this is recoverable: re-run the same query with async=true, which allows 300s. Slow reasoning models will time out on EVERY synchronous call."
    },
    "wasSyncRun": {
      "type": "boolean",
      "description": "True when this ran synchronously — the path with the tight per-model timeout."
    },
    "consensusUnavailable": {
      "type": "boolean",
      "description": "True when the moderator's agreement verdict could not be parsed, so this run has no consensus score at all. Do not substitute a number — report agreement as unknown."
    },
    "synthesisError": {
      "type": [
        "string",
        "null"
      ],
      "description": "Set when moderator synthesis failed and the response degraded to raw per-model output."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch the result of a council_query started with async=true. Returns status "running" while the council is still working (wait 30-60 seconds and call again), the full synthesis + per-model responses once complete, or status "failed" with the error. Polling is free — the council run itself was already billed by council_query.

{
  "type": "object",
  "properties": {
    "queryId": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "The queryId returned by council_query when called with async=true."
    }
  },
  "required": [
    "queryId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "queryId": {
      "type": "string",
      "description": "The polled query ID."
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "complete",
        "failed"
      ],
      "description": "running → poll again in 30-60s. complete → full result below. failed → see error."
    },
    "error": {
      "type": "string",
      "description": "Failure reason when status is \"failed\"."
    },
    "elapsedMs": {
      "type": [
        "number",
        "null"
      ],
      "description": "Time since the query started, while running."
    },
    "synthesis": {
      "type": "string",
      "description": "Moderator-synthesized consensus answer. Present when status is \"complete\"."
    },
    "consensusScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "Cross-model agreement score, 0-100. Null when the query ran with synthesize=false."
    },
    "agreementType": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "high",
            "divergent"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Agreement classification from the moderator's analysis."
    },
    "keyDisagreement": {
      "type": [
        "string",
        "null"
      ],
      "description": "The main point the models disagreed on, when one was identified."
    },
    "perModelResponses": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Each model's independent response, keyed by anonymous label (M1..Mn)."
    },
    "modelMapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Anonymous label (M1..Mn) to model ID mapping."
    },
    "totalTokens": {
      "type": "object",
      "properties": {
        "input": {
          "type": "number"
        },
        "output": {
          "type": "number"
        }
      },
      "required": [
        "input",
        "output"
      ],
      "additionalProperties": false,
      "description": "Aggregate token usage across the whole council."
    },
    "durationMs": {
      "type": [
        "number",
        "null"
      ],
      "description": "Wall-clock duration of the council run, in milliseconds."
    },
    "budgetPercentUsed": {
      "type": [
        "number",
        "null"
      ],
      "description": "Monthly Council budget consumption, as a percentage (0-100+). Never dollars."
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "modelId": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "modelId",
          "message"
        ],
        "additionalProperties": false
      },
      "description": "Per-model failures, if any. The synthesis covers the models that responded."
    },
    "droppedModelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Requested model IDs that were skipped (unknown or retired)."
    },
    "synthesisError": {
      "type": [
        "string",
        "null"
      ],
      "description": "Set when moderator synthesis failed and the response degraded to raw per-model output."
    }
  },
  "required": [
    "queryId",
    "status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Like council_query, but first retrieves the most relevant passages from the user's personal Council RAG library (uploaded PDFs, Word docs, contracts, research papers, codebases) and injects them into every model's prompt. Use when the question is about content the user has uploaded — contract review, research synthesis across a paper library, code review against an architecture doc, etc. Ultra-tier only.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000,
      "description": "The question or task to send to the council. Example: \"Review this NDA draft against our standard playbook terms.\""
    },
    "library_query": {
      "type": "string",
      "description": "Optional retrieval-specific query. If omitted, the main prompt is used as the retrieval query. Set this when the user's prompt has unrelated framing but the concrete documents to retrieve are described by something different."
    },
    "retrieval_limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "description": "Number of chunks to retrieve. Default: 8."
    },
    "project_id": {
      "type": "string",
      "description": "Restrict retrieval to a specific Council project workspace."
    },
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 10,
      "description": "Model IDs to include. Defaults to the user's preferred council."
    },
    "synthesize": {
      "type": "boolean",
      "default": true,
      "description": "When true (default), include the moderator synthesis + consensus score."
    },
    "async": {
      "type": "boolean",
      "default": false,
      "description": "When true, retrieval runs immediately (sources are returned right away) but the council itself runs in the background — fetch the finished answer with council_result. Use when your MCP client enforces a fixed tool-call timeout or when querying 4+ models."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "queryId": {
      "type": "string",
      "description": "Present on async queries — pass it to council_result."
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "complete",
        "failed"
      ],
      "description": "Only present on async queries: \"running\" means poll council_result with the queryId."
    },
    "synthesis": {
      "type": "string",
      "description": "Moderator-synthesized consensus answer, grounded in the retrieved library chunks. Absent while an async query is still running."
    },
    "consensusScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "Cross-model agreement score on the 0-100 scale. Null when synthesize=false; absent while an async query is still running."
    },
    "perModelResponses": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Each model's independent response, keyed by model name. Absent while an async query is still running."
    },
    "retrievedChunks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "chunkId": {
            "type": "string",
            "description": "ID of the retrieved chunk."
          },
          "documentId": {
            "type": "string",
            "description": "ID of the parent document."
          },
          "filename": {
            "type": "string",
            "description": "Source document filename."
          },
          "content": {
            "type": "string",
            "description": "The retrieved passage text."
          },
          "pageNumber": {
            "type": [
              "number",
              "null"
            ],
            "description": "Page number in the source document, when known."
          },
          "distance": {
            "type": "number",
            "description": "Vector distance — lower is more relevant."
          }
        },
        "additionalProperties": false
      },
      "description": "Library chunks that were injected into every model's prompt. Empty when the library had no relevant content."
    },
    "ragSkipped": {
      "type": "boolean",
      "description": "True when retrieval found nothing and the query fell through to a plain council_query."
    }
  },
  "required": [
    "retrievedChunks"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Multi-model code review. Sends a unified diff (or code snippet) to multiple frontier AI models from different labs in parallel, each acting as an independent reviewer with an explicit verdict + findings contract. Returns a verdict-first synthesis: overall SHIP/NO-SHIP, consensus score, confirmed findings (flagged by 2+ models), then dissents (single-model findings with reasoning), then each reviewer's verdict. Diffs are capped at 14,000 characters — split larger changes by file or hunk and call once per chunk. Bills against the user's Council AI monthly budget like any council query.

{
  "type": "object",
  "properties": {
    "diff": {
      "type": "string",
      "minLength": 1,
      "description": "The unified diff (git diff output) or code snippet to review. Max 14,000 characters — if your diff is larger, split it by file or hunk and review each part separately. Example: the output of `git diff HEAD~1`."
    },
    "focus": {
      "type": "string",
      "enum": [
        "bugs",
        "security",
        "performance",
        "architecture",
        "all"
      ],
      "default": "all",
      "description": "Review focus: \"bugs\" (correctness), \"security\", \"performance\", \"architecture\", or \"all\" (default — full review, bugs prioritized)."
    },
    "context": {
      "type": "string",
      "maxLength": 3000,
      "description": "What the change is supposed to do: intent, constraints, related files or invariants reviewers cannot see from the diff alone. Improves signal, reduces false positives."
    },
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 10,
      "description": "Model IDs to include as reviewers (2-10). Defaults to the user's preferred council. Use council_models to list available IDs."
    },
    "async": {
      "type": "boolean",
      "default": false,
      "description": "When true, return {queryId, status:\"running\"} immediately and fetch the finished review with council_result. Use when your MCP client enforces a fixed tool-call timeout, or with 4+ reviewers — async runs also give slow reasoning models a much larger time budget before they are cut off."
    }
  },
  "required": [
    "diff"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "queryId": {
      "type": "string",
      "description": "Server-side ID of this review query. With async=true, pass it to council_result."
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "complete",
        "failed"
      ],
      "description": "Only present on async reviews: \"running\" means poll council_result with the queryId."
    },
    "synthesis": {
      "type": "string",
      "description": "Verdict-first moderator synthesis: ## Council Verdict (SHIP/NO-SHIP), ## Confirmed Findings (2+ reviewers agree), ## Dissents, ## Reviewer Verdicts. Absent while an async review is still running."
    },
    "consensusScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "Cross-reviewer agreement score on the 0-100 scale. Absent while an async review is still running."
    },
    "perModelResponses": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Each reviewer model's raw independent review, keyed by model name. Absent while an async review is still running."
    },
    "modelMapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Anonymous reviewer label (M1..Mn) to model name mapping — how dissents are attributed."
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "modelId": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "modelId",
          "message"
        ],
        "additionalProperties": false
      },
      "description": "Per-reviewer failures, if any."
    },
    "focus": {
      "type": "string",
      "enum": [
        "bugs",
        "security",
        "performance",
        "architecture",
        "all"
      ],
      "description": "The review focus this synthesis was produced under."
    }
  },
  "required": [
    "focus"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Semantic search over the user's Council RAG library (uploaded PDFs, Word docs, contracts, research papers, codebases). Returns top-K chunks with source filename and page number. No model call, no budget consumption. Use to find direct quotes, check what the library contains, or scope a follow-up council_query_with_rag call.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Semantic retrieval query — describe the content you want, not keywords. Example: \"termination and notice-period clauses in the vendor agreement\""
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "description": "Number of chunks to return, 1-20. Default: 8."
    },
    "project_id": {
      "type": "string",
      "description": "Restrict retrieval to a specific Council project workspace ID. Omit to search the whole library."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "hits": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "chunkId": {
            "type": "string",
            "description": "ID of the matched chunk."
          },
          "documentId": {
            "type": "string",
            "description": "ID of the parent document."
          },
          "filename": {
            "type": "string",
            "description": "Source document filename."
          },
          "content": {
            "type": "string",
            "description": "The matched passage text."
          },
          "pageNumber": {
            "type": [
              "number",
              "null"
            ],
            "description": "Page number in the source document, when known."
          },
          "distance": {
            "type": "number",
            "description": "Vector distance — lower is more relevant."
          }
        },
        "additionalProperties": false
      },
      "description": "Top-K matching chunks, most relevant first. Empty when nothing matches."
    }
  },
  "required": [
    "hits"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the documents in the user's Council RAG library. Returns id, filename, source type, ingestion status, chunk count, and upload date for each document. No retrieval, no budget consumption.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Document ID."
          },
          "filename": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original filename as uploaded."
          },
          "sourceType": {
            "type": [
              "string",
              "null"
            ],
            "description": "Source type, e.g. pdf or docx."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ingestion status, e.g. ready or processing."
          },
          "projectId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Project workspace the document belongs to, if any."
          },
          "chunkCount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of indexed chunks."
          },
          "sizeBytes": {
            "type": [
              "number",
              "null"
            ],
            "description": "File size in bytes."
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "Upload timestamp, ISO 8601."
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      },
      "description": "Every document in the user's library, newest first. Empty when the library has no documents."
    }
  },
  "required": [
    "documents"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Upload a document into the user's Council RAG library so future council_query_with_rag and library_search calls can retrieve it. Accepts PDF, Word (docx), text, and markdown files as base64 — images are not supported. Max 10MB per file via MCP (the web library at https://council-ai.app/settings?tab=library takes up to 50MB); libraries hold up to 200 documents. Ingestion (chunking + embedding) runs in the background: the returned document starts in "pending" status — check library_list for it to reach "ready" before querying against it. No model call, no budget consumption.

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Original filename including extension — the extension drives type detection. Example: \"vendor-contract-2026.pdf\"."
    },
    "contentBase64": {
      "type": "string",
      "minLength": 1,
      "description": "The file's raw bytes, base64-encoded (standard alphabet, no data: URI prefix). For a plain-text or markdown document, base64-encode the UTF-8 text."
    },
    "mimeType": {
      "type": "string",
      "maxLength": 255,
      "description": "MIME type, e.g. \"application/pdf\". Optional — the backend verifies the real type from the file's magic bytes regardless."
    },
    "projectId": {
      "type": "string",
      "description": "Council project workspace to file the document under. Omit for the general library."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Free-form tags to attach to the document, e.g. [\"contracts\", \"2026\"]."
    }
  },
  "required": [
    "filename",
    "contentBase64"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "document": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Document ID — use with library_delete or to track ingestion."
        },
        "filename": {
          "type": "string",
          "description": "Sanitized filename as stored."
        },
        "status": {
          "type": "string",
          "description": "Ingestion status. Starts \"pending\"; becomes \"ready\" when queryable, or \"failed\" with errorMessage."
        },
        "sizeBytes": {
          "type": "number",
          "description": "Stored file size in bytes."
        },
        "mimeType": {
          "type": "string",
          "description": "Verified MIME type."
        },
        "sourceType": {
          "type": "string",
          "description": "Detected source type, e.g. pdf or docx."
        },
        "projectId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Project workspace, when set."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Tags as stored."
        },
        "createdAt": {
          "type": "string",
          "description": "Upload timestamp, ISO 8601."
        }
      },
      "required": [
        "id",
        "filename",
        "status",
        "sizeBytes"
      ],
      "additionalProperties": false,
      "description": "The created document record, in \"pending\" status until background ingestion completes."
    }
  },
  "required": [
    "document"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Permanently delete a document from the user's Council RAG library — the record, every indexed chunk, AND the stored file are removed. This cannot be undone; re-adding the document requires uploading it again. Get document IDs from library_list. Use when the user asks to remove a document or when the 200-document library cap blocks an upload. Confirm with the user before deleting anything they did not explicitly name. No model call, no budget consumption.

{
  "type": "object",
  "properties": {
    "documentId": {
      "type": "string",
      "minLength": 1,
      "description": "ID of the document to delete, as returned by library_list or library_upload."
    }
  },
  "required": [
    "documentId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "True when the document and all its data were removed."
    },
    "deletedChunks": {
      "type": "number",
      "description": "Number of indexed chunks that were deleted along with the document."
    }
  },
  "required": [
    "success",
    "deletedChunks"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the AI models available to the current user. Returns ID, provider, tier, context window, and capability flags (web search, vision, streaming). Use the IDs returned here as the `models` array argument to council_query / council_query_with_rag.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "userPlan": {
      "type": "string",
      "description": "The user's current subscription plan."
    },
    "models": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Model ID — pass these in the models argument of council tools."
          },
          "name": {
            "type": "string",
            "description": "Human-readable model name."
          },
          "provider": {
            "type": "string",
            "description": "Lab/provider, e.g. anthropic, openai, google."
          },
          "modelId": {
            "type": "string",
            "description": "Provider-side model identifier."
          },
          "tier": {
            "type": "string",
            "description": "Council pricing tier of the model."
          },
          "maxTokens": {
            "type": [
              "number",
              "null"
            ],
            "description": "Context window size, when known."
          },
          "supportsWebSearch": {
            "type": "boolean",
            "description": "Whether the model can search the web."
          },
          "supportsVision": {
            "type": "boolean",
            "description": "Whether the model accepts images."
          },
          "supportsStreaming": {
            "type": "boolean",
            "description": "Whether the model streams tokens."
          }
        },
        "required": [
          "id",
          "name",
          "provider"
        ],
        "additionalProperties": false
      },
      "description": "Models available to this user, across all providers."
    }
  },
  "required": [
    "userPlan",
    "models"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the user's current monthly cost-budget consumption (current spend, budget cap, percentage used, days until reset). Use to decide whether to warn the user before invoking another council_query, or to suggest using cheaper models. Per Council's rule: never show dollar amounts to the user in the response — use percentages.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "percentUsed": {
      "type": "number",
      "description": "Percentage of the monthly budget consumed, 0-100+."
    },
    "status": {
      "type": "string",
      "description": "Budget status: ok, warning, or exceeded."
    },
    "periodEndsAt": {
      "type": "string",
      "description": "When the current monthly budget cycle resets, ISO 8601."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}