Worldcastr MCP
Worldcastr provides an MCP server that enables AI agents to access parcel-level real estate forecasts, uncertainty bands, public benchmarks, and permit or zoning readiness data across multiple U.S. geographies.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://worldcastr.com/api/mcp/mcpWhat its tools do
44 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (44)
forecast_by_addressforecast_by_parcelforecast_by_tabblockforecast_by_tractforecast_by_zctaforecast_by_unitforecast_by_countyforecast_by_stateforecast_by_zip3forecast_by_h3_cellget_permit_zoning_readinessget_census_bps_county_monthlyget_fast41_projectsget_epa_echo_npdes_sewer_overflowsget_epa_echo_npdes_outfallsget_epa_echo_npdes_sewer_overflow_historyget_epa_echo_npdes_violationslist_benchmark_datasetsget_benchmark_datasetget_public_forecast_vintageget_backtest_scoreslist_data_assetsget_data_assetlist_data_sourcesget_data_sourceget_panel_lineageget_data_coveragelist_source_coverage_indexlist_public_records_acquisitionget_source_coverage_maplist_data_schemasget_data_schemaget_entityget_geography_crosswalkget_provenanceget_data_artifactget_forecast_vintageget_benchmark_resultget_county_outlooklist_benchmark_sourceslist_training_runsget_analytics_eventsget_api_statusget_api_usage
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Warning Advertises resources/list but does not implement it
- Warning Advertises resources/templates/list but does not implement it
- Warning Advertises prompts/list but does not implement it
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Retrieve parcel-level forecasts for individual homes
- Access public benchmarks and backtest score summaries
- Check permit or zoning readiness for specific locations
- Generate county outlook metrics for appreciation and trajectory
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- homecastr-mcp-server 1.16.0
- MCP protocol negotiated in check
- 2025-03-26
- Tools
- 44 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {},
"logging": {},
"prompts": {},
"resources": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
44 advertised
forecast_by_address — Forecast by Address
Get probabilistic home value forecasts for a US street address. Returns P10/P50/P90 bands, appreciation %, reliability score, and 5-year fan chart. Best coverage: Houston metro area.
{
"type": "object",
"required": [
"address"
],
"properties": {
"year": {
"type": "number",
"description": "Target forecast year (2026-2030, default: 2030)"
},
"address": {
"type": "string",
"description": "US street address, e.g. '5000 Westheimer Rd Houston TX 77056'"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by Address",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_parcel — Forecast by Parcel ID
Get lot-level probabilistic forecasts by county tax parcel account number. Coverage: Florida statewide + Houston metro. Returns P10/P25/P50/P75/P90 fan chart across 1-5 year horizons.
{
"type": "object",
"required": [
"acct"
],
"properties": {
"acct": {
"type": "string",
"description": "County tax parcel account number. Florida: dash-separated (e.g. '00404328020003500'). Houston HCAD: 10-13 digits."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by Parcel ID",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_tabblock — Forecast by Census Tabulation Block
Get sub-neighborhood probabilistic forecasts by US Census tabulation block GEOID20 (15 digits). Coverage: NYC (32K tabblocks) and Houston metro (34K tabblocks). Highest geographic resolution available.
{
"type": "object",
"required": [
"geoid"
],
"properties": {
"geoid": {
"type": "string",
"description": "15-digit Census GEOID20 (state 2 + county 3 + tract 6 + block 4). NYC example: '360050002000001'. Houston example: '480717106001022'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by Census Tabulation Block",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_tract — Forecast by Census Tract
Get neighborhood-level probabilistic forecasts by US Census tract GEOID20 (11 digits). Coverage: Florida + Houston via jurisdiction model; all ~82K US tracts via ACS nationwide model. Useful for cross-market analysis.
{
"type": "object",
"required": [
"geoid"
],
"properties": {
"geoid": {
"type": "string",
"description": "11-digit Census tract GEOID20 (state 2 + county 3 + tract 6). Example: '48201231400' (Harris County, TX). '36061023100' (Manhattan, NY)."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by Census Tract",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_zcta — Forecast by ZIP Code (ZCTA)
Get ZIP-level probabilistic forecasts by 5-digit ZCTA. Coverage: ~20,000 ZCTAs nationwide via ACS model with 6-year horizon (0-72 months). Use this for quick cross-market ZIP-level comparisons.
{
"type": "object",
"required": [
"zcta"
],
"properties": {
"zcta": {
"type": "string",
"description": "5-digit ZCTA / ZIP code. Examples: '77056' (Houston Galleria), '10001' (Manhattan), '94110' (SF Mission), '60614' (Chicago Lincoln Park)."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by ZIP Code (ZCTA)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_unit — Forecast by Individual Unit
Get unit-level forecasts by assessor account. Finest resolution - individual condo units, SFRs, townhouses. Use include_siblings=true to get all units in the same condo building. Coverage: Florida + Houston.
{
"type": "object",
"required": [
"acct"
],
"properties": {
"acct": {
"type": "string",
"description": "Assessor account. FL DOR: '00404328020003500'. Houston HCAD: 10-13 digits."
},
"include_siblings": {
"type": "boolean",
"description": "Return all condo sibling units (same condo_group). Default: false."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by Individual Unit",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_county — Forecast by County
Get county-level probabilistic forecasts by 5-digit FIPS. Nationwide coverage. Good for market-level analysis.
{
"type": "object",
"required": [
"fips"
],
"properties": {
"fips": {
"type": "string",
"description": "5-digit county FIPS. Harris County TX=48201, LA=06037, Manhattan=36061, Miami-Dade=12086, Cook County IL=17031, King County WA=53033."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by County",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_state — Forecast by State
Get state-level probabilistic forecasts by 2-digit FIPS. All 50 US states. Use for macro market selection.
{
"type": "object",
"required": [
"fips"
],
"properties": {
"fips": {
"type": "string",
"description": "2-digit state FIPS. TX=48, FL=12, NY=36, CA=06, IL=17, WA=53."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by State",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_zip3 — Forecast by ZIP3
Get ZIP3-level forecasts (first 3 ZIP digits). 6,210 areas nationwide. Mid-size geography between ZCTA and county.
{
"type": "object",
"required": [
"zip3"
],
"properties": {
"zip3": {
"type": "string",
"description": "First 3 digits of ZIP. Houston=770, Manhattan=100, Miami=331, Chicago=606, SF=941, Seattle=981, LA=900."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by ZIP3",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}forecast_by_h3_cell — Forecast by H3 Cell (Houston)
Get neighborhood-level forecasts by H3 hex cell ID at resolution 8. Houston metro only. Prefer forecast_by_tabblock or forecast_by_tract for new integrations.
{
"type": "object",
"required": [
"h3_id"
],
"properties": {
"year": {
"type": "number",
"description": "Target forecast year (default: 2026)"
},
"h3_id": {
"type": "string",
"description": "H3 cell ID at resolution 8, e.g. '882a100c65fffff'"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Forecast by H3 Cell (Houston)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_permit_zoning_readiness — Permit and Zoning Readiness
Get permit, zoning, energy, and public-record data readiness metadata. Use this before building permit/zoning markets or agent workflows; it reports verified R2 evidence, gaps, and whether raw rows are exposed.
{
"type": "object",
"properties": {
"summary": {
"type": "boolean",
"description": "Return only aggregate source and market readiness counts."
},
"market_id": {
"type": "string",
"description": "Optional market-template id to inspect, e.g. 'monthly_county_permit_pulse'."
},
"source_id": {
"type": "string",
"description": "Optional source id to inspect, e.g. 'census_bps_county_monthly_ascii'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Permit and Zoning Readiness",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_census_bps_county_monthly — Census BPS County Monthly Permits
Query normalized Census Building Permits Survey county-month rows from Worldcastr's public R2-backed permit surface. Use this for independently verifiable county permit totals, monthly settlement checks, and builder/market data workflows.
{
"type": "object",
"properties": {
"kind": {
"enum": [
"current_month",
"year_to_date"
],
"type": "string",
"description": "Census BPS file kind. Defaults to current_month."
},
"year": {
"type": "number",
"description": "Optional four-digit survey year. Supply together with month unless history=true."
},
"limit": {
"type": "number",
"description": "Maximum rows to return, capped at 5000. Defaults to 100."
},
"month": {
"type": "number",
"description": "Optional survey month, 1-12. Supply together with year unless history=true."
},
"history": {
"type": "boolean",
"description": "If true, returns a county time series across available partitions. Requires county_fips."
},
"summary": {
"type": "boolean",
"description": "If true, returns manifest and partition metadata without row payloads."
},
"state_fips": {
"type": "string",
"description": "Optional 2-digit state FIPS filter, e.g. '48' for Texas."
},
"county_fips": {
"type": "string",
"description": "Optional 5-digit county FIPS, e.g. '48201' for Harris County, TX."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Census BPS County Monthly Permits",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_fast41_projects — FAST-41 Federal Permitting Projects
Query normalized FAST-41 federal permitting project inventory rows from Worldcastr's public R2-backed permit surface. Use this for project status, sector, agency, state, and location filters; do not use it for milestone-date settlement until the full FAST-41 dataset is normalized.
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Maximum projects to return, capped at 5000. Defaults to 100."
},
"state": {
"type": "string",
"description": "Optional 2-letter state abbreviation, e.g. 'TX' or 'CA'."
},
"sector": {
"type": "string",
"description": "Optional sector text filter, e.g. 'Electricity Transmission', 'Renewable Energy', or 'Surface Transportation'."
},
"status": {
"type": "string",
"description": "Optional status text filter, e.g. 'In Progress', 'Complete', or 'Paused'."
},
"summary": {
"type": "boolean",
"description": "If true, returns manifest and count metadata without row payloads."
},
"project_id": {
"type": "string",
"description": "Optional numeric FAST-41 project id."
},
"lead_agency": {
"type": "string",
"description": "Optional lead agency text filter."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "FAST-41 Federal Permitting Projects",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_epa_echo_npdes_sewer_overflows — EPA ECHO NPDES Sewer Overflow Events
Query normalized EPA ECHO NPDES current sewer overflow and bypass event rows from Worldcastr's public R2-backed environmental permit surface. Use this for public event context by permit, state, year, event type, volume, and coordinates; add refresh/checksum policy before autonomous settlement.
{
"type": "object",
"properties": {
"year": {
"type": "number",
"description": "Optional event year based on event start datetime or report start date."
},
"limit": {
"type": "number",
"description": "Maximum events to return, capped at 5000. Defaults to 100."
},
"state": {
"type": "string",
"description": "Optional 2-character permit state prefix, e.g. 'IL', 'GA', 'PR', or 'TX'."
},
"summary": {
"type": "boolean",
"description": "If true, returns manifest and count metadata without row payloads."
},
"permit_id": {
"type": "string",
"description": "Optional exact NPDES permit identifier."
},
"event_type": {
"type": "string",
"description": "Optional event type text filter, e.g. 'Sanitary Sewer Overflow', 'Combined Sewer Overflow', or 'Bypass'."
},
"with_coordinates": {
"type": "boolean",
"description": "If true, return only events with latitude and longitude."
},
"min_volume_gallons": {
"type": "number",
"description": "Optional minimum reported discharge volume in gallons."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "EPA ECHO NPDES Sewer Overflow Events",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_epa_echo_npdes_outfalls — EPA ECHO ICIS-NPDES Outfalls
Query normalized EPA ECHO ICIS-NPDES outfall, facility, permit-status, and compliance context rows from Worldcastr's public R2-backed environmental permit surface. Use this for public construction stormwater, wastewater, waterbody, permit-component, and current-violation screening; full ICIS limits, effluent, and violation tables still need separate normalization before settlement use.
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Maximum outfall rows to return, capped at 5000. Defaults to 100."
},
"state": {
"type": "string",
"description": "Optional 2-character permit state prefix, e.g. 'TX', 'GA', 'WV', or 'CA'. Required unless permit_id or summary=true is supplied."
},
"status": {
"type": "string",
"description": "Optional permit status code or text filter, e.g. 'EFF', 'Effective', 'Admin Continued', or 'Terminated'."
},
"summary": {
"type": "boolean",
"description": "If true, returns manifest and partition metadata without row payloads."
},
"component": {
"type": "string",
"description": "Optional permit component text filter, e.g. 'Construction Stormwater', 'Industrial Stormwater', 'POTW', 'CSO', or 'CAFO'."
},
"permit_id": {
"type": "string",
"description": "Optional exact NPDES permit identifier. If state is omitted, the first two permit characters are used as the state partition."
},
"cwa_status": {
"type": "string",
"description": "Optional Clean Water Act status text filter, e.g. 'Violation Identified' or 'No Violation Identified'."
},
"with_coordinates": {
"type": "boolean",
"description": "If true, return only rows with latitude and longitude."
},
"current_violation": {
"type": "boolean",
"description": "Optional current violation flag."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "EPA ECHO ICIS-NPDES Outfalls",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_epa_echo_npdes_sewer_overflow_history — EPA ECHO NPDES Sewer Overflow Event History
Query normalized EPA ECHO NPDES all-version sewer overflow and bypass event rows from Worldcastr's public R2-backed environmental permit surface. Use this for public amendment/replacement history by permit, state, year, event type, volume, current-report flag, and replacing payload IDs; add refresh/checksum policy before autonomous settlement.
{
"type": "object",
"properties": {
"year": {
"type": "number",
"description": "Optional event year based on event start datetime or report start date."
},
"limit": {
"type": "number",
"description": "Maximum event-version rows to return, capped at 5000. Defaults to 100."
},
"state": {
"type": "string",
"description": "Optional 2-character permit state prefix, e.g. 'IL', 'GA', 'PR', or 'TX'."
},
"summary": {
"type": "boolean",
"description": "If true, returns manifest and count metadata without row payloads."
},
"permit_id": {
"type": "string",
"description": "Optional exact NPDES permit identifier."
},
"event_type": {
"type": "string",
"description": "Optional event type text filter, e.g. 'Sanitary Sewer Overflow', 'Combined Sewer Overflow', or 'Bypass'."
},
"current_only": {
"type": "boolean",
"description": "If true, return only rows where EPA marks the report form as current."
},
"include_replaced": {
"type": "boolean",
"description": "If false, exclude replaced or non-current report versions. Defaults to true."
},
"with_coordinates": {
"type": "boolean",
"description": "If true, return only events with latitude and longitude."
},
"min_volume_gallons": {
"type": "number",
"description": "Optional minimum reported discharge volume in gallons."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "EPA ECHO NPDES Sewer Overflow Event History",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_epa_echo_npdes_violations — EPA ECHO ICIS-NPDES Violations
Query normalized EPA ECHO ICIS-NPDES non-effluent violation rows from Worldcastr's public R2-backed environmental permit surface. Use this for permit-schedule, compliance-schedule, and single-event violation context by permit, state, year, violation code, RNC status, and linked-enforcement counts; full effluent violations, limits, and detailed enforcement action expansion still need separate normalization before settlement use.
{
"type": "object",
"properties": {
"year": {
"type": "number",
"description": "Optional calendar year based on the violation, schedule, RNC detection, or actual date."
},
"limit": {
"type": "number",
"description": "Maximum violation rows to return, capped at 5000. Defaults to 100."
},
"state": {
"type": "string",
"description": "Optional 2-character permit state prefix, e.g. 'TX', 'IL', 'MO', or 'NY'. Required unless permit_id or summary=true is supplied."
},
"summary": {
"type": "boolean",
"description": "If true, returns manifest and partition metadata without row payloads."
},
"category": {
"type": "string",
"description": "Optional violation category: permit_schedule, compliance_schedule, or single_event."
},
"permit_id": {
"type": "string",
"description": "Optional exact NPDES permit identifier. If state is omitted, the first two permit characters are used as the state partition."
},
"violation_code": {
"type": "string",
"description": "Optional ICIS violation code filter, e.g. 'A0011' or 'C40'."
},
"rnc_detection_code": {
"type": "string",
"description": "Optional RNC detection code filter."
},
"rnc_resolution_code": {
"type": "string",
"description": "Optional RNC resolution code filter."
},
"has_linked_enforcement": {
"type": "boolean",
"description": "If true, return only violation rows linked to one or more enforcement-action rows; if false, return only rows without linked enforcement."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "EPA ECHO ICIS-NPDES Violations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_benchmark_datasets — List Benchmark Datasets
List Worldcastr benchmark and public-data assets. Returns release phase, support level, benchmark role, and the recommended public surface for each asset.
{
"type": "object",
"properties": {
"phase": {
"type": "string",
"description": "Optional release phase filter. Common values: 'phase_1', 'phase_2', 'phase_3', or 'hold'."
},
"asset_class": {
"type": "string",
"description": "Optional asset class filter. Common values: 'forecast_outputs', 'backtest_vintage_outputs', 'benchmark_panels', 'provenance_manifests', 'holdback_assets'."
},
"public_readiness": {
"type": "string",
"description": "Optional readiness filter. Values: 'launch', 'draft', or 'hold'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Benchmark Datasets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_benchmark_dataset — Get Benchmark Dataset
Get the catalog entry for one Worldcastr public-data or benchmark asset by asset_id. Use this to discover the right REST path before calling vintages, backtests, or source manifests.
{
"type": "object",
"required": [
"asset_id"
],
"properties": {
"asset_id": {
"type": "string",
"description": "Stable Worldcastr asset identifier, e.g. 'backtest.public_vintage_oeo_maricopa_2022'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Benchmark Dataset",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_public_forecast_vintage — Get Public Forecast Vintage
Retrieve validated public forecast vintage rows, starting with the Arizona OEO Maricopa 2022 county-control fixture. Every row carries provenance and benchmark-only labeling.
{
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Optional target filter such as 'total_population'."
},
"vintage_id": {
"type": "string",
"description": "Optional vintage identifier, e.g. 'az_oeo_maricopa_medium_2022_report'."
},
"support_level": {
"type": "string",
"description": "Optional support-level filter such as 'county'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Public Forecast Vintage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_backtest_scores — Get Backtest Scores
Retrieve public-safe benchmark score summaries such as model-vs-persistence tables. Returns asset IDs, artifact IDs, model version labels, and per-target score rows.
{
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Optional target filter such as 'total_population'."
},
"benchmark_id": {
"type": "string",
"description": "Optional benchmark identifier, e.g. 'acs_cutoff2016_horizon8_maricopa_realized_acs'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Backtest Scores",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_data_assets — List Data Assets
List the canonical Worldcastr data-asset catalog across public, metadata-only, restricted, and unavailable rows. Use this to discover the full standardized surface, not just currently launched endpoints.
{
"type": "object",
"properties": {
"visibility": {
"type": "string",
"description": "Optional visibility filter such as 'public', 'metadata_only', 'restricted', or 'unavailable'."
},
"data_family": {
"type": "string",
"description": "Optional family filter such as 'forecast_output', 'input_panel', 'source_metadata', or 'provenance_manifest'."
},
"public_status": {
"type": "string",
"description": "Optional public status filter such as 'launch', 'draft', 'metadata_only', 'hold', or 'not_public'."
},
"inventory_asset": {
"type": "string",
"description": "Optional public-data inventory asset filter such as 'forecast.aggregate_surfaces' or 'benchmark.normalized_training_panels_candidate'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Data Assets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_data_asset — Get Data Asset
Get one canonical data-asset record by asset_id. Returns surface coverage, canonical contracts, provenance, access policy, and related artifact or provenance links.
{
"type": "object",
"required": [
"asset_id"
],
"properties": {
"asset_id": {
"type": "string",
"description": "Canonical data asset identifier, e.g. 'forecast.tract_home_value' or 'context.census_acs'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Data Asset",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_data_sources — List Data Sources
List original data sources used, staged, or reviewed for Worldcastr panels. Returns official outbound source URLs, source tier, source status, panel links, license status, and public readiness.
{
"type": "object",
"properties": {
"panel_id": {
"type": "string",
"description": "Optional canonical panel filter such as 'panel.acs_nationwide' or 'panel.az_maricopa_mag_multires_enriched'."
},
"source_id": {
"type": "string",
"description": "Optional exact source identifier such as 'census.acs.county_5yr' or 'az.mag_2023_official_mpa_raz_taz_projections'."
},
"data_family": {
"type": "string",
"description": "Optional source-family filter such as 'assessor_tax', 'hazard_context', 'permits', or 'mag_public_projection_and_planning_surfaces'."
},
"source_status": {
"type": "string",
"description": "Optional status filter such as 'used', 'candidate', 'blocked', or 'mentioned'."
},
"license_status": {
"type": "string",
"description": "Optional license or policy filter such as 'public_source_reviewed', 'public_source_metadata_only', or 'source_specific_review_required'."
},
"public_readiness": {
"type": "string",
"description": "Optional readiness filter such as 'metadata_public', 'metadata_public_raw_hold', or 'summary_public_rows_missing'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Data Sources",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_data_source — Get Data Source
Get one original data source by source_id, including official outbound URLs, source family, panel links, provenance metadata, and access policy.
{
"type": "object",
"required": [
"source_id"
],
"properties": {
"source_id": {
"type": "string",
"description": "Canonical source identifier such as 'source.hcad_houston.assessor' or 'census.building_permits.county_month'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Data Source",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_panel_lineage — Get Panel Lineage
Get the source-to-panel lineage for a canonical panel. Returns source roles, join keys, transforms, output fields, and official source URLs.
{
"type": "object",
"required": [
"panel_id"
],
"properties": {
"panel_id": {
"type": "string",
"description": "Canonical panel identifier such as 'panel.acs_nationwide' or 'panel.az_maricopa_mag_multires_enriched'."
},
"source_id": {
"type": "string",
"description": "Optional source identifier filter for one lineage edge or source family member."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Panel Lineage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_data_coverage — Get Data Coverage
Summarize source, panel, source-to-geography index, and coverage-map posture across the source inventory. Returns counts by tier, status, family, geography, resolution, license status, panel lineage, coverage geometry role, native-boundary status, and top coverage-map regions.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Data Coverage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_source_coverage_index — List Source Coverage Index
List source-to-coverage geography index rows. Returns one row per source with coverage feature IDs, declared geography, coverage geometry role, reference boundary IDs/names when available, native-boundary review status, official URLs, and geometry redistribution policy.
{
"type": "object",
"properties": {
"panel_id": {
"type": "string",
"description": "Optional panel identifier such as 'panel.az_maricopa_mag_multires_enriched'."
},
"source_id": {
"type": "string",
"description": "Optional exact source identifier such as 'az.maricopa_parcels'."
},
"source_family": {
"type": "string",
"description": "Optional source-family filter such as 'maricopa_assessor_parcels' or 'assessor_tax'."
},
"license_status": {
"type": "string",
"description": "Optional license or policy status filter."
},
"public_readiness": {
"type": "string",
"description": "Optional public-readiness filter such as 'metadata_public'."
},
"coverage_feature_id": {
"type": "string",
"description": "Optional coverage-map feature identifier such as 'coverage.arizona_phoenix_maricopa_pinal'."
},
"coverage_geometry_role": {
"type": "string",
"description": "Optional coverage geometry role such as 'reference_boundary' or 'generalized_selection_region'."
},
"native_boundary_status": {
"type": "string",
"description": "Optional native-boundary status such as 'native_boundary_candidate_terms_review_required' or 'reference_boundary_join_required'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Source Coverage Index",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_public_records_acquisition — List Public Records Acquisition
List metadata-only public-records acquisition evidence lanes. Returns durable cloud evidence, public-route checks, records-law gate posture, holdbacks, and next safe action without exposing raw payloads or send-ready request copy.
{
"type": "object",
"properties": {
"lane_id": {
"type": "string",
"description": "Optional exact acquisition lane identifier such as 'georgia_permit_public_routes'."
},
"geography": {
"type": "string",
"description": "Optional geography token filter such as 'US-FL-Orange' or 'US-AZ-Maricopa'."
},
"source_family": {
"type": "string",
"description": "Optional source-family filter such as 'utility_energy_infrastructure' or 'assessor_tax'."
},
"current_status": {
"type": "string",
"description": "Optional acquisition status filter such as 'public_r2_partial_downstream_screen_complete'."
},
"records_law_gate": {
"type": "string",
"description": "Optional request-gate posture such as 'closed_no_send_ready_candidate' or 'draft_only_no_live_request'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Public Records Acquisition",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_source_coverage_map — Get Source Coverage Map
Return the public source coverage GeoJSON layer used by the interactive docs map. Features carry public reference boundaries or generalized selection regions, associated source IDs, official upstream URLs, panel links, readiness, license metadata, and geometry notes.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Source Coverage Map",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_data_schemas — List Data Schemas
List canonical Worldcastr schema contracts from the public schema bundle. Use this to discover dataset, provenance, panel, forecast, benchmark, and artifact contract IDs.
{
"type": "object",
"properties": {
"schema_id": {
"type": "string",
"description": "Optional canonical schema filter such as 'hc.dataset_asset.v1' or 'hc.panel_row.v1'."
},
"data_family": {
"type": "string",
"description": "Optional family filter such as 'forecast_output' or 'training_panel'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Data Schemas",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_data_schema — Get Data Schema
Get one canonical schema definition by schema_id, including its JSON Schema definition and the data families or assets that reference it.
{
"type": "object",
"required": [
"schema_id"
],
"properties": {
"schema_id": {
"type": "string",
"description": "Canonical schema identifier, e.g. 'hc.dataset_asset.v1'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Data Schema",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_entity — Get Entity
Get canonical metadata for one geography entity such as a tract, county, ZCTA, state, or tabblock. Returns normalized IDs, labels, parent hierarchy, and source asset links.
{
"type": "object",
"required": [
"entity_id"
],
"properties": {
"entity_id": {
"type": "string",
"description": "Canonical entity identifier such as '48201231400' for a tract, '48201' for a county, '77056' for a ZCTA, or '48' for a state."
},
"entity_type": {
"type": "string",
"description": "Optional explicit entity type such as 'tract', 'county', 'zcta', 'state', or 'tabblock'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Entity",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_geography_crosswalk — Get Geography Crosswalk
Resolve canonical geography crosswalk rows such as tract-to-county, tract-to-state, tract-to-ZCTA, or tabblock-to-tract mappings.
{
"type": "object",
"required": [
"source_entity_id"
],
"properties": {
"source_entity_id": {
"type": "string",
"description": "Source entity identifier such as tract GEOID20 '48201231400' or tabblock GEOID20 '480717106001022'."
},
"source_entity_type": {
"type": "string",
"description": "Optional explicit source entity type such as 'tract', 'county', or 'tabblock'."
},
"target_entity_type": {
"type": "string",
"description": "Optional target entity type such as 'state', 'county', 'tract', or 'zcta'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Geography Crosswalk",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_provenance — Get Provenance
Get one reviewed provenance manifest or source ledger by provenance_id. Returns retrieval and publication metadata, benchmark role, summary counts, and any public-safe details.
{
"type": "object",
"required": [
"provenance_id"
],
"properties": {
"provenance_id": {
"type": "string",
"description": "Reviewed provenance identifier such as 'provenance.arizona_archive_status_ledger' or 'benchmark.raw_single_source_registry'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Provenance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_data_artifact — Get Data Artifact
Get metadata for one reviewed public artifact by artifact_id. Returns format, media type, owner asset, retrieval metadata, and the canonical download path.
{
"type": "object",
"required": [
"artifact_id"
],
"properties": {
"artifact_id": {
"type": "string",
"description": "Artifact identifier such as 'public-data.full_data_surface_matrix_tsv' or 'benchmark.public_vintage_oeo_maricopa_2022_csv'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Data Artifact",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_forecast_vintage — Get Forecast Vintage
Get one canonical public forecast vintage by vintage_id. Returns grouped same-vintage public forecast series with provenance-heavy labeling for benchmark use.
{
"type": "object",
"required": [
"vintage_id"
],
"properties": {
"target": {
"type": "string",
"description": "Optional target filter such as 'total_population'."
},
"vintage_id": {
"type": "string",
"description": "Canonical forecast vintage identifier such as 'az_oeo_maricopa_medium_2022_report'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Forecast Vintage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_benchmark_result — Get Benchmark Result
Get one canonical benchmark result by benchmark_id. Returns standardized score rows, evaluation cutoff metadata, reproducibility references, and benchmark-only labeling.
{
"type": "object",
"required": [
"benchmark_id"
],
"properties": {
"target": {
"type": "string",
"description": "Optional target filter such as 'total_population'."
},
"benchmark_id": {
"type": "string",
"description": "Canonical benchmark identifier such as 'acs_cutoff2016_horizon8_maricopa_realized_acs'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Benchmark Result",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_county_outlook — Get County Outlook
Get the published county outlook metrics for a 5-digit county FIPS code.
{
"type": "object",
"required": [
"fips"
],
"properties": {
"fips": {
"type": "string",
"description": "5-digit county FIPS code."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get County Outlook",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_benchmark_sources — List Benchmark Sources
List reviewed public benchmark source manifests and their provenance metadata.
{
"type": "object",
"properties": {
"asset_id": {
"type": "string",
"description": "Optional benchmark asset identifier."
},
"include_details": {
"type": "boolean",
"description": "Include reviewed manifest details when available."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Benchmark Sources",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_training_runs — List Training Runs
List the published training-run history and cost metadata with optional jurisdiction and year filters.
{
"type": "object",
"properties": {
"year": {
"type": "number",
"description": "Optional year filter."
},
"limit": {
"type": "number",
"description": "Optional maximum number of records."
},
"jurisdiction": {
"type": "string",
"description": "Optional jurisdiction filter."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "List Training Runs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_analytics_events — Get Analytics Events
Get published aggregate product-event statistics with personally identifying fields removed.
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Optional lookback in days."
},
"limit": {
"type": "number",
"description": "Optional maximum number of records."
},
"page_path": {
"type": "string",
"description": "Optional page-path filter."
},
"event_name": {
"type": "string",
"description": "Optional event-name filter."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get Analytics Events",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_api_status — Get API Status
Get the current published Worldcastr API health status.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get API Status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_api_usage — Get API Usage
Get usage statistics for the active Worldcastr API identity.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"result"
],
"properties": {
"result": {}
},
"additionalProperties": false
}{
"title": "Get API Usage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 28111 ms
- 95th percentile latency
- 28111 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 28111 ms · metadata changed · 44 tool(s); warnings: Advertises resources/list but does not implement it; Advertises resources/templates/list but does not implement it; Advertises prompts/list but does not implement it
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http worldcastr-mcp https://worldcastr.com/api/mcp/mcpCodex
codex mcp add worldcastr-mcp --url https://worldcastr.com/api/mcp/mcpCursor
{
"mcpServers": {
"worldcastr-mcp": {
"url": "https://worldcastr.com/api/mcp/mcp"
}
}
}Cline
{
"mcpServers": {
"worldcastr-mcp": {
"type": "streamableHttp",
"url": "https://worldcastr.com/api/mcp/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"worldcastr-mcp": {
"type": "http",
"url": "https://worldcastr.com/api/mcp/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http worldcastr-mcp https://worldcastr.com/api/mcp/mcpClaude Desktop
https://worldcastr.com/api/mcp/mcpWindsurf
{
"mcpServers": {
"worldcastr-mcp": {
"serverUrl": "https://worldcastr.com/api/mcp/mcp"
}
}
}Let your agent find its tools
Find servers like Worldcastr MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.