{"schema_version":"1.1.0","calculation_version":"v7.1-integrity","mcp":{"path":"/mcp","protocol":"2026-07-28","transport":"stateless HTTP, JSON responses","public_reads":true,"domain_writes":[],"resources":["bankscope://v1/metrics","bankscope://v1/methodology","bankscope://v1/status"],"url":"https://bankscope-fdic.jpiscool.chatgpt.site/mcp","server_version":"1.2.0","access":"Sites authentication and Site viewer permission","legacy_initialize":false,"verification":{"hosted_authenticated_tool_call":"not_verified"}},"public_mcp":{"path":"/api/public-mcp","url":"https://bankscope.org/api/public-mcp","server_version":"1.2.0","access":"anonymous","public_reads":true,"domain_writes":[],"operations":["search_institutions","get_institution","analyze_institutions","get_trends","get_peers","get_metric_definitions","get_methodology","get_data_status","build_analysis_link","export_analysis"],"resources":["bankscope://v1/metrics","bankscope://v1/methodology","bankscope://v1/status"],"protocols":[{"version":"2025-11-25","initialization":"initialize","transport":"stateless Streamable HTTP; responses may use SSE"},{"version":"2026-07-28","initialization":"per-request metadata","transport":"stateless HTTP, JSON responses"}],"identity":"Authorization, Cookie and oai-* headers do not grant privileges","origin":"Absent Origin accepted; present Origin must match the request origin; no broad CORS","batches":false,"max_request_body_bytes":65536,"verification":{"local":"Python MCP SDK 1.26.0, protocol 2025-11-25, compiled Worker loopback","hosted_test":"Python MCP SDK 1.26.0, protocol 2025-11-25, ten tools and three resources","independent_modern_client":"not_tested"}},"limits":{"query":120,"page":100,"summaryBytes":24576,"pageBytes":65536,"exportBytes":5242880,"exportRows":5000,"upstreamConcurrency":3,"upstreamTimeoutMs":15000,"requestTimeoutMs":45000,"activeRequests":6,"requestsPerMinute":60,"globalRequestsPerMinute":240},"errors":{"VALIDATION_ERROR":400,"NOT_FOUND":404,"NO_COMMON_PERIOD":422,"SOURCE_UNAVAILABLE":502,"RATE_LIMITED":429,"INCOMPLETE_SOURCE":503,"SNAPSHOT_EXPIRED":410,"RESULT_TOO_LARGE":413,"UNAUTHENTICATED":401,"FORBIDDEN":403},"operations":{"search_institutions":{"http":{"method":"GET","path":"/api/v1/institutions"},"input":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":120},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"cursor":{"type":"string","minLength":1,"maxLength":2048}},"required":["query"],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"institutions":{"type":"array","items":{"type":"object","properties":{"cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$"},"name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"assets":{"type":["number","null"]}},"required":["cert","name","assets"],"additionalProperties":true}}},"required":["institutions"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"search_institutions"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"get_institution":{"http":{"method":"GET","path":"/api/v1/institutions/{cert}"},"input":{"type":"object","properties":{"cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8}},"required":["cert"],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"institution":{"type":"object","properties":{"cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$"},"name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"assets":{"type":["number","null"]}},"required":["cert","name","assets"],"additionalProperties":true}},"required":["institution"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"get_institution"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"analyze_institutions":{"http":{"method":"GET","path":"/api/v1/analysis"},"input":{"type":"object","properties":{"primary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"secondary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"asserted_period":{"type":"string","pattern":"^\\d{4}-(03-31|06-30|09-30|12-31)$"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"cursor":{"type":"string","minLength":1,"maxLength":2048},"metric_ids":{"type":"array","items":{"type":"string","enum":["ASSET","ASSET_GROWTH","LOAN_GROWTH","DEPOSIT_GROWTH","ROA","ROE","NIMY","EEFFR","NCLNLSR","NTLNLSR","LNLSDEPR","UNINSURED_DEPOSIT_SHARE","COREDEPR","EQTOTR","RBC1AAJ","RBCT1CER"]},"minItems":1,"maxItems":16,"uniqueItems":true},"detail":{"type":"string","enum":["summary","full"],"default":"summary"}},"required":["primary_cert"],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"primary":{"type":"object","properties":{"cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$"},"name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"assets":{"type":["number","null"]}},"required":["cert","name","assets"],"additionalProperties":true},"secondary":{"anyOf":[{"type":"object","properties":{"cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$"},"name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"assets":{"type":["number","null"]}},"required":["cert","name","assets"],"additionalProperties":true},{"type":"null"}]},"reportDate":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"unit":{"type":"string"},"targetValue":{"type":["number","null"]}},"required":["key","label","unit","targetValue"],"additionalProperties":true}},"peers":{"type":"object","properties":{"count":{"type":"integer","minimum":0}},"required":["count"],"additionalProperties":true},"industry":{"type":"object","properties":{"count":{"type":"integer","minimum":0}},"required":["count"],"additionalProperties":true},"notices":{"type":"array","items":{"type":"string"}},"methodology":{"type":"object"}},"required":["primary","secondary","reportDate","metrics","peers","industry","notices","methodology"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"analyze_institutions"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"get_trends":{"http":{"method":"GET","path":"/api/v1/trends"},"input":{"type":"object","properties":{"primary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"secondary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"asserted_period":{"type":"string","pattern":"^\\d{4}-(03-31|06-30|09-30|12-31)$"},"metric_ids":{"type":"array","items":{"type":"string","enum":["ASSET","ROA","NIMY","EEFFR","NCLNLSR","RBC1AAJ","NUMEMP"]},"minItems":1,"maxItems":7,"uniqueItems":true,"default":["ROA"]},"range":{"type":"string","enum":["3y","5y","10y","20y","since_1990"],"default":"since_1990"},"overlay":{"type":"string","enum":["none","moving","linear","both"],"default":"linear"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"cursor":{"type":"string","minLength":1,"maxLength":2048}},"required":["primary_cert"],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"statistics_version":{"const":"1.1.0-observed-change"},"selection":{"type":"object","properties":{"metric_ids":{"type":"array","items":{"type":"string"}},"range":{"type":"string"},"overlay":{"type":"string"},"reporting_quarters":{"type":"integer","minimum":0}},"required":["metric_ids","range","overlay","reporting_quarters"],"additionalProperties":true},"chart_series":{"type":"array","items":{"type":"object"}},"summaries":{"type":"array","items":{"type":"object","properties":{"metric_id":{"type":"string"},"primary":{"type":"object","properties":{"observed_change":{"type":"object","properties":{"basis":{"enum":["selected_window_endpoints","same_quarter_prior_year"]},"start_period":{"type":["string","null"]},"end_period":{"type":["string","null"]},"start_value":{"type":["number","null"]},"end_value":{"type":["number","null"]},"value":{"type":["number","null"]},"unit":{"enum":["percent","percentage_points"]},"absolute_change":{"type":["number","null"]},"absolute_unit":{"enum":["USD_thousands","percent","full_time_equivalent_employees","percentage_points"]},"quarter_intervals":{"type":["integer","null"]},"missing_reason":{"type":["string","null"]}},"required":["basis","start_period","end_period","start_value","end_value","value","unit","absolute_change","absolute_unit","quarter_intervals","missing_reason"],"additionalProperties":true},"year_over_year":{"type":"object","properties":{"basis":{"enum":["selected_window_endpoints","same_quarter_prior_year"]},"start_period":{"type":["string","null"]},"end_period":{"type":["string","null"]},"start_value":{"type":["number","null"]},"end_value":{"type":["number","null"]},"value":{"type":["number","null"]},"unit":{"enum":["percent","percentage_points"]},"absolute_change":{"type":["number","null"]},"absolute_unit":{"enum":["USD_thousands","percent","full_time_equivalent_employees","percentage_points"]},"quarter_intervals":{"type":["integer","null"]},"missing_reason":{"type":["string","null"]}},"required":["basis","start_period","end_period","start_value","end_value","value","unit","absolute_change","absolute_unit","quarter_intervals","missing_reason"],"additionalProperties":true},"regression":{"anyOf":[{"type":"object","properties":{"annualizedChange":{"type":"number"},"observations":{"type":"integer","minimum":0},"rSquared":{"type":"number"},"usesLogScale":{"type":"boolean"},"metadata":{"type":"object","properties":{"model":{"const":"ordinary_least_squares"},"x_unit":{"const":"calendar_quarter"},"y_transform":{"enum":["natural_log","identity"]},"r_squared_domain":{"enum":["log_values","raw_values"]},"first_period":{"type":"string"},"last_period":{"type":"string"},"quarter_intervals":{"type":"integer","minimum":0},"interpretation":{"const":"historical_fit_not_cagr_or_forecast"}},"required":["model","x_unit","y_transform","r_squared_domain","first_period","last_period","quarter_intervals","interpretation"],"additionalProperties":true}},"required":["annualizedChange","observations","rSquared","usesLogScale","metadata"],"additionalProperties":true},{"type":"null"}]}},"required":["observed_change","year_over_year","regression"],"additionalProperties":true},"secondary":{"anyOf":[{"type":"object","properties":{"observed_change":{"type":"object","properties":{"basis":{"enum":["selected_window_endpoints","same_quarter_prior_year"]},"start_period":{"type":["string","null"]},"end_period":{"type":["string","null"]},"start_value":{"type":["number","null"]},"end_value":{"type":["number","null"]},"value":{"type":["number","null"]},"unit":{"enum":["percent","percentage_points"]},"absolute_change":{"type":["number","null"]},"absolute_unit":{"enum":["USD_thousands","percent","full_time_equivalent_employees","percentage_points"]},"quarter_intervals":{"type":["integer","null"]},"missing_reason":{"type":["string","null"]}},"required":["basis","start_period","end_period","start_value","end_value","value","unit","absolute_change","absolute_unit","quarter_intervals","missing_reason"],"additionalProperties":true},"year_over_year":{"type":"object","properties":{"basis":{"enum":["selected_window_endpoints","same_quarter_prior_year"]},"start_period":{"type":["string","null"]},"end_period":{"type":["string","null"]},"start_value":{"type":["number","null"]},"end_value":{"type":["number","null"]},"value":{"type":["number","null"]},"unit":{"enum":["percent","percentage_points"]},"absolute_change":{"type":["number","null"]},"absolute_unit":{"enum":["USD_thousands","percent","full_time_equivalent_employees","percentage_points"]},"quarter_intervals":{"type":["integer","null"]},"missing_reason":{"type":["string","null"]}},"required":["basis","start_period","end_period","start_value","end_value","value","unit","absolute_change","absolute_unit","quarter_intervals","missing_reason"],"additionalProperties":true},"regression":{"anyOf":[{"type":"object","properties":{"annualizedChange":{"type":"number"},"observations":{"type":"integer","minimum":0},"rSquared":{"type":"number"},"usesLogScale":{"type":"boolean"},"metadata":{"type":"object","properties":{"model":{"const":"ordinary_least_squares"},"x_unit":{"const":"calendar_quarter"},"y_transform":{"enum":["natural_log","identity"]},"r_squared_domain":{"enum":["log_values","raw_values"]},"first_period":{"type":"string"},"last_period":{"type":"string"},"quarter_intervals":{"type":"integer","minimum":0},"interpretation":{"const":"historical_fit_not_cagr_or_forecast"}},"required":["model","x_unit","y_transform","r_squared_domain","first_period","last_period","quarter_intervals","interpretation"],"additionalProperties":true}},"required":["annualizedChange","observations","rSquared","usesLogScale","metadata"],"additionalProperties":true},{"type":"null"}]}},"required":["observed_change","year_over_year","regression"],"additionalProperties":true},{"type":"null"}]}},"required":["metric_id","primary","secondary"],"additionalProperties":true}},"quarterly_detail":{"type":"array","items":{"type":"object","properties":{"report_period":{"type":"string"},"rows":{"type":"array","items":{"type":"object"}}},"required":["report_period","rows"],"additionalProperties":true}}},"required":["statistics_version","selection","chart_series","summaries","quarterly_detail"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"get_trends"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"get_peers":{"http":{"method":"GET","path":"/api/v1/peers"},"input":{"type":"object","properties":{"primary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"secondary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"asserted_period":{"type":"string","pattern":"^\\d{4}-(03-31|06-30|09-30|12-31)$"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"cursor":{"type":"string","minLength":1,"maxLength":2048}},"required":["primary_cert"],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"institutions":{"type":"array","items":{"type":"object","properties":{"cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$"},"name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"assets":{"type":["number","null"]}},"required":["cert","name","assets"],"additionalProperties":true}},"count":{"type":"integer","minimum":0},"description":{"type":"string"},"trend":{"type":"object"}},"required":["institutions","count","description","trend"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"get_peers"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"get_metric_definitions":{"http":{"method":"GET","path":"/api/v1/metrics"},"input":{"type":"object","properties":{"metric_ids":{"type":"array","items":{"type":"string","enum":["ASSET","ASSET_GROWTH","LOAN_GROWTH","DEPOSIT_GROWTH","ROA","ROE","NIMY","EEFFR","NCLNLSR","NTLNLSR","LNLSDEPR","UNINSURED_DEPOSIT_SHARE","COREDEPR","EQTOTR","RBC1AAJ","RBCT1CER","NUMEMP"]},"minItems":1,"maxItems":17,"uniqueItems":true}},"required":[],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"unit":{"type":"string"}},"required":["key","label","unit"],"additionalProperties":true}}},"required":["metrics"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"get_metric_definitions"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"get_methodology":{"http":{"method":"GET","path":"/api/v1/methodology"},"input":{"type":"object","properties":{"calculation_version":{"type":"string","minLength":1,"maxLength":64},"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}},"required":[],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"calculation_version":{"type":"string"},"sections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"}},"required":["id","title","text"],"additionalProperties":true}},"integrity_fixes":{"type":"array","items":{"type":"string"}},"pending_decisions":{"type":"array","items":{"type":"string"}}},"required":["calculation_version","sections","integrity_fixes","pending_decisions"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"get_methodology"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"get_data_status":{"http":{"method":"GET","path":"/api/v1/status"},"input":{"type":"object","properties":{"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}},"required":[],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"source":{"type":"object"},"storage":{"type":"object","properties":{"durability":{"enum":["ephemeral","durable"]},"retention_seconds":{"type":"integer","minimum":0}},"required":["durability","retention_seconds"],"additionalProperties":true},"snapshot":{"type":["object","null"]},"status":{"type":"string"}},"required":["source","storage","snapshot","status"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"get_data_status"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"build_analysis_link":{"http":{"method":"GET","path":"/api/v1/link"},"input":{"type":"object","properties":{"primary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"secondary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"asserted_period":{"type":"string","pattern":"^\\d{4}-(03-31|06-30|09-30|12-31)$"},"view":{"type":"string","enum":["overview","trends","peers","methodology"],"default":"overview"},"metric_ids":{"type":"array","items":{"type":"string","enum":["ASSET","ROA","NIMY","EEFFR","NCLNLSR","RBC1AAJ","NUMEMP"]},"minItems":1,"maxItems":7,"uniqueItems":true,"default":["ROA"]},"range":{"type":"string","enum":["3y","5y","10y","20y","since_1990"],"default":"since_1990"},"overlay":{"type":"string","enum":["none","moving","linear","both"],"default":"linear"}},"required":["primary_cert"],"additionalProperties":false},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"selection":{"type":"object"}},"required":["url","path","selection"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"build_analysis_link"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false}},"export_analysis":{"http":{"method":"GET","path":"/api/v1/export"},"input":{"type":"object","properties":{"primary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"secondary_cert":{"type":"string","pattern":"^[1-9][0-9]{0,7}$","maxLength":8},"snapshot_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"asserted_period":{"type":"string","pattern":"^\\d{4}-(03-31|06-30|09-30|12-31)$"},"section":{"type":"string","enum":["overview","trends","peers"]},"format":{"type":"string","enum":["json","csv"]},"metric_ids":{"type":"array","items":{"type":"string","enum":["ASSET","ASSET_GROWTH","LOAN_GROWTH","DEPOSIT_GROWTH","ROA","ROE","NIMY","EEFFR","NCLNLSR","NTLNLSR","LNLSDEPR","UNINSURED_DEPOSIT_SHARE","COREDEPR","EQTOTR","RBC1AAJ","RBCT1CER","NUMEMP"]},"minItems":1,"maxItems":17,"uniqueItems":true},"range":{"type":"string","enum":["3y","5y","10y","20y","since_1990"],"default":"since_1990"},"overlay":{"type":"string","enum":["none","moving","linear","both"],"default":"linear"},"max_rows":{"type":"integer","minimum":1,"maximum":5000,"default":1000},"cursor":{"type":"string","minLength":1,"maxLength":2048}},"required":["primary_cert","section","format"],"additionalProperties":false,"allOf":[{"if":{"properties":{"section":{"const":"overview"}},"required":["section"]},"then":{"properties":{"metric_ids":{"items":{"enum":["ASSET","ASSET_GROWTH","LOAN_GROWTH","DEPOSIT_GROWTH","ROA","ROE","NIMY","EEFFR","NCLNLSR","NTLNLSR","LNLSDEPR","UNINSURED_DEPOSIT_SHARE","COREDEPR","EQTOTR","RBC1AAJ","RBCT1CER"]}}}}},{"if":{"properties":{"section":{"const":"trends"}},"required":["section"]},"then":{"properties":{"metric_ids":{"items":{"enum":["ASSET","ROA","NIMY","EEFFR","NCLNLSR","RBC1AAJ","NUMEMP"]}}}}},{"if":{"properties":{"section":{"const":"peers"}},"required":["section"]},"then":{"not":{"required":["metric_ids"]}}}]},"output":{"type":"object","properties":{"schema_version":{"type":"string"},"calculation_version":{"type":"string"},"snapshot_id":{"type":["string","null"]},"report_period":{"type":["string","null"]},"retrieved_at":{"type":"string"},"source_updated_at":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"source_complete":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"retrieved_at":{"type":"string"},"expected":{"type":"integer","minimum":0},"retrieved":{"type":"integer","minimum":0},"complete":{"type":"boolean"},"source_updated_at":{"type":["string","null"]},"checksum":{"type":"string"}},"required":["url","retrieved_at","expected","retrieved","complete"],"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"data":{"type":"object","properties":{"format":{"enum":["json","csv"]},"filename":{"type":"string"},"mime_type":{"type":"string"},"row_count":{"type":"integer","minimum":0},"total_rows":{"type":"integer","minimum":0},"section":{"enum":["overview","trends","peers"]},"bytes":{"type":"integer","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"url":{"type":"string"},"next_url":{"type":["string","null"]},"availability":{"type":"string"}},"required":["format","filename","mime_type","row_count","total_rows","section","bytes","sha256","url","next_url","availability"],"additionalProperties":true},"page":{"type":"object","properties":{"scope":{"type":"string"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["scope","total","returned","has_more","next_cursor"],"additionalProperties":true},"receipt":{"type":"object","properties":{"request_id":{"type":"string"},"operation":{"const":"export_analysis"},"status":{"const":"succeeded"},"completed_at":{"type":"string"},"policy_version":{"type":"string"}},"required":["request_id","operation","status","completed_at","policy_version"],"additionalProperties":true}},"required":["schema_version","calculation_version","snapshot_id","report_period","retrieved_at","source_updated_at","source_urls","source_complete","sources","warnings","data"],"additionalProperties":false},"http_output":"File content, with checksum, row-count and next-page Link headers; MCP output is a download descriptor."}}}