mcpField
T
TrueFixR Storm Data API

TrueFixR Storm Data API

远程服务
truefixr.com地图与出行03 周前更新

关于 TrueFixR Storm Data API

TrueFixR Storm Data API 提供美国地址级风暴历史、近期事件记录,以及基于模型的天气和灾害预测。面向保险公司、理赔员、物业管理者及数据或 AI Agent 开发者,支持 REST 和 MCP 访问。

主要功能

  1. 01查询地址自 2003 年以来的风暴历史
  2. 02获取地址附近近期风暴记录
  3. 03预测 10 类灾害风险
  4. 04查询点位天气与逐小时预报
  5. 05按县和灾害类型筛选
  6. 06提供免费预览与参考回执

适用场景

  1. 01查看物业周边的风暴记录
  2. 02筛查地址的预测风险
  3. 03查询当前天气和短期降雨
  4. 04按县查找近期风暴线索

MCP 相关

该 API 可通过 MCP 服务供 Claude、ChatGPT 等兼容客户端使用,向 MCP 客户端提供风暴、天气和预测数据集。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.atlasunited.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

6
参数类型必填说明
latnumber否十进制度数表示的纬度。
lonnumber否十进制度数表示的经度。
daysinteger否支持此参数的数据集的回溯天数。
kindstring否仅适用于 dataset=at_risk。将范围缩小到“schools”或“businesses”。
limitinteger否实际付费拉取的最大记录数(默认值为 2000;各数据集仍有实际上限,例如 storms 的上限为 5000)。
perilstring否风暴/风险类型筛选器。用于 dataset=storms 和 dataset=risk(缩小到一种风暴类型;请使用免费预览中 storm_types 下返回的确切名称),也用于 dataset=at_risk(缩小到一个危险类别,含义不同;请查看该数据集自身预览中的实际取值)。常见的 storms/risk 取值:HAIL、THUNDERSTORM_WIND、FLASH_FLOOD、HEAVY_RAIN、FLOOD、TORNADO。
statestring否2 个字母的美国州代码,例如 TX。
countystring否县名,不含“County”一词,例如 Dallas。
formatenum否响应格式。json(默认值)或 csv。json | csv
monthsinteger否仅适用于 dataset=storms。返回按月分桶的历史总数,而非单条线索,范围为最近 N 个月。
windowenum否仅适用于 dataset=risk。预测时间范围。默认值为 24h。24h | 48h | 3d | 5d | 7d | 10d
addressstring否街道地址,适用于 dataset=address。
datasetenum否目标数据集。默认值为 storms。storms | risk | address | coverage | facilities | wildfire | at_risk | daily | history | weather | hazard_score
detailsboolean否仅适用于 dataset=weather(按地址获取基于模型的天气)。true = 完整的当前天气状况数据,费用为 $0.0002/次调用。false(默认值)= 免费精简响应,无需账户。对于此数据集,相当于 addresses=true。
categorystring否仅适用于 dataset=facilities。设施类别筛选条件。
countiesstring否逗号分隔的县名(最多 15 个)及州名,用于汇总多个县的数据。仅提供免费预览。
addressesboolean否false = 免费预览。true = 按地址提供记录——需要使用用户自己的 Atlas United Data API 账户密钥(Authorization 标头),或通过 x402 付款(参见下方的 x_payment 参数);使用 x402 方式无需账户。
radius_minumber否仅适用于 dataset=history。搜索半径,单位为英里。默认值为 5,最大值为 25。
x_paymentstring否可选。已签名的 x402 协议付款载荷(base64),用于在 Base 网络上以 USDC 付款,购买一次按地址提取的数据。若 addresses=true 且未提供 API 密钥或 x_payment,响应将返回 HTTP 402 和完整的付款说明(pay_to 地址、金额、网络);Agent 可据此构造此载荷并重试。
hours_aheadinteger否仅适用于 dataset=weather(按地址获取基于模型的逐小时预报)。预测未来 0–48 小时,而非当前天气状况;将自动匹配到最接近的可用预报时次,响应中的 forecast_hour_used 会准确说明实际使用的时次。
date_of_lossstring否仅适用于 dataset=history。YYYY-MM-DD。以此日期为中心生成报告——返回该日期当天及前后记录到的实际天气事件,供参考。此报告不用于判定任何索赔是否有效。
max_severitynumber否测得严重程度上限。
min_severitynumber否测得严重程度下限(例如,1.5 = 1.5 英寸冰雹)。请在预览中查看 severity_by_type,了解实际单位。

详细介绍

Atlas United 风暴数据 API:覆盖全美各地址的 ML 预测和风暴历史

Atlas United 为全美各地址(纬度/经度)构建风险模型,包含每个地点的所有信息。本仓库介绍该 API:提供未来 24 小时至 10 天的地址级风暴预测,以及自 2003 年以来该地址报告的所有风暴。按地址付费,无需签约。

AtlasCast 是 Atlas United 的预测模型套件:针对 10 种灾害提供概率式地址级预测,每天更新 4 次。TrueFixR 负责风暴数据:按地址提供已报告和雷达探测到的风暴历史。与 NOAA 或 NWS 无关联。

五款产品

#产品dataset=价格
1按地址提供 ML 风暴预测risk每个地址 $0.05
2按地址提供基于模型的天气weather精简响应免费;设置 details=true 后每次调用 $0.0002
3按地址提供基于模型的逐小时预测weather,并设置 hours_ahead(0 到 48)每次调用 $0.0002
4按地址查询风暴历史:自 2003 年以来已报告和雷达探测到的事件history每条事件记录 $0.05,每份报告最低 $10
5按地址查询过往风暴线索:过去 365 天内已报告和雷达探测到的事件storms每个地址 $0.05

