Plumbline — a trust layer for LLM answers MCP

ask_prepare

BYO: Prepare Grounded Prompt

BYO step 1 of 2: run the server-side trust plane for a business question (plan, SQL-verified facts, evidence retrieval, answerability gate, prompt composition) and return the composed prompt plus a single-use prepare_key (a signed handoff token; echo it back VERBATIM and in full, or use the short ask_id alias; in prose always say the ask_id, never the token). Read-only: prepare holds no server state and is safe to run without confirmation â the receipt is minted only at ask_submit_draft. Pass the user's question VERBATIM: do not expand, narrow, or reword it â the server plans coverage itself, and an unrequested rewrite misleads the user about what was asked. If you must revise it (e.g. to fold in essential conversation context), you MUST also pass the user's exact wording in original_question so the panel can disclose the revision. YOU (the connected model) then write the draft answer from that prompt and submit it with ask_submit_draft â generation happens on your side, so no LLM credential ever reaches this server. An unanswerable question still receives a prompt for reference; its draft is force-refused at submit and can never earn a verified verdict. Only a policy refusal stops at prepare. Recommended drafting path on this deployment.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['question'], 'properties': {'history': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'optional prior conversation turns (role user|assistant) to thread into the composed prompt for follow-up questions'}, 'question': {'type': 'string', 'description': "the business question to ground, in the USER'S OWN WORDS, verbatim; do not expand, narrow, or reword it â\x80\x94 the server plans coverage itself. The server plans, computes SQL facts, retrieves evidence, gates answerability, and composes the prompt YOU should answer from"}, 'original_question': {'type': 'string', 'description': "REQUIRED IF question is not the user's exact wording: the user's original question, verbatim, so the panel can display your revision as a revision. Omit when question is verbatim"}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'properties': {'ask_id': {'type': 'string'}, 'refusal': {'type': ['null', 'object'], 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'messages': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'question': {'type': 'string'}, 'session_id': {'type': 'string'}, 'prepare_key': {'type': 'string'}, 'instructions': {'type': 'string'}, 'max_output_tokens': {'type': 'integer'}, 'original_question': {'type': 'string'}, 'expires_in_seconds': {'type': 'integer'}}, 'additionalProperties': False}

ask_result

BYO: Fetch Published Verdict

