{ "schema_version": "1.0", "items": [ { "name": "market.bars", "mcp_name": "seer_market_bars", "description": "Completed daily history with explicit adjustment and cutoff.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "market:read" ], "prerequisites": [ "Authorized history for the selected listing." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/MarketBarsInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "MarketBarsInput": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 }, "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "interval": { "type": "string", "enum": [ "1d" ] }, "adjustment": { "type": "string", "enum": [ "split_only", "total_return", "none" ] }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "instrumentId" ], "additionalProperties": false, "description": "Defaults: 252 completed sessions ending at the latest eligible session, interval 1d, adjustment split_only, as_of invocation admission time. start/end, when supplied, are both required and are inclusive session dates; input/output coverage records actual bounds. Maximum 1000 sessions per page. Never returns a partial current-session bar.", "dependentRequired": { "start": [ "end" ], "end": [ "start" ] } } } }, "outputSchema": { "$ref": "#/$defs/MarketBarsData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "MarketBarsData": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "interval": { "type": "string", "enum": [ "1d" ] }, "adjustment": { "type": "string", "enum": [ "split_only", "total_return", "none" ] }, "calendar": { "type": "string", "minLength": 1, "maxLength": 200 }, "observations": { "type": "array", "items": { "type": "object", "properties": { "session": { "type": "string", "format": "date" }, "close": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" } }, "required": [ "session", "close" ], "additionalProperties": false } } }, "required": [ "instrumentId", "currency", "interval", "adjustment", "calendar", "observations" ], "additionalProperties": false } } } }, { "name": "technical.compute", "mcp_name": "seer_technical_compute", "description": "Fixed-period deterministic daily indicators.", "schema_revision": "1.0", "effect": "compute", "required_scopes": [ "compute:read" ], "prerequisites": [ "market.bars access; at least 50 completed prices for SMA50." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/TechnicalInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "TechnicalInput": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "instrumentId" ], "additionalProperties": false, "description": "Fixed daily technical.v1: SMA20/50, Wilder RSI14, return20, volatility20 and drawdown20. Uses split-adjusted completed bars at admission cutoff; insufficient history produces 422, not a zero value." } } }, "outputSchema": { "$ref": "#/$defs/TechnicalData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "MetricValue": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "name", "value", "unit", "missing_reason" ], "additionalProperties": false }, "TechnicalData": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "method_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "input_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "metrics": { "type": "array", "items": { "$ref": "#/$defs/MetricValue" } } }, "required": [ "instrument_id", "method_revision", "input_snapshot_id", "metrics" ], "additionalProperties": false } } } }, { "name": "social.search", "mcp_name": "seer_social_search", "description": "Source-attributed public conversation.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "social:read" ], "prerequisites": [ "Licensed source coverage for query and interval." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/SocialInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "SocialInput": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 1000 }, "type": { "type": "string", "enum": [ "Latest", "Top" ] }, "count": { "type": "integer", "minimum": 1, "maximum": 100 }, "since": { "type": "string", "format": "date-time" }, "until": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "query", "type", "count" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/SocialData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "SocialData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "source_item_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "author_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "published_at": { "type": "string", "format": "date-time" }, "available_at": { "type": "string", "format": "date-time" }, "url": { "type": "string", "format": "uri" }, "text": { "type": "string" }, "duplicate_of": { "type": [ "string", "null" ] }, "evidence_ref": { "$ref": "#/$defs/EvidenceRef" } }, "required": [ "source_item_id", "author_id", "published_at", "available_at", "url", "text", "duplicate_of", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false } } } }, { "name": "news.search", "mcp_name": "seer_news_search", "description": "Articles and original reports with text coverage.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "news:read" ], "prerequisites": [ "Licensed news source and requested historical window." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/SearchInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "SearchInput": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1 }, "start_at": { "type": "string", "format": "date-time" }, "end_at": { "type": "string", "format": "date-time" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string" } }, "required": [ "query", "start_at", "end_at" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/NewsData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "NewsData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "document_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "coverage": { "type": "string", "enum": [ "metadata_only", "excerpt", "full_text" ] }, "text": { "type": "string" }, "entity_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "evidence_ref": { "$ref": "#/$defs/EvidenceRef" } }, "required": [ "document_id", "title", "url", "published_at", "coverage", "text", "entity_refs", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false } } } }, { "name": "company.filings", "mcp_name": "seer_company_filings", "description": "Filing identifiers and acceptance-time metadata.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "company:read" ], "prerequisites": [ "Resolved issuer and source entitlement." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/FilingsInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "FilingsInput": { "type": "object", "properties": { "issuer_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "forms": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "issuer_ref", "as_of" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/FilingsData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "FilingsData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "issuer_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "form": { "type": "string", "minLength": 1, "maxLength": 200 }, "accepted_at": { "type": "string", "format": "date-time" }, "period_end": { "type": "string", "format": "date" }, "amends": { "type": [ "string", "null" ] }, "evidence_ref": { "$ref": "#/$defs/EvidenceRef" } }, "required": [ "filing_id", "issuer_ref", "form", "accepted_at", "period_end", "amends", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false } } } }, { "name": "company.filing_read", "mcp_name": "seer_company_filing_read", "description": "Read a discovered filing by identifier.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "company:read" ], "prerequisites": [ "Owned, accessible filing identifier." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/FilingReadInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "FilingReadInput": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "filing_id" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/FilingReadData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "FilingReadData": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "text": { "type": "string" }, "truncated": { "type": "boolean" }, "evidence_ref": { "$ref": "#/$defs/EvidenceRef" } }, "required": [ "filing_id", "text", "truncated", "evidence_ref" ], "additionalProperties": false } } } }, { "name": "company.facts", "mcp_name": "seer_company_facts", "description": "Taxonomy facts with fiscal context.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "company:read" ], "prerequisites": [ "Compatible taxonomy concepts and vintage coverage." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/FactsInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "FactsInput": { "type": "object", "properties": { "issuer_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "concepts": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1 }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "issuer_ref", "concepts", "as_of" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/FactsData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "FactsData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "concept": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "period_start": { "type": [ "string", "null" ], "format": "date" }, "period_end": { "type": "string", "format": "date" }, "accepted_at": { "type": "string", "format": "date-time" }, "evidence_ref": { "$ref": "#/$defs/EvidenceRef" } }, "required": [ "filing_id", "concept", "value", "unit", "period_start", "period_end", "accepted_at", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false } } } }, { "name": "macro.observations", "mcp_name": "seer_macro_observations", "description": "Economic observations at a selected vintage.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "macro:read" ], "prerequisites": [ "Vintage history; no substitution with current revised data." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/MacroInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "MacroInput": { "type": "object", "properties": { "series_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "vintage_at": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "series_id", "start", "end", "vintage_at" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/MacroData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "MacroData": { "type": "object", "properties": { "series_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "frequency": { "type": "string", "minLength": 1, "maxLength": 200 }, "seasonal_adjustment": { "type": "string", "minLength": 1, "maxLength": 200 }, "observations": { "type": "array", "items": { "type": "object", "properties": { "period": { "type": "string" }, "value": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "available_at": { "type": "string", "format": "date-time" }, "evidence_ref": { "$ref": "#/$defs/EvidenceRef" } }, "required": [ "period", "value", "published_at", "available_at", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "series_id", "unit", "frequency", "seasonal_adjustment", "observations" ], "additionalProperties": false } } } }, { "name": "features.compute", "mcp_name": "seer_features_compute", "description": "Registered point-in-time numerical features.", "schema_revision": "1.0", "effect": "compute", "required_scopes": [ "research:compute" ], "prerequisites": [ "Snapshot and accessible feature/fit revisions." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/FeatureInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "FeatureInput": { "type": "object", "properties": { "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "feature_revisions": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1 }, "fit_snapshot_id": { "type": [ "string", "null" ] } }, "required": [ "evidence_snapshot_id", "feature_revisions", "fit_snapshot_id" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/FeatureData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "FeatureData": { "type": "object", "properties": { "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "feature_revisions": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "fit_snapshot_id": { "type": [ "string", "null" ] }, "rows": { "type": "array", "items": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "decision_at": { "type": "string", "format": "date-time" }, "values": { "type": "array", "items": { "$ref": "#/$defs/MetricValue" } } }, "required": [ "instrument_id", "decision_at", "values" ], "additionalProperties": false } } }, "required": [ "evidence_snapshot_id", "feature_revisions", "fit_snapshot_id", "rows" ], "additionalProperties": false }, "MetricValue": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "name", "value", "unit", "missing_reason" ], "additionalProperties": false } } } }, { "name": "research.evaluate", "mcp_name": "seer_research_evaluate", "description": "Reproducible strategy evaluation.", "schema_revision": "1.0", "effect": "compute", "required_scopes": [ "research:evaluate" ], "prerequisites": [ "Frozen registry revisions, eligible data and simulation budget." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/ResearchInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Amount": { "type": "object", "properties": { "asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "scale": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "asset", "atoms", "scale" ], "additionalProperties": false }, "ResearchInput": { "type": "object", "properties": { "strategy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "mode": { "type": "string", "enum": [ "historical_simulation", "prospective_shadow", "paper" ] }, "start_at": { "type": "string", "format": "date-time" }, "end_at": { "type": "string", "format": "date-time" }, "baseline_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "execution_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "split_policy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "initial_cash": { "$ref": "#/$defs/Amount" }, "experiment_family_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "strategy_revision", "evidence_snapshot_id", "mode", "start_at", "end_at", "baseline_revision", "execution_model_revision", "split_policy_revision", "initial_cash", "experiment_family_id" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/ResearchData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Amount": { "type": "object", "properties": { "asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "scale": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "asset", "atoms", "scale" ], "additionalProperties": false }, "MetricValue": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "name", "value", "unit", "missing_reason" ], "additionalProperties": false }, "ResearchData": { "type": "object", "properties": { "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "manifest": { "$ref": "#/$defs/ResearchInput" }, "status": { "type": "string", "enum": [ "complete", "incomplete" ] }, "metrics": { "type": "array", "items": { "$ref": "#/$defs/MetricValue" } }, "record_refs": { "type": "object", "properties": { "predictions": { "type": "string", "minLength": 1, "maxLength": 200 }, "orders": { "type": "string", "minLength": 1, "maxLength": 200 }, "fills": { "type": "string", "minLength": 1, "maxLength": 200 }, "nav": { "type": "string", "minLength": 1, "maxLength": 200 }, "trials": { "type": "string", "minLength": 1, "maxLength": 200 }, "exclusions": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "predictions", "orders", "fills", "nav", "trials", "exclusions" ], "additionalProperties": false }, "limitations": { "type": "array", "items": { "type": "string" } } }, "required": [ "evaluation_id", "manifest", "status", "metrics", "record_refs", "limitations" ], "additionalProperties": false }, "ResearchInput": { "type": "object", "properties": { "strategy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "mode": { "type": "string", "enum": [ "historical_simulation", "prospective_shadow", "paper" ] }, "start_at": { "type": "string", "format": "date-time" }, "end_at": { "type": "string", "format": "date-time" }, "baseline_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "execution_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "split_policy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "initial_cash": { "$ref": "#/$defs/Amount" }, "experiment_family_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "strategy_revision", "evidence_snapshot_id", "mode", "start_at", "end_at", "baseline_revision", "execution_model_revision", "split_policy_revision", "initial_cash", "experiment_family_id" ], "additionalProperties": false } } } }, { "name": "risk.stress", "mcp_name": "seer_risk_stress", "description": "Factor exposure and scenario losses.", "schema_revision": "1.0", "effect": "compute", "required_scopes": [ "risk:read" ], "prerequisites": [ "Account snapshot, covered risk model and scenario registry." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/StressInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "StressInput": { "type": "object", "properties": { "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "scenario_set_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "confidence": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 } }, "required": [ "account_snapshot_id", "risk_model_revision", "scenario_set_revision", "confidence" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/StressData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "MetricValue": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "name", "value", "unit", "missing_reason" ], "additionalProperties": false }, "StressData": { "type": "object", "properties": { "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "scenario_set_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "reporting_currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "confidence": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 }, "expected_shortfall": { "type": [ "string", "null" ] }, "missing_reason": { "type": [ "string", "null" ] }, "scenario_losses": { "type": "array", "items": { "type": "object", "properties": { "scenario_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "loss": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "probability": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "scenario_id", "loss", "probability" ], "additionalProperties": false } }, "factor_exposures": { "type": "array", "items": { "$ref": "#/$defs/MetricValue" } }, "limitations": { "type": "array", "items": { "type": "string" } }, "volatility_contributions": { "type": "array", "items": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "contribution": { "type": [ "number", "null" ] }, "unit": { "type": "string", "enum": [ "fraction_per_horizon" ] }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "instrument_id", "contribution", "unit", "missing_reason" ], "additionalProperties": false } } }, "required": [ "account_snapshot_id", "risk_model_revision", "scenario_set_revision", "reporting_currency", "confidence", "expected_shortfall", "missing_reason", "scenario_losses", "factor_exposures", "limitations", "volatility_contributions" ], "additionalProperties": false } } } }, { "name": "liquidity.quote_curve", "mcp_name": "seer_liquidity_quote_curve", "description": "Size-specific prices and executable depth.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "market:quote" ], "prerequisites": [ "Supported venue route, current observation and matched units." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/QuoteCurveInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Amount": { "type": "object", "properties": { "asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "scale": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "asset", "atoms", "scale" ], "additionalProperties": false }, "QuoteCurveInput": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "venue": { "type": "string", "minLength": 1, "maxLength": 200 }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "quantities": { "type": "array", "items": { "$ref": "#/$defs/Amount" }, "minItems": 1, "maxItems": 20 }, "max_age_seconds": { "type": "integer", "minimum": 1 } }, "required": [ "instrument_id", "venue", "side", "quantities", "max_age_seconds" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/QuoteCurveData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Amount": { "type": "object", "properties": { "asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "scale": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "asset", "atoms", "scale" ], "additionalProperties": false }, "QuoteCurveData": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "venue": { "type": "string", "minLength": 1, "maxLength": 200 }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "observed_at": { "type": "string", "format": "date-time" }, "sequence_ref": { "type": [ "string", "null" ] }, "points": { "type": "array", "items": { "$ref": "#/$defs/QuotePoint" } } }, "required": [ "instrument_id", "venue", "side", "observed_at", "sequence_ref", "points" ], "additionalProperties": false }, "QuotePoint": { "type": "object", "properties": { "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "requested_quantity": { "$ref": "#/$defs/Amount" }, "fillable_quantity": { "$ref": "#/$defs/Amount" }, "average_price": { "type": [ "string", "null" ] }, "quote_asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "executable", "indicative", "unavailable" ] }, "fees_included": { "type": "array", "items": { "type": "string" } }, "expires_at": { "type": [ "string", "null" ], "format": "date-time" }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "quote_ref", "requested_quantity", "fillable_quantity", "average_price", "quote_asset", "status", "fees_included", "expires_at", "missing_reason" ], "additionalProperties": false } } } }, { "name": "execution.cost_estimate", "mcp_name": "seer_execution_cost_estimate", "description": "Cost components and quote inclusion semantics.", "schema_revision": "1.0", "effect": "compute", "required_scopes": [ "execution:analyze" ], "prerequisites": [ "Unexpired quote and compatible cost-model revision." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/CostInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "CostInput": { "type": "object", "properties": { "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cost_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "urgency_seconds": { "type": "integer", "minimum": 1 } }, "required": [ "quote_ref", "cost_model_revision", "urgency_seconds" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/CostData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "CostData": { "type": "object", "properties": { "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cost_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "components": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "fee", "spread", "impact", "delay", "financing", "network" ] }, "estimate": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "included_in_quote": { "type": "boolean" } }, "required": [ "kind", "estimate", "included_in_quote" ], "additionalProperties": false } }, "total_incremental_cost": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "uncertainty_note": { "type": "string" } }, "required": [ "quote_ref", "cost_model_revision", "currency", "components", "total_incremental_cost", "uncertainty_note" ], "additionalProperties": false } } } }, { "name": "execution.quality", "mcp_name": "seer_execution_quality", "description": "Observed implementation shortfall.", "schema_revision": "1.0", "effect": "compute", "required_scopes": [ "execution:analyze" ], "prerequisites": [ "Accessible action, matched benchmark and observed fills." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/ExecutionQualityInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "ExecutionQualityInput": { "type": "object", "properties": { "action_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "benchmark_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "window_end": { "type": "string", "format": "date-time" } }, "required": [ "action_id", "benchmark_revision", "window_end" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/ExecutionQualityData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Amount": { "type": "object", "properties": { "asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "scale": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "asset", "atoms", "scale" ], "additionalProperties": false }, "Coverage": { "type": "object", "properties": { "requested_start": { "type": [ "string", "null" ], "format": "date-time" }, "requested_end": { "type": [ "string", "null" ], "format": "date-time" }, "as_of": { "type": "string", "format": "date-time" }, "source_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "missing_reasons": { "type": "array", "items": { "type": "string" } }, "revision_history": { "type": "string", "enum": [ "complete", "incomplete", "not_applicable" ] } }, "required": [ "requested_start", "requested_end", "as_of", "source_refs", "missing_reasons", "revision_history" ], "additionalProperties": false }, "ExecutionQualityData": { "type": "object", "properties": { "action_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "benchmark_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "mode": { "type": "string", "enum": [ "paper", "live" ] }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "filled_cost": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "unfilled_opportunity_cost": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "explicit_fees": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "total_shortfall": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "intended_quantity": { "$ref": "#/$defs/Amount" }, "filled_quantity": { "$ref": "#/$defs/Amount" }, "coverage": { "$ref": "#/$defs/Coverage" } }, "required": [ "action_id", "benchmark_revision", "mode", "currency", "filled_cost", "unfilled_opportunity_cost", "explicit_fees", "total_shortfall", "intended_quantity", "filled_quantity", "coverage" ], "additionalProperties": false } } } }, { "name": "chain.inspect", "mcp_name": "seer_chain_inspect", "description": "Block-pinned token identity and supply.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "chain:read" ], "prerequisites": [ "Supported chain and token contract." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/ChainInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "ChainInput": { "type": "object", "properties": { "chain_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "contract": { "type": "string", "minLength": 1, "maxLength": 200 }, "block_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cursor": { "type": "string" } }, "required": [ "chain_id", "contract", "block_ref" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/ChainData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "ChainData": { "type": "object", "properties": { "chain_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "contract": { "type": "string", "minLength": 1, "maxLength": 200 }, "block_hash": { "type": "string", "minLength": 1, "maxLength": 200 }, "block_number": { "type": "string", "pattern": "^[0-9]+$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "canonicality": { "type": "string", "enum": [ "included", "finalized", "orphaned" ] }, "observed_at": { "type": "string", "format": "date-time" }, "total_supply_atoms": { "type": "string", "pattern": "^[0-9]+$" } }, "required": [ "chain_id", "contract", "block_hash", "block_number", "decimals", "canonicality", "observed_at", "total_supply_atoms" ], "additionalProperties": false } } } }, { "name": "prediction.market", "mcp_name": "seer_prediction_market", "description": "Outcome identity and resolution terms.", "schema_revision": "1.0", "effect": "read", "required_scopes": [ "prediction:read" ], "prerequisites": [ "Source rights and supported market." ], "error_codes": [ "INVALID_INPUT", "FORBIDDEN", "UNSUPPORTED_CAPABILITY", "INSUFFICIENT_EVIDENCE", "DEPENDENCY_UNAVAILABLE" ], "inputSchema": { "$ref": "#/$defs/PredictionInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "PredictionInput": { "type": "object", "properties": { "market_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "market_id" ], "additionalProperties": false } } }, "outputSchema": { "$ref": "#/$defs/PredictionData", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "PredictionData": { "type": "object", "properties": { "market_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "resolution_rules_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "resolution_state": { "type": "string", "enum": [ "unresolved", "disputed", "finalized", "void" ] }, "closes_at": { "type": "string", "format": "date-time" }, "outcomes": { "type": "array", "items": { "type": "object", "properties": { "outcome_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "label": { "type": "string" } }, "required": [ "outcome_id", "instrument_id", "label" ], "additionalProperties": false } }, "evidence_refs": { "type": "array", "items": { "$ref": "#/$defs/EvidenceRef" } } }, "required": [ "market_id", "resolution_rules_ref", "resolution_state", "closes_at", "outcomes", "evidence_refs" ], "additionalProperties": false } } } } ], "next_cursor": null, "mcp_utilities": [ { "name": "seer_jobs_get", "description": "Read an admitted job.", "required_scopes": [ "jobs:read" ], "inputSchema": { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "job_id" ], "additionalProperties": false, "$schema": "https://json-schema.org/draft/2020-12/schema" }, "outputSchema": { "$ref": "#/$defs/Job", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Job": { "oneOf": [ { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "accepted", "running", "waiting" ] } }, "required": [ "job_id", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "completed" ] }, "result_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "job_id", "state", "result_ref" ], "additionalProperties": false }, { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "failed" ] }, "error_code": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "job_id", "state", "error_code" ], "additionalProperties": false }, { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "cancelled" ] } }, "required": [ "job_id", "state" ], "additionalProperties": false } ], "examples": [ { "job_id": "job_example_1", "state": "completed", "result_ref": "artifact_forecast_example_1" } ] } } } }, { "name": "seer_artifacts_get", "description": "Read a completed artifact.", "required_scopes": [ "artifacts:read" ], "inputSchema": { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "artifact_id" ], "additionalProperties": false, "$schema": "https://json-schema.org/draft/2020-12/schema" }, "outputSchema": { "$ref": "#/$defs/Artifact", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Artifact": { "oneOf": [ { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "forecast" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "data": { "$ref": "#/$defs/Forecast" } }, "required": [ "artifact_id", "kind", "schema_revision", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "portfolio_proposal" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "data": { "$ref": "#/$defs/PortfolioProposal" } }, "required": [ "artifact_id", "kind", "schema_revision", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "tool_result" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "data": { "$ref": "#/$defs/ToolResult" } }, "required": [ "artifact_id", "kind", "schema_revision", "data" ], "additionalProperties": false } ], "discriminator": { "propertyName": "kind" }, "examples": [ { "artifact_id": "artifact_forecast_example_1", "kind": "forecast", "schema_revision": "1.0", "data": { "forecast_id": "fc_example_1", "instrument_id": "equity:listing:apple-common-xnas", "origin_at": "2026-10-01T20:05:00Z", "target": "simple_price_return", "horizon": { "value": 5, "unit": "trading_sessions" }, "unit": "fraction", "model_revision": "aura-example-r1", "evidence_snapshot_id": "snap_example_1", "estimate": { "mean": 0.0218, "quantiles": { "0.05": -0.035438, "0.50": 0.015574, "0.95": 0.101898 } }, "evaluation_state": "pending_outcome" } } ] }, "ConstraintDiagnostic": { "type": "object", "properties": { "constraint": { "type": "string", "minLength": 1, "maxLength": 200 }, "residual": { "type": "number" }, "tolerance": { "type": "number", "minimum": 0 }, "binding": { "type": "boolean" } }, "required": [ "constraint", "residual", "tolerance", "binding" ], "additionalProperties": false }, "Coverage": { "type": "object", "properties": { "requested_start": { "type": [ "string", "null" ], "format": "date-time" }, "requested_end": { "type": [ "string", "null" ], "format": "date-time" }, "as_of": { "type": "string", "format": "date-time" }, "source_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "missing_reasons": { "type": "array", "items": { "type": "string" } }, "revision_history": { "type": "string", "enum": [ "complete", "incomplete", "not_applicable" ] } }, "required": [ "requested_start", "requested_end", "as_of", "source_refs", "missing_reasons", "revision_history" ], "additionalProperties": false }, "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "Forecast": { "type": "object", "properties": { "forecast_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "origin_at": { "type": "string", "format": "date-time" }, "target": { "type": "string", "enum": [ "simple_price_return" ] }, "horizon": { "$ref": "#/$defs/Horizon" }, "unit": { "type": "string", "enum": [ "fraction" ] }, "model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "estimate": { "type": "object", "properties": { "mean": { "type": "number" }, "quantiles": { "type": "object", "properties": { "0.05": { "type": "number" }, "0.50": { "type": "number" }, "0.95": { "type": "number" } }, "required": [ "0.05", "0.50", "0.95" ], "additionalProperties": false } }, "required": [ "mean", "quantiles" ], "additionalProperties": false }, "evaluation_state": { "type": "string", "enum": [ "pending_outcome", "evaluated", "missing_outcome" ] } }, "required": [ "forecast_id", "instrument_id", "origin_at", "target", "horizon", "unit", "model_revision", "evidence_snapshot_id", "estimate", "evaluation_state" ], "additionalProperties": false, "description": "Forecast contract. Quantile monotonicity is a semantic validation beyond this schema.", "examples": [ { "forecast_id": "fc_example_1", "instrument_id": "equity:listing:apple-common-xnas", "origin_at": "2026-10-01T20:05:00Z", "target": "simple_price_return", "horizon": { "value": 5, "unit": "trading_sessions" }, "unit": "fraction", "model_revision": "aura-example-r1", "evidence_snapshot_id": "snap_example_1", "estimate": { "mean": 0.0218, "quantiles": { "0.05": -0.035438, "0.50": 0.015574, "0.95": 0.101898 } }, "evaluation_state": "pending_outcome" } ] }, "Horizon": { "type": "object", "properties": { "value": { "type": "integer", "minimum": 1 }, "unit": { "type": "string", "enum": [ "trading_sessions" ] } }, "required": [ "value", "unit" ], "additionalProperties": false, "description": "Calendar and endpoint conventions must be resolved by the supported model contract." }, "PortfolioProposal": { "oneOf": [ { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "solver_status": { "type": "string", "enum": [ "optimal" ] }, "weights": { "type": "array", "items": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "weight": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "instrument_id", "weight" ], "additionalProperties": false } }, "cash_weight": { "type": "number", "minimum": 0, "maximum": 1 }, "objective_value": { "type": "number" }, "primal_residual": { "type": "number", "minimum": 0 }, "constraint_diagnostics": { "type": "array", "items": { "$ref": "#/$defs/ConstraintDiagnostic" } } }, "required": [ "proposal_id", "proposal_revision", "account_snapshot_id", "risk_model_revision", "solver_status", "weights", "cash_weight", "objective_value", "primal_residual", "constraint_diagnostics" ], "additionalProperties": false }, { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "solver_status": { "type": "string", "enum": [ "infeasible", "numerical_failure" ] }, "error_code": { "type": "string", "minLength": 1, "maxLength": 200 }, "constraint_diagnostics": { "type": "array", "items": { "$ref": "#/$defs/ConstraintDiagnostic" } } }, "required": [ "proposal_id", "proposal_revision", "account_snapshot_id", "risk_model_revision", "solver_status", "error_code", "constraint_diagnostics" ], "additionalProperties": false } ], "description": "A calculation result. Failed solutions have diagnostics without fabricated target weights. Executable proposals have a separate resource.", "examples": [ { "proposal_id": "allocation_example_2", "proposal_revision": 1, "account_snapshot_id": "acctsnap_example_1", "risk_model_revision": "risk-example-r1", "solver_status": "infeasible", "error_code": "CONSTRAINTS_INFEASIBLE", "constraint_diagnostics": [ { "constraint": "minimum_cash", "residual": 0.05, "tolerance": 1e-08, "binding": false } ] } ] }, "ToolResult": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "invocation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "tool": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "complete", "partial" ] }, "data": {}, "evidence": { "type": "array", "items": { "$ref": "#/$defs/EvidenceRef" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "next_cursor": { "type": [ "string", "null" ] }, "coverage": { "$ref": "#/$defs/Coverage" } }, "required": [ "schema_version", "invocation_id", "tool", "status", "data", "evidence", "warnings", "next_cursor", "coverage" ], "additionalProperties": false, "examples": [ { "schema_version": "1.0", "invocation_id": "inv_example_1", "tool": "market.bars", "status": "complete", "data": { "instrumentId": "equity:listing:apple-common-xnas", "currency": "USD", "interval": "1d", "observations": [ { "session": "2026-10-01", "close": "100.00" }, { "session": "2026-10-02", "close": "102.00" } ], "adjustment": "split_only", "calendar": "XNAS" }, "evidence": [ { "id": "ev_prices_example", "revision": "1", "source_ref": "source_market_example" } ], "warnings": [], "next_cursor": null, "coverage": { "requested_start": "2026-10-01T00:00:00Z", "requested_end": "2026-10-02T23:59:59Z", "as_of": "2026-10-03T00:00:00Z", "source_refs": [ "source_market_example" ], "missing_reasons": [], "revision_history": "complete" } } ] } } } } ] }