产品 1 至 3 为模型输出。产品 4 和 5 为与地址匹配的记录事件。

1. 按地址提供 ML 风暴预测

针对 10 种灾害(龙卷风、冰雹、风、山洪、强降雨、冬季风暴、冰冻、沿海风暴潮、飓风和野火)提供概率式地址级预测,预测时效为 24 小时至 10 天,每天更新 4 次。AtlasCast 为每种灾害分别使用一个机器学习模型。模型按时间顺序训练,并使用留出的已报告事件进行验证;输入仅限于预测发布时间时可用的信息。

每条地址记录都包含建筑物重置成本和该地址的估算人数,以及风暴类型、预测时间、风险标签和历史受灾次数。重置成本是重建建筑物的费用,而非市场价值。时间窗口:24h、48h、3d、5d、7d、10d。可按县、灾害类型和时间窗口筛选。免费预览会显示数量、各灾害类型的总数、县级等级预览,以及确切费用。预测描述的是可能发生的情况,而非必然发生的情况。

2. 按地址提供基于模型的天气

提供美国任意坐标点的天气信息:当前状况、正在生效的恶劣天气警报和短期降雨展望。无需账户即可免费获取精简响应。设置 details=true,即可通过每次调用 $0.0002 获取包含 170 多个变量的完整数据。

3. 按地址提供基于模型的逐小时预测

在天气数据集中添加 hours_ahead(0 到 48),即可获取预测时段的天气,而非当前状况。响应会在 forecast_hour_used 中报告实际采用的小时。逐小时预测包含较少的核心字段。每次调用 $0.0002。

4. 按地址查询风暴历史:自 2003 年以来已报告和雷达探测到的事件

查询单处房产的长期记录:自 2003 年至今,在指定半径内报告或由雷达探测到的每起风暴事件,涵盖 11 个类别(冰雹、风、洪水、闪电、龙卷风、飓风、冬季风暴、极端高温和低温、干旱、野火、沿海灾害)。每条记录包含事件日期、类型、测得时的强度、距离(英里)和县。记录可供引用,并提供 reference_id。可选的 date_of_loss 模式会显示某个日期该地址附近是否有事件报告或由雷达探测到,并列出该日期之前和之后的事件。这是已报告和雷达探测到的事件记录,不是损失评估。

5. 按地址查看过去风暴:过去 365 天内报告或雷达探测到的事件

按地址记录过去 365 天内在各地址处或附近报告或由雷达探测到的风暴事件,可按县、灾害类型和严重程度筛选。每条记录包含事件时间(UTC)、类型、实测或雷达估算的严重程度及其单位、距离和重复命中次数。免费预览会显示数量、严重程度范围和确切费用。此数据并非损失评估。

访问方式

方式适用场景
REST API预付费 API 密钥(起价 $25),Authorization: Bearer <key>
MCP 服务Claude、ChatGPT 和其他兼容 MCP 的 AI 客户端
x402自主 AI Agent:在 Base 上使用 USDC 按请求付费,无需账户

两种方式的价格相同。每个数据集都提供免费预览,可在付费前查看数量和确切价格。每个付费响应都会附带一个 reference_id 收据,且 24 小时内相同的付费查询不会重复计费。

端点

GET  https://data.truefixr.com/v1/data
POST https://data.truefixr.com/v1/data   (same params as a JSON body, keeps addresses out of URLs)
参数说明
datasetrisk、weather、history、storms,以及 address、hazard_score、facilities、wildfire(县级)、at_risk、daily、coverage
state / county2 个字母的州代码 / 县名
peril按灾害类型缩小范围,例如 HAIL、FLASH_FLOOD、HEAVY_RAIN、TORNADO
window仅适用于 risk:24h、48h、3d、5d、7d、10d
hours_ahead仅适用于 weather:0 至 48
addresses免费预览时省略。付费查询时设为 true(weather 使用 details=true)
limit返回的最大记录数(对于价格为 $0.05 的数据集,limit=10 的样本价格为 50 美分)
formatjson 或 csv

不带参数调用该端点,可获取实时的机器可读菜单。各数据集的完整详情:数据集。

批量端点

端点位置上限价格
POST /v1/weather/batch500每个位置 $0.0002
POST /v1/portfolio/risk500每个位置 $0.05(县级预报状态,非地址级)

面向 AI Agent

没有 API 密钥且无需人工介入的 Agent,可通过 x402 按次付费:

  1. 请求付费查询,例如 GET https://data.truefixr.com/v1/data?dataset=storms&county=Dallas&state=TX&addresses=true&limit=1。
  2. 收到包含确切价格的 HTTP 402 响应。
  3. 在 Base 上签署 USDC 付款(eip155:8453),并在请求中加入付款标头后重试。
  4. 获取数据。无需注册,无需密钥。

清单:/.well-known/x402.json。Agent 文档:llms.txt。

数据诚实性

  • 预报描述的是可能发生的情况,而非必然发生的情况。
  • 在地址处或附近报告或由雷达探测到的风暴,不等同于房产检查、损失评估或维修估价。
  • structure_value 是重置成本(重建所需的费用),不是市场价值。
  • 与 NOAA 或 NWS 无关联。

适用对象

保险公司、理赔员、应急管理部门、物业管理公司、修复服务商、太阳能行业,以及数据和 AI Agent 构建者。

文档

链接

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。