Fetch the published verdict for an ask_prepare session (status: pending, published, or unknown). This is the app panel's polling surface, so the verified answer renders inside the panel that prepared the question. As the connected model you normally never need it: write your draft and call ask_submit_draft. Exception: if you are asked to submit for a session whose composed prompt is no longer in your context, call this with include_prompt true to receive that session's exact prompt again, then draft and submit.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['prepare_key'], 'properties': {'prepare_key': {'type': 'string', 'description': 'the session_id value returned by the prepare tool'}, 'include_prompt': {'type': 'boolean', 'description': "set true to receive the pending session's composed prompt messages again, e.g. when the ask_prepare result is no longer in your context; the same caller already received this prompt at prepare time"}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['status'], 'properties': {'result': {'type': ['null', 'object'], 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'permalink_url': {'type': 'string', 'description': 'Public URL of the full evidence receipt for this answer.'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'status': {'type': 'string'}, 'pending': {'type': 'boolean'}, 'messages': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'override': {'type': 'string'}, 'instructions': {'type': 'string'}, 'decline_reason': {'type': 'string'}, 'max_output_tokens': {'type': 'integer'}, 'expires_in_seconds': {'type': 'integer'}}, 'additionalProperties': False}

ask_submit_draft

BYO: Verify Client Draft

BYO step 2 of 2: verify the draft you wrote for an ask_prepare prompt. The server runs the SAME post-answer guards the strict path uses (facts presence, tagged claims, concept binding, earner-name grounding) against its own SQL facts and publishes the trust envelope; a draft that fails any guard is refused. Pass the prepare_key token back VERBATIM and in full. Handoffs are single-use per verdict and expire.

Nur Lesen Idempotent

Eingabeschema

{'type': 'object', 'required': ['prepare_key'], 'properties': {'model': {'type': 'string', 'description': 'optional: the model that wrote the draft, recorded in the trace'}, 'raw_answer': {'type': 'string', 'description': "your COMPLETE raw draft answer to the composed prompt (including any structured answer/claims JSON the prompt's contract asked for). Omit ONLY when you are declining, in which case decline_reason is required"}, 'prepare_key': {'type': 'string', 'description': 'the session_id value returned by the prepare tool'}, 'decline_reason': {'type': 'string', 'description': 'use INSTEAD of raw_answer when you are choosing not to submit a draft: state plainly why, in one or two sentences addressed to the user. The reason is shown to them in the panel, the handoff stays open for them to override, and nothing is verified or published'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'permalink_url': {'type': 'string', 'description': 'Public URL of the full evidence receipt for this answer.'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}

compare_departments

Compare Departments (Verified)

Compare two departments by headcount and compensation. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['a', 'b'], 'properties': {'a': {'type': 'string', 'description': 'the first department'}, 'b': {'type': 'string', 'description': 'the second department'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}

cross_check

Cross-Check a Figure

Corroborate a figure you obtained (e.g. from run_sql) against the verified fact store: it re-derives the named value_key from the same SQL the verified pipeline uses and compares. AGREE lifts an otherwise-unverified session to 'corroborated'; DISAGREE marks a CONFLICT (worse than unverified). This is the only way a raw figure earns trust back, and it can only ever agree with a number the fact store itself computed. Resolvable keys cover the single-snapshot fact concepts plus temporal and per-department growth keys (e.g. indexed_people.<dept>); per-question keys (a named department's median, one person's direct-report count) return unmapped.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['value_key', 'value'], 'properties': {'value': {'type': 'string', 'description': 'the figure you obtained (e.g. from run_sql) to corroborate against the verified fact store'}, 'value_key': {'type': 'string', 'description': 'the claimable fact key naming the verified concept to re-derive, e.g. people, indexed_active_people, median_income_cents, or a per-department growth key like indexed_people.engineering (the keys a verified answer exposes as CLAIMABLE FACT KEYS)'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

describe_fact_capabilities

Discover Fact Capabilities

List safe metadata for the registered fact queries available on the server-pinned dataset: IDs, labels, parameters, and result shapes, never SQL. Use this when a question appears relevant but a selected route produced no facts; a route miss is not evidence that the underlying records are absent.

Nur Lesen

Eingabeschema

{'type': 'object', 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['contract_version', 'snapshot_id', 'queries', 'guidance'], 'properties': {'queries': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'version', 'label', 'result_schema'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'version': {'type': 'string'}, 'parameters': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'type'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'value': True, 'required': {'type': 'boolean'}, 'description': {'type': 'string'}, 'server_owned': {'type': 'boolean'}}, 'additionalProperties': False}}, 'result_schema': {'type': 'string'}}, 'additionalProperties': False}}, 'guidance': {'type': 'string'}, 'snapshot_id': {'type': 'integer'}, 'contract_version': {'type': 'string'}, 'dataset_namespace': {'type': 'string'}}, 'additionalProperties': False}

find_payroll_anomalies

Payroll Anomalies (Verified)

Surface payroll and deduction anomalies in the latest snapshot. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.

Nur Lesen

Eingabeschema

{'type': 'object', 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}

get_ai_act_transparency

EU AI Act Transparency Descriptor

Return the Art. 13 transparency descriptor: intended purpose, capabilities, limitations, human oversight, logging mechanism, and article mapping.

Nur Lesen

Eingabeschema

{'type': 'object', 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['system_name', 'provider_identity', 'intended_purpose', 'capabilities', 'limitations', 'accuracy_posture', 'human_oversight', 'logging_mechanism', 'article_13_mapping', 'retention', 'operator_configured'], 'properties': {'retention': {'type': 'object', 'required': ['minimum_months', 'policy', 'exportable'], 'properties': {'policy': {'type': 'string'}, 'exportable': {'type': 'boolean'}, 'minimum_months': {'type': 'integer'}}, 'additionalProperties': False}, 'limitations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'system_name': {'type': 'string'}, 'capabilities': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'human_oversight': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'accuracy_posture': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'intended_purpose': {'type': 'string'}, 'logging_mechanism': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'provider_identity': {'type': 'string'}, 'article_13_mapping': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['article', 'tag', 'applies_to', 'requirement'], 'properties': {'tag': {'type': 'string'}, 'article': {'type': 'string'}, 'rationale': {'type': 'string'}, 'applies_to': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'requirement': {'type': 'string'}}, 'additionalProperties': False}}, 'operator_configured': {'type': 'boolean'}}, 'additionalProperties': False}

get_answer_queries

Show the SQL Behind an Answer

Show the SQL behind one answer you already received, addressed by its correlation_id. Returns only the recorded fact queries (id, version, label, SQL, parameters, result schema, dataset version) for that answer: no rows, no evidence text, no answer text, no envelope, and no way to list the catalog. Recorded SQL has its arguments inlined as literals, so a query that filters on a specific value discloses that value; the built-in workforce queries inline only snapshot ids. Requires the persisted compliance log and the same session that produced the answer. Absent from the no-auth public demo.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['correlation_id'], 'properties': {'correlation_id': {'type': 'string', 'description': 'the correlation_id published on the answer whose queries you want to see; obtained from that answer, never guessed'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['correlation_id', 'snapshot_id', 'queries'], 'properties': {'queries': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'sql'], 'properties': {'sql': {'type': 'string'}, 'label': {'type': 'string'}, 'version': {'type': 'string'}, 'query_id': {'type': 'string'}, 'parameters': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'type'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'value': True, 'required': {'type': 'boolean'}, 'description': {'type': 'string'}, 'server_owned': {'type': 'boolean'}}, 'additionalProperties': False}}, 'editable_sql': {'type': 'string'}, 'editable_note': {'type': 'string'}, 'result_schema': {'type': 'string'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'correlation_id': {'type': 'string'}}, 'additionalProperties': False}

get_evidence_document

Show an Evidence Document Behind an Answer

Show ONE retrieved evidence document behind an answer you already received, addressed by that answer's correlation_id plus a document_id from its evidence_documents references. Returns the full stored document (title, body, metadata, embedding_text) with the retrieval rank and scores the answer recorded; never the raw embedding vector. Only documents the addressed answer actually recorded resolve: there is no fetch-by-id in general and no way to browse the store. Requires the persisted compliance log and the same session that produced the answer. Absent from the no-auth public demo.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['correlation_id', 'document_id'], 'properties': {'document_id': {'type': 'integer', 'description': "the document_id of one entry in that answer's evidence_documents references"}, 'correlation_id': {'type': 'string', 'description': 'the correlation_id published on the answer whose evidence you want to inspect; obtained from that answer, never guessed'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['correlation_id', 'document'], 'properties': {'note': {'type': 'string'}, 'document': {'type': 'object', 'required': ['document_id', 'snapshot_id', 'source_type', 'title', 'body', 'rank', 'score'], 'properties': {'body': {'type': 'string'}, 'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'additionalProperties': True}, 'overlaps': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}, 'embedding_text': {'type': 'string'}}, 'additionalProperties': False}, 'correlation_id': {'type': 'string'}}, 'additionalProperties': False}

get_manager_chain

Manager & Reporting Chain (Verified)

Return the management/reporting chain for an employee. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['employee'], 'properties': {'employee': {'type': 'string', 'description': 'the employee whose management chain to return'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}

query_fact

Run Registered Fact Query

Execute a registered, versioned read-only fact query against the server-pinned dataset. Provide query_id and version only: SQL is approved by the domain pack, never caller-supplied. Returns normalized rows plus a reproducible trust receipt containing the dataset and query versions.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['query_id', 'version'], 'properties': {'version': {'type': 'string', 'description': 'immutable registered query version'}, 'query_id': {'type': 'string', 'description': 'registered fact-query id; SQL is resolved by the server and must not be supplied here'}, 'parameters': {'type': 'object', 'description': 'optional typed values for parameters declared by the registered query', 'additionalProperties': True}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

run_code

Run Sandboxed JavaScript (Unverified)

Run YOUR OWN JavaScript in the in-tenant coderunner sandbox with the read-only, snapshot-scoped plumb.query() SDK. No filesystem, environment, or general network access. Read plumbline://sandbox-api.d.ts before writing code. The raw-SQL server opt-in is enabled, but results still bypass the trust path and are UNVERIFIED. Returns stdout/stderr plus metadata-only host-call trace evidence.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': "JavaScript source to execute in the in-tenant coderunner sandbox. No filesystem, environment, or general network access. When the server explicitly enables raw SQL and uses the local grant-capable runner, a read-only snapshot-scoped SDK is preloaded as global 'plumb' and plumbline://sandbox-api.d.ts is listed; otherwise the sandbox is airtight and plumb is undefined. console.log output is returned as stdout."}, 'concepts': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'optional: the fact concepts this code computes, as claimable fact keys (e.g. median_income_cents) or free-form names. The server reports per concept whether a registered seed exists (cross_check can corroborate figures) or not (cross_check will return unmapped: the verified store can never corroborate them).'}, 'acknowledge_unverified': {'type': 'boolean', 'description': 'set true to confirm you understand results BYPASS the trust plane and are UNVERIFIED, and that you will label them so to the user. On deployments with the acknowledgment gate the FIRST raw call of a session is refused without it; one acknowledgment covers the rest of the session.'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

run_sql

Run Read-Only SQL (Unverified)

Run YOUR OWN single read-only SELECT/WITH over the virtual snapshot_* relations. The query is statically verified against an allowlist, rewritten to the active snapshot, and run read-only. This BYPASSES the planner, grounding gate, and answer-facts reconciliation, so results are UNVERIFIED and labelled as such. Deployments may refuse the FIRST raw call of a session pending acknowledge_unverified: true (the refusal says how to proceed). Optionally declare `concepts` to learn which figures the fact store could corroborate via cross_check.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['sql'], 'properties': {'sql': {'type': 'string', 'description': 'a single read-only SELECT/WITH over the VIRTUAL snapshot_* relations (e.g. snapshot_employees, snapshot_pay_statements, snapshot_departments). Bare physical table names are rejected. Discover the columns first with introspect_schema.'}, 'concepts': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'optional: the fact concepts this query computes, as claimable fact keys (e.g. median_income_cents) or free-form names. The server reports per concept whether a registered seed exists (cross_check can corroborate figures) or not (cross_check will return unmapped: the verified store can never corroborate them).'}, 'acknowledge_unverified': {'type': 'boolean', 'description': 'set true to confirm you understand results BYPASS the trust plane and are UNVERIFIED, and that you will label them so to the user. On deployments with the acknowledgment gate the FIRST raw call of a session is refused without it; one acknowledgment covers the rest of the session.'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

search_docs

Search Plumbline Docs

Search Plumbline's own product and architecture documentation (how the verification, refusal, and trust layer itself works). Returns ranked, citable doc passages; does NOT touch employment data, and returns an empty result set honestly when nothing matches.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'max passages to return (default 5, capped at 10)'}, 'query': {'type': 'string', 'description': 'a how-does-this-work question about Plumbline itself, e.g. the verification gate, snapshots and temporal drift, or the cross-provider corpus'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['query', 'hits'], 'properties': {'hits': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['source', 'title', 'heading', 'excerpt', 'score'], 'properties': {'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source': {'type': 'string'}, 'excerpt': {'type': 'string'}, 'heading': {'type': 'string'}}, 'additionalProperties': False}}, 'note': {'type': 'string'}, 'query': {'type': 'string'}}, 'additionalProperties': False}

search_employee

Search Employee (Verified)

Search the employment fact store for a person and return a grounded, verified answer. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.

Nur Lesen

Eingabeschema

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'the employee name or search terms'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}

summarize_benefits

Benefits Summary (Verified)

Summarize benefit enrollments, optionally scoped (e.g. a department or plan). NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.

Nur Lesen

Eingabeschema

{'type': 'object', 'properties': {'scope': {'type': 'string', 'description': 'optional scope such as a department or benefit plan'}}, 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}

trust_finalize

Finalize Trust Verdict

Return the session's graded trust verdict: the tier (verified / registered-query / generated-sql / corroborated / unverified / conflict / refused), which trusted steps were skipped across the session, the deterministic confidence (k of n figures store-verified, weakest figure tier, conflicts), the per-figure provenance, the per-call ledger, and the at-your-own-risk disclaimer.

Nur Lesen

Eingabeschema

{'type': 'object', 'additionalProperties': False}

Ausgabeschema

{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

Plumbline — a trust layer for LLM answers

Was dieses MCP kann

Tools

Letzte Tool-Änderungen

Ähnliche MCP-Server

synter-ads

synter-ads

Stratalize Finance

Stratalize Healthcare

Stratalize Governance

Stratalize Oracle

Stratalize Intelligence

Stratalize Real Estate