{"name":"truvyx-mcp","version":"1.1.0","protocolVersion":"2025-06-18","description":"Truvyx MCP server — grounded investigation, behavioral trace search, and test triggering against the Truvyx multi-agent evaluation platform.","endpoint":"https://mcp.truvyx.org","authentication":{"type":"apiKey","description":"Org-scoped Truvyx API key via `Authorization: Bearer <key>` or `X-Truvyx-Key` header."},"interfaceResponsibilities":{"restApi":"Canonical machine contract and source of domain semantics.","sdk":"Typed ergonomic wrapper over the REST API.","cli":"Repository-local validation, synchronization, evaluation, and CI gates.","mcp":"Grounded investigation plus explicitly confirmed consequential actions.","dashboard":"Human review, configuration, and operational workflows."},"tools":[{"name":"check_escalation_required","description":"Check whether a proposed action requires human escalation under this organization's configured escalation policy before proceeding.","inputSchema":{"type":"object","properties":{"scenarioId":{"type":"string"},"agentName":{"type":"string"},"proposedAction":{"type":"string"},"decisionContext":{"type":"object"}},"required":["scenarioId","agentName","proposedAction","decisionContext"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"runs:read","truvyx/confirmationRequired":false}},{"name":"check_constraint_compliance","description":"Check whether a proposed action or decision would satisfy the hard constraints defined for this scenario, before committing to it.","inputSchema":{"type":"object","properties":{"scenarioId":{"type":"string"},"proposedState":{"type":"object"}},"required":["scenarioId","proposedState"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"runs:read","truvyx/confirmationRequired":false}},{"name":"create_scenario","description":"Create a private, organization-owned Truvyx evaluation scenario with optional constraints and verifier code.","inputSchema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1,"maxLength":100},"difficulty":{"type":"string","enum":["LOW","MEDIUM","HIGH","ADVERSARIAL"]},"projectId":{"type":"string"},"parameters":{"type":"object"},"agentRoles":{"type":"array","items":{"type":"object"}},"problemStatement":{"type":"string"},"machineSpec":{"type":"object"},"tags":{"type":"array","items":{"type":"string"}},"constraints":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"category":{"type":"string","enum":["TEMPORAL","RESOURCE","DEPENDENCY","GEOGRAPHIC","REGULATORY","OPTIMIZATION","SAFETY","DATA_GOVERNANCE","FAIRNESS"]},"type":{"type":"string","enum":["HARD","SOFT"],"default":"HARD"},"naturalLanguage":{"type":"string","minLength":1},"expression":{"type":"object"}},"required":["name","category","naturalLanguage"]}},"verifier":{"type":"object","properties":{"scriptContent":{"type":"string","minLength":1},"dockerfile":{"type":"string"},"requirements":{"type":"string"}},"required":["scriptContent"]},"confirmationToken":{"type":"string","description":"Exact signed token returned by the preview response for these unchanged arguments."}},"required":["name","description","domain","difficulty"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"CONSEQUENTIAL","truvyx/requiredScope":"scenarios:write","truvyx/confirmationRequired":true}},{"name":"lookup_scenario","description":"Search the Truvyx Benchmark Registry for evaluation scenarios matching a domain, keyword, or fault type. Returns TSL-formatted scenario definitions.","inputSchema":{"type":"object","properties":{"query":{"type":"string"},"domain":{"type":"string"},"faultType":{"type":"string"},"maxResults":{"type":"integer","default":5}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"registry:read","truvyx/confirmationRequired":false}},{"name":"fetch_failure_scenarios","description":"Fetch verified failure scenarios from the Truvyx Community Failure Scenario Library for a given domain or fault type.","inputSchema":{"type":"object","properties":{"domain":{"type":"string"},"faultType":{"type":"string"},"originType":{"type":"string","enum":["PRODUCTION_INCIDENT","PRE_DEPLOY_EVAL","SYNTHETIC","RESEARCH"]},"minEndorsements":{"type":"integer","default":0}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"registry:read","truvyx/confirmationRequired":false}},{"name":"check_contract","description":"Validate a producer agent's output against its defined contract with a consumer agent before the consumer processes it.","inputSchema":{"type":"object","properties":{"scenarioId":{"type":"string"},"producerAgentName":{"type":"string"},"consumerAgentName":{"type":"string"},"producerOutput":{"type":"object"}},"required":["scenarioId","producerAgentName","consumerAgentName","producerOutput"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"runs:read","truvyx/confirmationRequired":false}},{"name":"get_fault_taxonomy","description":"Retrieve the current Truvyx RCA fault taxonomy, including all top-level fault types and known sub-types.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"rca:read","truvyx/confirmationRequired":false}},{"name":"submit_trace_event","description":"Submit a single AETP-formatted execution step to Truvyx as it happens, rather than waiting until the full run completes.","inputSchema":{"type":"object","properties":{"traceId":{"type":"string"},"step":{"type":"object"}},"required":["traceId","step"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"truvyx/risk":"LOW_RISK_WRITE","truvyx/requiredScope":"telemetry:write","truvyx/confirmationRequired":false}},{"name":"investigate","description":"Ask a natural-language question about agent behavior, RCA findings, or evaluation history. Returns a grounded answer citing the specific records it relied on.","inputSchema":{"type":"object","properties":{"question":{"type":"string"},"scenarioId":{"type":"string"}},"required":["question"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"rca:read","truvyx/confirmationRequired":false}},{"name":"search_traces","description":"Search execution traces at a behavioral level — by fault type, agent name, constraint violated, or outcome — not just keyword matching on input/output text.","inputSchema":{"type":"object","properties":{"scenarioId":{"type":"string"},"faultType":{"type":"string"},"agentName":{"type":"string"},"outcome":{"type":"string","enum":["PASS","FAIL","ESCALATED"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"runs:read","truvyx/confirmationRequired":false}},{"name":"run_test","description":"Trigger a verifier run or contract test against a scenario directly from the calling environment, without switching to the Truvyx dashboard.","inputSchema":{"type":"object","properties":{"scenarioId":{"type":"string"},"testType":{"type":"string","enum":["verifier","contract"]},"agentOutput":{"type":"object"},"confirmationToken":{"type":"string","description":"Exact signed token returned by the preview response for these unchanged arguments."}},"required":["scenarioId","testType"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"CONSEQUENTIAL","truvyx/requiredScope":"runs:write","truvyx/confirmationRequired":true}},{"name":"list_quality_issues","description":"List evidence-backed quality issues for the authenticated organization, with optional lifecycle, severity, or scenario filters.","inputSchema":{"type":"object","properties":{"status":{"type":"string"},"severity":{"type":"string"},"scenarioId":{"type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"rca:read","truvyx/confirmationRequired":false}},{"name":"get_quality_issue","description":"Retrieve one quality issue with its source occurrences and remediation records. Results are organization-scoped and read-only.","inputSchema":{"type":"object","properties":{"issueId":{"type":"string"}},"required":["issueId"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"truvyx/risk":"READ_ONLY","truvyx/requiredScope":"rca:read","truvyx/confirmationRequired":false}}]}