Server definition
- Hash
- sha256:bab33855593e97934e26d5215706743c0b497e95962ae4958db69570d0acb3ef
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "council_models",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"models": {
"description": "Models available to this user, across all providers.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Model ID — pass these in the models argument of council tools.",
"type": "string"
},
"maxTokens": {
"description": "Context window size, when known.",
"type": [
"number",
"null"
]
},
"modelId": {
"description": "Provider-side model identifier.",
"type": "string"
},
"name": {
"description": "Human-readable model name.",
"type": "string"
},
"provider": {
"description": "Lab/provider, e.g. anthropic, openai, google.",
"type": "string"
},
"supportsStreaming": {
"description": "Whether the model streams tokens.",
"type": "boolean"
},
"supportsVision": {
"description": "Whether the model accepts images.",
"type": "boolean"
},
"supportsWebSearch": {
"description": "Whether the model can search the web.",
"type": "boolean"
},
"tier": {
"description": "Council pricing tier of the model.",
"type": "string"
}
},
"required": [
"id",
"name",
"provider"
],
"type": "object"
},
"type": "array"
},
"userPlan": {
"description": "The user's current subscription plan.",
"type": "string"
}
},
"required": [
"userPlan",
"models"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"async": {
"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.",
"type": "boolean"
},
"mode": {
"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.",
"enum": [
"independent",
"sequential"
],
"type": "string"
},
"models": {
"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\"]",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array"
},
"prompt": {
"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]\"",
"maxLength": 20000,
"minLength": 1,
"type": "string"
},
"synthesisDirective": {
"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.",
"maxLength": 8000,
"minLength": 1,
"type": "string"
},
"synthesize": {
"default": true,
"description": "When true (default), include the moderator synthesis + consensus score. Set false to get only the raw per-model responses (faster, cheaper).",
"type": "boolean"
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "council_query",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"agreementType": {
"anyOf": [
{
"enum": [
"high",
"divergent"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Agreement classification from the moderator's analysis. Null when synthesize=false."
},
"budgetPercentUsed": {
"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.",
"type": [
"number",
"null"
]
},
"consensusScore": {
"description": "Cross-model agreement score on the 0-100 scale. Null when synthesize=false; absent while an async query is still running.",
"type": [
"number",
"null"
]
},
"consensusUnavailable": {
"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.",
"type": "boolean"
},
"droppedModelIds": {
"description": "Requested model IDs that were skipped (unknown or retired). Call council_models for current IDs.",
"items": {
"type": "string"
},
"type": "array"
},
"durationMs": {
"description": "Wall-clock duration of the council run (fan-out + synthesis), in milliseconds.",
"type": "number"
},
"errors": {
"description": "Per-model failures, if any. The synthesis covers the models that responded.",
"items": {
"additionalProperties": false,
"properties": {
"message": {
"type": "string"
},
"modelId": {
"type": "string"
}
},
"required": [
"modelId",
"message"
],
"type": "object"
},
"type": "array"
},
"keyDisagreement": {
"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.",
"type": [
"string",
"null"
]
},
"modelMapping": {
"additionalProperties": {
"type": "string"
},
"description": "Anonymous reviewer label (M1..Mn) to model name mapping used during synthesis.",
"type": "object"
},
"perModelResponses": {
"additionalProperties": {
"type": "string"
},
"description": "Each model's independent response, keyed by model name. Absent while an async query is still running.",
"type": "object"
},
"queryId": {
"description": "Server-side ID of this council query. With async=true, pass it to council_result.",
"type": "string"
},
"status": {
"description": "Only present on async queries: \"running\" means poll council_result with the queryId.",
"enum": [
"running",
"complete",
"failed"
],
"type": "string"
},
"synthesis": {
"description": "Moderator-synthesized consensus answer across all models. Empty when synthesize=false; absent while an async query is still running.",
"type": "string"
},
"synthesisError": {
"description": "Set when moderator synthesis failed and the response degraded to raw per-model output.",
"type": [
"string",
"null"
]
},
"timedOutModelIds": {
"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.",
"items": {
"type": "string"
},
"type": "array"
},
"totalTokens": {
"additionalProperties": false,
"description": "Aggregate token usage for this query across the whole council.",
"properties": {
"input": {
"description": "Prompt tokens across all council models.",
"type": "number"
},
"output": {
"description": "Completion tokens across all council models.",
"type": "number"
}
},
"required": [
"input",
"output"
],
"type": "object"
},
"wasSyncRun": {
"description": "True when this ran synchronously — the path with the tight per-model timeout.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"async": {
"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.",
"type": "boolean"
},
"library_query": {
"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.",
"type": "string"
},
"models": {
"description": "Model IDs to include. Defaults to the user's preferred council.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array"
},
"project_id": {
"description": "Restrict retrieval to a specific Council project workspace.",
"type": "string"
},
"prompt": {
"description": "The question or task to send to the council. Example: \"Review this NDA draft against our standard playbook terms.\"",
"maxLength": 20000,
"minLength": 1,
"type": "string"
},
"retrieval_limit": {
"description": "Number of chunks to retrieve. Default: 8.",
"maximum": 20,
"minimum": 1,
"type": "number"
},
"synthesize": {
"default": true,
"description": "When true (default), include the moderator synthesis + consensus score.",
"type": "boolean"
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "council_query_with_rag",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"consensusScore": {
"description": "Cross-model agreement score on the 0-100 scale. Null when synthesize=false; absent while an async query is still running.",
"type": [
"number",
"null"
]
},
"perModelResponses": {
"additionalProperties": {
"type": "string"
},
"description": "Each model's independent response, keyed by model name. Absent while an async query is still running.",
"type": "object"
},
"queryId": {
"description": "Present on async queries — pass it to council_result.",
"type": "string"
},
"ragSkipped": {
"description": "True when retrieval found nothing and the query fell through to a plain council_query.",
"type": "boolean"
},
"retrievedChunks": {
"description": "Library chunks that were injected into every model's prompt. Empty when the library had no relevant content.",
"items": {
"additionalProperties": false,
"properties": {
"chunkId": {
"description": "ID of the retrieved chunk.",
"type": "string"
},
"content": {
"description": "The retrieved passage text.",
"type": "string"
},
"distance": {
"description": "Vector distance — lower is more relevant.",
"type": "number"
},
"documentId": {
"description": "ID of the parent document.",
"type": "string"
},
"filename": {
"description": "Source document filename.",
"type": "string"
},
"pageNumber": {
"description": "Page number in the source document, when known.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"status": {
"description": "Only present on async queries: \"running\" means poll council_result with the queryId.",
"enum": [
"running",
"complete",
"failed"
],
"type": "string"
},
"synthesis": {
"description": "Moderator-synthesized consensus answer, grounded in the retrieved library chunks. Absent while an async query is still running.",
"type": "string"
}
},
"required": [
"retrievedChunks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"queryId": {
"description": "The queryId returned by council_query when called with async=true.",
"maxLength": 40,
"minLength": 10,
"type": "string"
}
},
"required": [
"queryId"
],
"type": "object"
},
"name": "council_result",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"agreementType": {
"anyOf": [
{
"enum": [
"high",
"divergent"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Agreement classification from the moderator's analysis."
},
"budgetPercentUsed": {
"description": "Monthly Council budget consumption, as a percentage (0-100+). Never dollars.",
"type": [
"number",
"null"
]
},
"consensusScore": {
"description": "Cross-model agreement score, 0-100. Null when the query ran with synthesize=false.",
"type": [
"number",
"null"
]
},
"droppedModelIds": {
"description": "Requested model IDs that were skipped (unknown or retired).",
"items": {
"type": "string"
},
"type": "array"
},
"durationMs": {
"description": "Wall-clock duration of the council run, in milliseconds.",
"type": [
"number",
"null"
]
},
"elapsedMs": {
"description": "Time since the query started, while running.",
"type": [
"number",
"null"
]
},
"error": {
"description": "Failure reason when status is \"failed\".",
"type": "string"
},
"errors": {
"description": "Per-model failures, if any. The synthesis covers the models that responded.",
"items": {
"additionalProperties": false,
"properties": {
"message": {
"type": "string"
},
"modelId": {
"type": "string"
}
},
"required": [
"modelId",
"message"
],
"type": "object"
},
"type": "array"
},
"keyDisagreement": {
"description": "The main point the models disagreed on, when one was identified.",
"type": [
"string",
"null"
]
},
"modelMapping": {
"additionalProperties": {
"type": "string"
},
"description": "Anonymous label (M1..Mn) to model ID mapping.",
"type": "object"
},
"perModelResponses": {
"additionalProperties": {
"type": "string"
},
"description": "Each model's independent response, keyed by anonymous label (M1..Mn).",
"type": "object"
},
"queryId": {
"description": "The polled query ID.",
"type": "string"
},
"status": {
"description": "running → poll again in 30-60s. complete → full result below. failed → see error.",
"enum": [
"running",
"complete",
"failed"
],
"type": "string"
},
"synthesis": {
"description": "Moderator-synthesized consensus answer. Present when status is \"complete\".",
"type": "string"
},
"synthesisError": {
"description": "Set when moderator synthesis failed and the response degraded to raw per-model output.",
"type": [
"string",
"null"
]
},
"totalTokens": {
"additionalProperties": false,
"description": "Aggregate token usage across the whole council.",
"properties": {
"input": {
"type": "number"
},
"output": {
"type": "number"
}
},
"required": [
"input",
"output"
],
"type": "object"
}
},
"required": [
"queryId",
"status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"async": {
"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.",
"type": "boolean"
},
"context": {
"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.",
"maxLength": 3000,
"type": "string"
},
"diff": {
"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`.",
"minLength": 1,
"type": "string"
},
"focus": {
"default": "all",
"description": "Review focus: \"bugs\" (correctness), \"security\", \"performance\", \"architecture\", or \"all\" (default — full review, bugs prioritized).",
"enum": [
"bugs",
"security",
"performance",
"architecture",
"all"
],
"type": "string"
},
"models": {
"description": "Model IDs to include as reviewers (2-10). Defaults to the user's preferred council. Use council_models to list available IDs.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array"
}
},
"required": [
"diff"
],
"type": "object"
},
"name": "council_review",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"consensusScore": {
"description": "Cross-reviewer agreement score on the 0-100 scale. Absent while an async review is still running.",
"type": [
"number",
"null"
]
},
"errors": {
"description": "Per-reviewer failures, if any.",
"items": {
"additionalProperties": false,
"properties": {
"message": {
"type": "string"
},
"modelId": {
"type": "string"
}
},
"required": [
"modelId",
"message"
],
"type": "object"
},
"type": "array"
},
"focus": {
"description": "The review focus this synthesis was produced under.",
"enum": [
"bugs",
"security",
"performance",
"architecture",
"all"
],
"type": "string"
},
"modelMapping": {
"additionalProperties": {
"type": "string"
},
"description": "Anonymous reviewer label (M1..Mn) to model name mapping — how dissents are attributed.",
"type": "object"
},
"perModelResponses": {
"additionalProperties": {
"type": "string"
},
"description": "Each reviewer model's raw independent review, keyed by model name. Absent while an async review is still running.",
"type": "object"
},
"queryId": {
"description": "Server-side ID of this review query. With async=true, pass it to council_result.",
"type": "string"
},
"status": {
"description": "Only present on async reviews: \"running\" means poll council_result with the queryId.",
"enum": [
"running",
"complete",
"failed"
],
"type": "string"
},
"synthesis": {
"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.",
"type": "string"
}
},
"required": [
"focus"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "council_usage",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"percentUsed": {
"description": "Percentage of the monthly budget consumed, 0-100+.",
"type": "number"
},
"periodEndsAt": {
"description": "When the current monthly budget cycle resets, ISO 8601.",
"type": "string"
},
"status": {
"description": "Budget status: ok, warning, or exceeded.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"documentId": {
"description": "ID of the document to delete, as returned by library_list or library_upload.",
"minLength": 1,
"type": "string"
}
},
"required": [
"documentId"
],
"type": "object"
},
"name": "library_delete",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"deletedChunks": {
"description": "Number of indexed chunks that were deleted along with the document.",
"type": "number"
},
"success": {
"description": "True when the document and all its data were removed.",
"type": "boolean"
}
},
"required": [
"success",
"deletedChunks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "library_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"documents": {
"description": "Every document in the user's library, newest first. Empty when the library has no documents.",
"items": {
"additionalProperties": false,
"properties": {
"chunkCount": {
"description": "Number of indexed chunks.",
"type": [
"number",
"null"
]
},
"createdAt": {
"description": "Upload timestamp, ISO 8601.",
"type": [
"string",
"null"
]
},
"filename": {
"description": "Original filename as uploaded.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Document ID.",
"type": "string"
},
"projectId": {
"description": "Project workspace the document belongs to, if any.",
"type": [
"string",
"null"
]
},
"sizeBytes": {
"description": "File size in bytes.",
"type": [
"number",
"null"
]
},
"sourceType": {
"description": "Source type, e.g. pdf or docx.",
"type": [
"string",
"null"
]
},
"status": {
"description": "Ingestion status, e.g. ready or processing.",
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"documents"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Number of chunks to return, 1-20. Default: 8.",
"maximum": 20,
"minimum": 1,
"type": "number"
},
"project_id": {
"description": "Restrict retrieval to a specific Council project workspace ID. Omit to search the whole library.",
"type": "string"
},
"query": {
"description": "Semantic retrieval query — describe the content you want, not keywords. Example: \"termination and notice-period clauses in the vendor agreement\"",
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "library_search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"hits": {
"description": "Top-K matching chunks, most relevant first. Empty when nothing matches.",
"items": {
"additionalProperties": false,
"properties": {
"chunkId": {
"description": "ID of the matched chunk.",
"type": "string"
},
"content": {
"description": "The matched passage text.",
"type": "string"
},
"distance": {
"description": "Vector distance — lower is more relevant.",
"type": "number"
},
"documentId": {
"description": "ID of the parent document.",
"type": "string"
},
"filename": {
"description": "Source document filename.",
"type": "string"
},
"pageNumber": {
"description": "Page number in the source document, when known.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"hits"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contentBase64": {
"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.",
"minLength": 1,
"type": "string"
},
"filename": {
"description": "Original filename including extension — the extension drives type detection. Example: \"vendor-contract-2026.pdf\".",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"mimeType": {
"description": "MIME type, e.g. \"application/pdf\". Optional — the backend verifies the real type from the file's magic bytes regardless.",
"maxLength": 255,
"type": "string"
},
"projectId": {
"description": "Council project workspace to file the document under. Omit for the general library.",
"type": "string"
},
"tags": {
"description": "Free-form tags to attach to the document, e.g. [\"contracts\", \"2026\"].",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"filename",
"contentBase64"
],
"type": "object"
},
"name": "library_upload",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"document": {
"additionalProperties": false,
"description": "The created document record, in \"pending\" status until background ingestion completes.",
"properties": {
"createdAt": {
"description": "Upload timestamp, ISO 8601.",
"type": "string"
},
"filename": {
"description": "Sanitized filename as stored.",
"type": "string"
},
"id": {
"description": "Document ID — use with library_delete or to track ingestion.",
"type": "string"
},
"mimeType": {
"description": "Verified MIME type.",
"type": "string"
},
"projectId": {
"description": "Project workspace, when set.",
"type": [
"string",
"null"
]
},
"sizeBytes": {
"description": "Stored file size in bytes.",
"type": "number"
},
"sourceType": {
"description": "Detected source type, e.g. pdf or docx.",
"type": "string"
},
"status": {
"description": "Ingestion status. Starts \"pending\"; becomes \"ready\" when queryable, or \"failed\" with errorMessage.",
"type": "string"
},
"tags": {
"description": "Tags as stored.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"filename",
"status",
"sizeBytes"
],
"type": "object"
}
},
"required": [
"document"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:bab33855593e97934e26d5215706743c0b497e95962ae4958db69570d0acb3ef | sha256sum