关于 DFX Intelligence
DFX Intelligence 是面向 AI Agent 的 MCP 服务,用于私募市场与房地产研究。回答为事实附上来源和观测日期,并区分未知、未覆盖和匹配结果。
主要功能
- 01135 个私募市场研究工具
- 02附来源与观测日期的事实
- 03明确标注匹配和覆盖状态
- 04地址与机构解析
- 05测量覆盖范围并列出已知缺口
适用场景
- 01调查贷款机构与借款人贷款到期日
- 02查看 BDC 持仓及赞助方关系
- 03查询房地产记录和有日期的事件
- 04确认问题是否在覆盖范围内
MCP 相关
通过 Streamable HTTP MCP 端点提供研究和数据工具。匿名读取可用;账户监控工具需要账户密钥,成员登录使用 OAuth 2.1。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://exchange-production-9123.up.railway.app/mcp/core?c=regclaude mcp add --transport http capital-w-holdings-us-property-parcel-real-estate-debt https://exchange-production-9123.up.railway.app/mcp/core?c=reg{"mcpServers":{"capital-w-holdings-us-property-parcel-real-estate-debt":{"type":"http","url":"https://exchange-production-9123.up.railway.app/mcp/core?c=reg"}}}在 Cursor 中打开{"servers":{"capital-w-holdings-us-property-parcel-real-estate-debt":{"type":"http","url":"https://exchange-production-9123.up.railway.app/mcp/core?c=reg"}}}在 VS Code 中打开{"mcpServers":{"capital-w-holdings-us-property-parcel-real-estate-debt":{"type":"http","url":"https://exchange-production-9123.up.railway.app/mcp/core?c=reg"}}}{"mcpServers":{"capital-w-holdings-us-property-parcel-real-estate-debt":{"serverUrl":"https://exchange-production-9123.up.railway.app/mcp/core?c=reg"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://exchange-production-9123.up.railway.app/mcp/core?c=reghttps://exchange-production-9123.up.railway.app/mcp/core/memberhttps://exchange-production-9123.up.railway.app/mcp?c=reg工具
134| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| city | string | 否 | 城市或城镇,例如 'Cambridge'。可选:如果 `address` 中包含带城市和州的一行地址,也可以直接传入完整地址,服务器会拆分。此处提供的值优先于从 `address` 中解析出的任何值。 |
| limit | integer | 否 | 最大 50。此值表示单个地址的候选项数,而不是搜索结果页。若多个已发布记录共用同一地址,结果中的 `address_group_size` 会报告这一情况。 |
| state | string | 否 | 两位字母的州代码 |
| address | string | 是 | 街道地址,包含门牌号,例如 '100 Binney St' |
详细介绍
DFX Intelligence:MCP 服务
面向 Agent 的私人信贷研究。 查询哪些贷款机构为某家公司提供融资,哪些 BDC 持有某位借款人的贷款以及贷款何时到期,某位贷款机构支持哪些赞助方,以及哪些机构投资私人信贷。每个答案都只依据从一手文件中读取并附有引用的主张构建(向 SEC 提交的 BDC 投资组合明细、Form ADV 和 IAPD、公共养老金承诺报告),每一行都注明来源和观察日期。
DFX Intelligence。 面向 AI Agent 的、以证据为支撑的私人资本情报平台,提供 135 个 MCP 工具,覆盖私人信贷、BDC 投资组合和贷款机构;私募股权公司、基金和交易;风险投资;家族办公室;RIA 和顾问变动;独立赞助方;资产配置者和 LP 承诺;房地产基金;美国房地产债务和房产记录。事实均附有来源和观察日期,每个答案都会标明 OK、NO_MATCH、NOT_COVERED 或 UNKNOWN,而不会猜测。135 个工具中有 130 个可免费调用,无需密钥;5 个工具会保存账户自己的研究监控项,需要账户密钥。没有 DFX 套餐时,列表答案会列出前几行并统计其余项目,且绝不返回联系方式。面向 Agent:https://dfxintel.com/agents。
连接
端点(从这里开始,无需登录): https://exchange-production-9123.up.railway.app/mcp/core?c=gh-repo
会员登录(OAuth 2.1): https://exchange-production-9123.up.railway.app/mcp/core/member
完整配置: https://exchange-production-9123.up.railway.app/mcp?c=gh-repo
传输方式: Streamable HTTP
身份验证: 匿名读取无需身份验证;会员可在 dfxintel.com 使用 OAuth 2.1 登录,或使用 dfx_live_ 账户密钥
注册表: io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt
核心配置优先列出 research:一个问题,一次调用即可得到答案,并包含答案所用的读取操作。
完整配置也会优先列出 research,随后列出所有读取工具。会员可在会员 URL 登录(该 URL 永远不会附加标签,
因为 OAuth 资源必须完全匹配),也可在任一匿名 URL 上发送 Authorization: Bearer dfx_live_...。
135 个工具中有 130 个可免费使用,无需密钥、注册或 OAuth。其余 5 个(watch_cancel、watch_changes、watch_create、watch_list 和 watch_reevaluate)会保存账户自己的研究监控项,需要账户密钥。匿名调用者收到的列表答案会列出前 5 行,并统计其余项目,同时说明省略了哪些内容。绝不返回联系方式。
claude mcp add --transport http dfx 'https://exchange-production-9123.up.railway.app/mcp/core?c=gh-repo'
核心配置上的调用示例:
{"name": "research", "arguments": {"question": "Which BDCs hold the loans of Hyland Software and when do they mature?"}}
本页面上的所有数字均根据生产环境测量得出,而非手动填写。最近测量时间为 2026-10-25。阅读时可调用
dfx_coverage获取同一网格的实时数据。
超越私人信贷:美国房地产债务与房产记录
其他图谱(家族办公室、独立发起人、风险投资)见超越房地产。
房地产领域可回答有关两类事项的定时问题:美国商业房地产和联邦计划房地产债务,其中贷款到期日覆盖 52 个州代码,合规到期日覆盖 56 个州代码,补贴到期日覆盖 54 个州代码;以及房产记录,其中纽约州、俄亥俄州、华盛顿州、马萨诸塞州和伊利诺伊州的 2,479,346 块地块附有所有权和评估价值信息,另有 95,616 份已登记的销售文书,覆盖哥伦比亚特区、马萨诸塞州、纽约州和威斯康星州。当 Agent 需要了解某栋建筑的所有者、最近一次售价,或某个州及时间范围内到期的贷款和补贴时,可调用此服务,每项声明都会附上来源和观测日期。
覆盖范围有意设置为不均衡,并会预先明确说明,而不是等你试过才发现。
美国,覆盖范围不均衡。全国范围:联邦计划债务和到期日、LIHTC、HUD 补贴、困境资产和商业租赁。仅限马萨诸塞州:地块和所有权。已登记销售:马萨诸塞州全州范围,另包括售价不低于 1,000 万美元的纽约市房产契据。仅限波士顿:许可证和入住证书。下方的 coverage_by_event_type 是按事件类别、按州统计的实测网格。
各类别、各州的实测数据见下文的事件覆盖范围实测数据,调用时 dfx_coverage 会返回同一网格,因此 Agent 无须根据空结果猜测。
与其只返回空列表,不如清楚地回答“否”,因此此服务在拒绝未知参数时会附上当前支持的词汇表。
调用前先阅读架构
对完整配置文件执行普通 GET 请求,即可获取完整工具列表、覆盖范围数据和一个示例。无需握手、无需会话,也无需 initialize。
curl -s 'https://exchange-production-9123.up.railway.app/mcp?c=gh-repo'
然后通过 JSON-RPC 调用房地产工具(房地产工具位于完整配置文件中):
curl -s 'https://exchange-production-9123.up.railway.app/mcp?c=gh-repo' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":
{"name":"resolve_address","arguments":
{"address":"100 Binney St","city":"Cambridge","state":"MA"}}}'
该地址会返回一块带有已登记销售记录的地块,并附上登记所在的登记簿册号和页码。
如果你是数据采集器,而非调用方
该端点会从自身源站提供发现约定,因此索引无需猜测,也无需他人告知:
| 路径 | 说明 |
|---|---|
/llms.txt | 入口点,适用于只知道此主机名的情况 |
/.well-known/ard.json | Agentic Resource Discovery 目录 |
/.well-known/mcp/server-cards.json | MCP 服务卡片 |
/.well-known/agent-card.json | A2A 风格的 Agent 卡片 |
/agents.txt | agents.txt 约定 |
/openapi.json | 通过普通 HTTP 提供相同的功能 |
/robots.txt | 欢迎爬虫和 Agent 访问,文件中也明确说明了这一点 |
agents.txt 未列出任何支付协议,因为此服务上的内容均不收费。
135 个工具
| 工具 | 参数 | 返回内容 | 价格 |
|---|---|---|---|
research | as_of?, continue?, depth?, detail?, entity?, question?, ... | 一次调用回答一个私募市场问题:BDC 和私募信贷贷款机构、借款人、贷款、到期日和非应计状态、赞助方、顾问、团队、养老金承诺…… | 免费 |
resolve_address | address, city?, state? | 规范 DFX ID、匹配依据及任何歧义 | 免费 |
resolve_organization | name | 所有者、管理人、贷款机构、服务商的实体 ID | 免费 |
get_occupancy | a property or company id, or a company name with an address | 谁被观察到占用某栋建筑,或某公司在哪里运营,并附证据等级 | 免费 |
get_property_record | a DFX id | 州、注明日期的事件、关系、附带到期日的债务、已记录的销售、来源溯源 | 免费 |
search_property_events | event_type?, state?, within_days? | 带来源溯源的注明日期事件 | 免费 |
search_bank_cre_exposure | state?, name?, CRE-to-equity range?, above_guidance?, min_assets_usd?, min_noncurrent_pct?, sort? | 按 CRE 集中度筛选 FDIC 承保银行,并提供指导值筛选和 UBPR 百分位排名 | 免费 |
search_subsidised_housing | state?, city?, program?, min_waiting_months?, occupancy range?, min_units? | HUD 补贴项目,包含可用单位数、入住率、候补名单月数、租金、收入和 HUD 支出,数据为单次年度采集 | 免费 |
search_parcels | filters | 按属性搜索地块,而不是按你已知的地址搜索 | 免费 |
what_can_dfx_answer | an objective, in natural language | DFX 是否能提供帮助、应调用哪个工具、参数以及免费示例 | 免费 |
changes_since | an opaque cursor | DFX 自你的游标以来了解到的内容 | 免费 |
debt_maturity_schedule | state, within_days?, limit? | 贷款清单:本金、贷款机构、工具、到期日、担保物业 | 免费 |
dfx_coverage | nothing | 实测覆盖范围、已接入来源、对象类型、已知缺口 | 免费 |
search_family_offices | allocates_to_managers?, asset_class?, city?, class?, co_invested_with?, counterparty_kind?, ... | 家族办公室简明卡片:类别(单一家族、多家族、嵌入式……)及置信度、是否直接投资、记录在案的行业和资产类别、支票规模…… | 免费 |
rank_family_offices | allocates_to_managers?, asset_classes?, backs_independent_sponsors?, capital_max_usd?, capital_min_usd?, check_max_usd?, ... | 针对任何带条件的家族办公室问题的首选工具(行业、支票规模、资本、赞助方、共同投资者、近期事件、地理位置、可联系人员) | 免费 |
get_family_office | dfx_id | 单一家族办公室的完整卡片:概况;分别列出的 AUM / RAUM / 13F 价值及各自的数据截至日期;行为;管理人员及其职位;其观察到的…… | 免费 |
search_family_office_investments | asset_class?, include_candidates?, investment_kind?, limit?, office_dfx_id?, sector?, ... | 观察到家族办公室进行的注明日期投资:标的、行业、资产类别、结构、控股或少数股权、领投或参与、披露金额…… | 免费 |
search_independent_sponsors | city?, include_unverified?, kind?, limit?, min_confidence?, query?, ... | 已验证的独立赞助方公司(逐笔收购低中端市场公司的机构)简明卡片:验证状态、分类、授权摘要…… | 免费 |
get_independent_sponsor | dfx_id | 赞助方图谱中任一实体的完整卡片:赞助方(含其验证状态、与其已观察交易相似的公司数量事实及相关……) | 免费 |
search_sponsor_capital_providers | limit?, making_new_investments?, min_fund_size_usd?, provider_type?, query?, sbic_licensed?, ... | 观察到为独立赞助方提供资本的 SBIC、中 mezzanine 和私募股权基金,以及家族办公室:提供方类型、策略、基金风格、基金规模…… | 免费 |
search_private_companies | city?, limit?, max_participants?, min_opportunity?, min_participants?, naics_prefix?, ... | 美国私人公司,其申报文件(Form 5500 计划历史、最终申报、所有权变更)记录了变化:垂直领域、作为规模代理指标的计划参与者人数、EBIT…… | 免费 |
search_sponsor_deals | limit?, query?, since?, sponsor_dfx_id?, state?, target_dfx_id?, ... | 独立赞助方宣布的收购、资本重组和退出:赞助方、标的、日期、已披露的企业价值区间、结构、各方…… | 免费 |
search_pending_ownership_changes | changed_since?, limit?, query?, state?, tag?, view? | 官方州记录显示,专业护理机构的所有权、控制权或运营方正在变更,且变更尚未生效(肯塔基州、纽约州、罗得岛州……) | 免费 |
search_vc_firms | active_only?, city?, emerging_manager?, limit?, min_investments?, query?, ... | 风投公司简明卡片:自述行业、阶段、地理位置和支票规模,以及 OBSERVED 行为(过去 6 个月和 12 个月的投资、领投次数……) | 免费 |
get_vc_firm | dfx_id | 风投图谱中任一实体的完整卡片:公司(含近期投资、共同投资者和基金)、个人(含归属投资和董事会席位……) | 免费 |
search_vc_investments | alongside_investor_dfx_id?, company_dfx_id?, investor_dfx_id?, investor_type?, lead_only?, limit?, ... | 按投资者列出轮次参与情况:投资者、公司、基金、归属的合伙人(含归属等级)、角色(领投或参与)、新投资或后续投资…… | 免费 |
search_vc_funds | fundraising_state?, lifecycle_state?, limit?, max_vintage?, min_form_d_sold_usd?, min_vintage?, ... | 每个金额都按其自身名称单独列出的基金(目标规模、首次交割、最终交割、宣布规模、Form D 募集和已售金额、ADV 总资产价值)、年份及基本信息…… | 免费 |
search_pe_firms | class?, class_state?, cursor?, limit?, min_transactions_36m?, query?, ... | 私募股权公司(管理公司和顾问)简明卡片:分类器给出的类别及其状态、置信度和依据;规模区间及其证据…… | 免费 |
get_pe_firm | dfx_id | 私募股权公司的完整卡片:身份信息(网站、总部、ADV 申报日期)、分类依据、规模区间的定义和证据、分类…… | 免费 |
search_pe_funds | adv_fund_type?, cursor?, lifecycle_state?, limit?, max_vintage?, min_adv_gav_usd?, ... | 私募股权图谱中的基金,每个金额都按其自身名称及依据列出:目标规模、首次交割、最终交割、宣布规模、Form D 募集金额和…… | 免费 |
get_pe_fund | dfx_id | 单只基金:管理人、年份及依据;各金额分别列出并注明依据(adv_gross_asset_value 是申报的总资产,并非基金规模或可投资现金);…… | 免费 |
search_pe_transactions | add_on_only?, control_status?, firm_dfx_id?, limit?, platform_dfx_id?, query?, ... | 私募股权图谱中的收购、追加收购、资本重组、业务剥离、二级市场出售和退出:类型、状态、宣布和完成日期、标的…… | 免费 |
search_pe_platforms | limit?, min_add_ons_24m?, owner_dfx_id?, query?, sector?, sort?, ... | 充当平台的公司(赞助方的平台投资,或进行过追加收购的公司):行业、追加收购次数(总计及过去 24 个月)和…… | 免费 |
find_pe_buyers_for_company | dfx_id, limit? | 针对一家公司的私募股权匹配器计算出的 buyer_for_company 匹配结果(公司 ID 为 dfx:pe:、dfx:isi: 或 dfx:vc:):每家公司的匹配器理由…… | 免费 |
find_pe_companies_for_buyer | dfx_id, limit? | 针对一家私募股权公司的 company_for_buyer 计算匹配结果(dfx:pe: ID):每家公司(位于私募股权、赞助方或风投图谱中,附其 dfx ID)及…… | 免费 |
find_pe_addons_for_platform | dfx_id, limit? | 针对一个平台计算出的 addon_for_platform 匹配结果(来自 search_pe_platforms 的 dfx:pe: 公司 ID):每个候选公司及匹配器给出的理由、阻碍因素…… | 免费 |
search_ria | city?, cursor?, entity_type?, firm_class?, firm_crd?, fund_type?, ... | 注册投资顾问(Form ADV:RAUM、按类型划分的客户数、员工人数、IAPD 顾问、私募基金、INDEPENDENT_WEALTH 或 WIREHOUSE 等类别)、监管…… | 免费 |
get_ria_firm | dfx_id | 一家注册投资顾问的完整卡片,以及人员流动情况(90 天、12 个月和 36 个月内的入职、离职、净变动和比率)、年度间增长…… | 免费 |
get_ria_advisor | dfx_id | 一位在 IAPD 注册的顾问:姓名、当前公司及类别和任职时间、按时间顺序列出的带日期注册任职记录(公司、开始、结束、当前)、曾…… | 免费 |
resolve_ria_advisor | crd?, firm?, firm_crd?, limit?, name, state? | 按姓名和公司(名称或 CRD)或个人 CRD 匹配顾问,返回一张个人卡片 | 免费 |
search_ria_funds | cursor?, firm_dfx_id?, form_d_file_number?, fund_type?, include_custodians?, limit?, ... | 来自 Form ADV Schedule D 7.B.(1) 的私募基金:基金名称、SEC 基金 ID(805-…)、类型、总资产价值及其截至日期(申报的总资产,并非基金规模……) | 免费 |
search_ria_advisor_moves | advisor_dfx_id?, cursor?, from_dfx_id?, include_bulk?, include_departures?, limit?, ... | 离开一家公司的顾问及在另一家公司注册的情况:个人、原公司和新公司及其类别、注册结束和开始日期、间隔时间、变动类型…… | 免费 |
search_ria_teams | cursor?, from_dfx_id?, include_members?, kind?, limit?, min_members?, ... | 团队:在 14 天连续区间内从同一分支州的同一家公司跳槽到同一家公司的顾问群组,包含成员人数、日期、跨度、原…… | 免费 |
search_ria_ma | acquirer?, acquirer_crd?, cursor?, firm_dfx_id?, kind?, limit?, ... | 来自三个事实来源的 RIA 并购,各来源均有标注:收购方在 Form ADV Item 4 宣誓申报的继任关系(succession);顾问全部转注册到其他公司的…… | 免费 |
search_ria_changes | cursor?, dfx_id?, event_type?, limit?, signal_family?, since, ... | 按 OBSERVATION 时间排列的 RIA 事件清单:顾问公司变更和离职、团队跳槽和吸纳、继任、RAUM 和员工人数变动、控制权…… | 免费 |
get_ria_trends | firm_class?, limit?, min_advisors?, min_raum_usd?, sort?, state?, ... | RIA 数据领域聚合数据衍生出的三个视图:state_stats(SEC 注册公司、财富管理公司、RAUM、私募基金、顾问、入职、离职和新公司……) | 免费 |
get_ria_capital_links | dfx_id, limit? | 针对一家 RIA 公司(或一只私募基金):通过共享标识符写入的、指向私募股权、风投、家族办公室和赞助方图谱的所有链接,并附依据…… | 免费 |
get_ria_practice | dfx_id | 根据申报内容呈现一家业务机构:申报的 Form ADV 字段(RAUM、酌情管理、账户、员工、顾问、客户及按类型划分的 RAUM、私募基金……) | 免费 |
search_ria_practices | archetype?, bank_owned?, cursor?, custody?, financial_planning?, firm_class?, ... | 按业务层筛选 SEC 注册顾问:按 archetype(HNW_WEALTH_MANAGER、UHNW_PRIVATE_WEALTH、MASS_AFFLUENT_RIA、INSTITUTIONAL_ASSET_MANAGER、R……) | 免费 |
search_ria_anomalies | anomaly_type?, cursor?, family?, firm_class?, firm_crd?, limit?, ... | 相较同行群体显著异常的申报值及申报间变化(按 RAUM 区间、30 名或以上顾问进行细分),每项均含指标、当前值和…… | 免费 |
search_ria_offices | cursor?, firm_class?, firm_crd?, limit?, min_advisors?, sort?, ... | 按离职、入职、净流动、离职率、团队跳槽流入或流出、新组建的独立团队(在 t 时点的顾问……)排名的办事处(公司及 IAPD 分支机构所在城市) | 免费 |
search_ria_move_indicators | advisor_dfx_id?, cursor?, firm?, firm_dfx_id?, kind?, limit?, ... | DFX 按顾问记录的已观察到的跳槽前迹象:之前一起跳槽的队友或团队资深成员已离开公司(附其去向),第五位或…… | 免费 |
search_ria_outside_business | category?, category_group?, current_only?, cursor?, firm_crd?, investment_related?, ... | 顾问在本人 Form U4 披露中申报的外部业务条目,经审核提取:公司、业务内容及依据、顾问角色(所有者……) | 免费 |
get_ria_outside_business | company_id?, dfx_id? | 针对一位顾问(dfx:ria: ID 或个人 CRD):所有经审核的外部业务条目、测量维度(创业、广度、社区、网络、r……) | 免费 |
search_private_credit | bdc_advisers_only?, class?, cursor?, entity_type?, held_only?, industry?, ... | 私募市场背后的资本结构图谱,根据每家 BDC 自 2022 年以来每季度的投资明细表构建 | 免费 |
get_credit_provider | detail?, dfx_id | 信贷管理人:类别及其依据;其所顾问的 BDC(取自各 BDC 自身的 10-K)及最新投资明细表;其在 Form ADV 上申报的信贷基金;其赞助方…… | 免费 |
get_bdc_portfolio | as_of?, cursor?, dfx_id, include_equity?, limit?, sort? | BDC 在某个季度末列出的每个持仓(默认最新季度,除非指定 as_of),均采用申报方自身的数据:借款人、工具、类型、留置权、本金…… | 免费 |
get_borrower_capital_structure | dfx_id | 借款人集团(名称变体及评级)、所有信贷安排(类型、留置权、跨贷款机构持有本金的下限、估值、定价、PIK、到期日及依据……) | 免费 |
get_credit_facility | dfx_id | 一项信贷安排(同一工具类别中的一个借款人集团):以 BDC 部分持仓之和及其依据表示的规模;跨各部分持仓的定价众数和范围;到期日及依据…… | 免费 |
search_credit_maturities | cursor?, from?, lien?, limit?, min_principal_usd?, months?, ... | 仍列于 BDC 投资明细表、其标注或填写的到期日在指定窗口内的债务安排(默认从今天起未来 24 个月),按日期排序:借款人…… | 免费 |
search_sponsor_lender | cursor?, lender_dfx_id?, limit?, min_borrowers?, sort?, sponsor_dfx_id? | 按持有的借款人数量统计的赞助方 × 贷款机构配对(贷款机构为 BDC 背后的顾问;若未读取顾问信息,则为 BDC):借款人、信贷安排…… | 免费 |
find_lenders_for_financing | band_max_usd?, band_min_usd?, industry, lien?, limit?, since?, ... | 按当前持有的 BDC 投资明细表中可比信贷安排对贷款机构排名:相同留置权、借款人行业包含指定词语(按申报方原文,如 hea……) | 免费 |
search_private_credit_changes | by?, cursor?, dfx_id?, event_type?, include_routine?, limit?, ... | 按生效日期(变更可见的季度末)或首次发现时间列出的带日期变更:任何投资明细表上的新借款人、加入或退出信贷安排的贷款机构…… | 免费 |
search_allocators | allocator_class?, consultant_class?, cursor?, entity_type?, include_components?, limit?, ... | 资本所有者图谱:公共养老金(包括所有 Census 单位)、企业和 Taft-Hartley 固定收益计划(Form 5500)、捐赠基金和基金会(IRS)、州级资金池及…… | 免费 |
get_allocator | dfx_id | 资金配置方卡片:申报资产及依据、资金到位状态、最新配置政策条目(目标、区间、按该主体申报的实际值……) | 免费 |
search_allocator_commitments | allocator_dfx_id?, bucket?, consultant_dfx_id?, cursor?, first_time_only?, fund_dfx_id?, ... | 每行对应计划自身披露的一条记录:资金配置方、申报中的基金名称、解析到私募股权或风投图谱的管理人和基金(如解析器成功匹配)、类别…… | 免费 |
search_re_fund_managers | crd?, cursor?, first_vehicle_year_from?, include_former?, invested_state?, latest_vintage_from?, ... | 在 Form ADV Schedule D 7.B.(1) 上宣誓申报房地产基金载体的顾问:每位管理人对应一个 CRD,附注册和最新申报、监管资产…… | 免费 |
get_re_fund_manager | dfx_id | 管理人卡片、规模最大的十个载体及按年份划分的完整基金家族、经验证的物业关联及其依据和置信度…… | 免费 |
search_re_fund_vehicles | cursor?, exclude_feeders?, first_reported_from?, first_reported_year?, include_dropped?, lifecycle_state?, ... | 按 SEC 基金 ID(805-…)宣誓申报为房地产基金的载体:基金及其家族和序列、母基金、馈送基金或母基金中的母基金、最新申报的总资产价值…… | 免费 |
get_re_fund_vehicle | dfx_id | 载体卡片,逐年列出申报的历史记录(总资产价值、所有者、最低投资额、该年度申报的基金类型和名称),其…… | 免费 |
get_re_fund_trends | limit?, min_gav_usd?, view? | 从宣誓申报数据清单衍生的序列,每项旁均列出样本范围、推导方式和注意事项:按年份列出的首次申报载体(附申报管理人……) | 免费 |
search_re_fund_loans | cursor?, group_by?, instrument_kind?, lender?, limit?, manager_dfx_id?, ... | 通过经验证的物业关联绑定到房地产基金管理人的贷款:记录在案的贷款机构(若持有票据的是 CMBS 信托,则会特别标注……) | 免费 |
search_re_fund_lenders | cursor?, lender?, limit?, manager_dfx_id?, min_loans?, property_type?, ... | 根据管理人经验证持仓中的贷款生成的管理人 × 贷款机构配对:贷款机构集团、贷款、本金、物业、物业类型和州、首次及…… | 免费 |
search_re_fund_lps | allocator?, allocator_dfx_id?, allocator_state?, commitment_type?, cursor?, group_by?, ... | 解析到房地产基金管理人及载体的公共 LP 数据清单:计划(资金配置方 ID)、管理人和载体及各自的解析依据、基金类别、首次…… | 免费 |
get_capital_paths | dfx_id, include_former?, kind?, limit? | 通过一家机构发布的资本流动路径:哪些资金配置方通过哪些基金支持该管理人,哪些贷款机构为该赞助方的借款人提供融资…… | 免费 |
get_commitments | dfx_id, include_holdings?, limit? | 一次调用即可获取任何被引用 ID 的承诺数据清单:资金配置方数据清单(公共计划自身披露的信息,包含计划、申报中的基金、管理人……) | 免费 |
get_borrower_facilities | as_of?, detail?, dfx_id, group_by?, held_only?, limit? | 借款人集团在 BDC 数据清单上的所有信贷安排(类型、留置权、跨贷款机构持有本金的下限、成本估值、定价、PIK、到期日及其依据……) | 免费 |
get_sponsor_lenders | dfx_id, limit?, min_borrowers?, sort? | 按持有的借款人数量统计的赞助方 × 贷款机构配对:借款人、信贷安排、持有本金、首个和最近季度、过去四个季度的新借款人…… | 免费 |
search_capital_changes | dfx_id?, event_type?, graph, include_seeded?, limit?, since | 三个资本图谱按首次发现时间排列的变更清单:DFX 首次看到每条记录的日期,这是轮询程序唯一可信的排序方式 | 免费 |
search_entities | active_only?, asset_class?, city?, cursor?, domain?, entity_type?, ... | 一次搜索家族办公室、独立赞助方及其资本提供方、私人公司、风投公司、私募股权公司和基金,以及房地产…… | 免费 |
resolve_name | domain?, entity_type?, limit?, name, prefer_domain? | 从 Data Factory 收录所有已发布名称和别名(曾用名、商业名称、法定名称……)的索引中,将公司、基金、个人或公司名称解析为规范 dfx ID | |
get_entity | detail?, dfx_id, event_limit?, evidence_limit?, include?, relationship_limit? | 针对任意 DFX ID:完整卡片、附来源和日期的已发布关系、近期事件、证据条目(每项事实对应的观察记录)、跨图谱…… | 免费 |
search_people | cross_graph_only?, current_only?, domain?, investment_responsibility?, limit?, organization?, ... | 来自公开来源的投资专业人士、负责人和家族办公室员工,包含姓名、头衔、角色、资历、投资职责、组织和任职时间…… | 免费 |
search_relationships | current_only?, detail?, dfx_id, limit?, rel_type? | 涉及一个实体的所有已发布关系(EMPLOYS、PRINCIPAL_OF、INVESTED_IN、CO_INVESTED_WITH、MANAGES、OWNS、BOARD_MEMBER_OF、VEHICLE_OF 等),每项均…… | 免费 |
relationship_path | from_dfx_id, max_hops?, to_dfx_id | 跨所有图谱连接两个 DFX ID 的有证据支持路径:每一跳都是带来源的已发布关系,或通过共享 CRD/C……建立的 SAME_AS 身份链接 | 免费 |
search_events | dfx_id?, domain?, event_type?, exclude_routine?, limit?, min_significance?, ... | 家族办公室、赞助方、风投、私募股权和房地产领域的带日期事件:已宣布的投资、成立的载体、Form D 和 ADV 申报、人员入职…… | 免费 |
verify | as_of?, claim?, object?, object_dfx_id?, predicate?, subject?, ... | 针对某项主张返回 SUPPORTED、PARTIALLY_SUPPORTED、CONTRADICTED 或 UNKNOWN,并附观察记录 | 免费 |
find_capital_for_opportunity | asset_class?, check_size_usd?, control?, deal_size_usd?, dfx_id?, investor_types?, ... | 为公司(dfx_id)或描述的机会(行业、州、交易规模、阶段、控制权)寻找投资者:有已观察收购记录的已验证独立赞助方…… | 免费 |
find_opportunities_for_capital | dfx_id, limit? | 针对家族办公室、赞助方、资本提供方或风投公司:DFX 已知且符合其已证实行为的机会,即图谱计算得出的匹配结果…… | 免费 |
explain_match | dfx_id_a, dfx_id_b | 针对投资者和机会(顺序任意):匹配原因、阻碍因素、支持性观察记录、可比历史(投资者带日期的投资……) | 免费 |
why_now | dfx_id, within_days? | 有证据支持的实体近期重要性原因:近期申报、成立的载体、投资部署、人员变动、募资、交接信号、贷款到期等…… | 免费 |
who_should_care | dfx_id?, event_id?, limit? | 给定实体或事件 ID:哪些人可能关注以及原因 | 免费 |
search_documents | dfx_id?, limit?, query | 对 DFX 文档索引进行全文搜索:图谱已指向的文档中的原文段落(SEC 申报文件和 BDC 投资明细表、公开……) | 免费 |
find_real_estate_lenders | band_max_usd?, band_min_usd?, city?, limit?, property_type, since?, ... | 按发起的商业房地产贷款为贷款机构排名,数据来自 CMBS 贷款级申报(SEC ABS-EE):相同物业类型、相关州和城市中的贷款…… | 免费 |
search_cmbs_loans | cursor?, distress?, dscr_max?, limit?, loan_keys?, maturity_from?, ... | ACTIVE CMBS 数据清单中的贷款(SEC ABS-EE,每笔贷款读取最新月度数据,读取时间不早于最新期间 100 天),包含服务商自身字段:付款…… | 免费 |
search_signals | affected_dfx_id?, cursor?, domain?, family?, include_audience?, limit?, ... | 网站据以排名的受治理信号层(当前可采取行动、仅公开或仅可出售):每张卡片列出类别、附 dfx ID 的主体、发生的变化、变化内容…… | 免费 |
search_opportunities | condition_kind?, cursor?, family?, include_held?, intelligence_class?, limit?, ... | 机会摘要:状况(信贷恶化、再融资窗口、贷款机构集团变更、资本筹集、顾问变动、服务困境……)、…… | 免费 |
who_to_contact | dfx_id?, limit?, opportunity_id?, organization?, prefer_domain?, purpose? | 针对某个组织(dfx_id,或通过 organization 提供名称并经身份层解析,以读取该机构所在的所有图谱)或某个机会…… | 免费 |
search_forward_opportunities | contact?, cursor?, entity_dfx_id?, evidence?, limit?, max_economic?, ... | DFX 中的前瞻机会:一个实体,以及测量模式指向的事件(借款人进入非应计状态、养老金计划再次投资某位管理人的基金、……) | 免费 |
get_forward_signal_ledger | cursor?, limit?, signal_key?, status?, vertical? | 支撑每项前瞻性判断的数据清单:针对每种模式,列出其定义、样本范围、测试期、基础发生率、出现该模式的实体中的发生率、提升幅度及其相互…… | 免费 |
search_cmbs_resolutions | cursor?, limit?, min_loss_usd?, property_type?, resolution?, since?, ... | 服务商报告已进行止赎、转为 REO 或以契约代物清偿的所有 conduit CMBS 贷款(SEC ABS-EE),并列明最终结果:已解决或仍待处理、SEC 贷款…… | 免费 |
get_company_coverage | naics, state? | Census Bureau 对一个 NAICS 代码(2 至 6 位数字)和一个州内企业数量的统计(Statistics of US Businesses 2022,包含所有企业及员工人数达到 20 人的企业)…… | 免费 |
search_13f_sector_holders | family_capital_only?, limit?, period?, sector?, sic?, state? | 根据最新 Form 13……持有某行业公开证券的家族办公室(当 family_capital_only 为 false 时,也包括家族办公室图谱中的所有 13F 申报者) | 免费 |
search_bdc_language_change | changed_only?, filed_from?, limit?, section?, term | 针对某个词(软件、关税、AI、医疗保健、能源、消费、办公、加密货币或任意词),列出最新 10-K 或 10-Q 提及该词的所有活跃 BDC,并比较已提交…… | 免费 |
rank_sponsor_capital | deal_company?, deal_sponsor?, ebitda_max_usd?, ebitda_min_usd?, group?, limit?, ... | 对已宣布的独立赞助方交易中提及的资本参与方进行汇总 | 免费 |
get_sponsor_portfolio | dfx_id?, limit?, name?, status? | DFX 为一家私募股权公司或独立赞助方公司记录的所有投资组合持仓(当前和已退出):公司、州、列出的行业、基金、平台或追加收购…… | 免费 |
rank_service_providers | active_since?, cursor?, family?, limit?, min_deals?, query?, ... | 对已宣布的独立赞助方交易中的服务提供商进行排名,覆盖整个图谱:律师事务所(法律类)、投资银行和并购顾问(投资……) | 免费 |
get_service_provider | dfx_id?, name? | 根据独立赞助方图谱识别的律师事务所、银行、会计或尽调公司:交易数量和角色构成、服务过的赞助方排名(附交易数量……) | 免费 |
search_service_provider_sponsors | cursor?, family?, limit?, min_deals?, provider?, sponsor? | 已宣布的独立赞助方交易中的服务提供商和赞助方配对 | 免费 |
search_borrower_sponsors | borrower?, current_only?, cursor?, group?, limit?, non_accrual_since?, ... | 借款人到赞助方的关联链:BDC 借款人通过分级身份桥接与其公司记录关联,再关联到投资过的私募股权公司(基金……) | 免费 |
search_credit_stress | bdc_dfx_id?, event_types?, group?, limit?, period?, since?, ... | BDC 数据清单上的信贷压力,统计每类事件:NON_ACCRUAL_PLACED 和 RETURNED_TO_ACCRUAL(来自各 BDC 投资明细表脚注)、PIK_ADD…… | 免费 |
who_should_provider_call | limit?, provider?, role_family?, state?, trigger? | 独立赞助方电话联系名单(规则 isi-pcall-1,XV1 2026-10-02):按角色类别、触发因素和赞助方逐行列出,并覆盖经普查验证的赞助方交易 | 免费 |
search_isi_opportunities | limit?, opportunity_type?, persona?, since?, state?, status? | 共享机会协议中的 ISI 机会(规则 isi-opp-1):deal_provider_gap(近期赞助方交易中未记录的法律顾问、银行或会计师)…… | 免费 |
find_vc_investors | active_only?, amount_usd?, city?, geography?, limit?, sector?, ... | 为正在融资的公司寻找风投公司,将硬性条件(地理位置、行业、阶段、amount_usd、active_only)与排名信号(已观察……)分开列出 | 免费 |
search_vc_coinvestors | dfx_id?, firm?, limit?, since? | 根据双方共同参与的轮次,查找最常与指定风投公司共同投资的公司:共同投资组合公司、共同参与的轮次、最早和最近…… | 免费 |
search_vc_new_funds | all_vehicles?, city?, emerging_only?, lifecycle_state?, limit?, max_fund_number?, ... | 自某日期以来成立的风投载体(首次 Form D 销售或首次出现在 Form ADV 上),或有开放 Form D 募集的载体(raising_now),每位管理人一行:基金…… | 免费 |
search_vc_emerging_managers | city?, launched_since?, limit?, new_adviser_since?, sector?, state? | 新兴管理人评分达到 0.5 或以上的风投管理人(基金数量少、首个基金年份较近、申报资产较少),附评分、行业证据、基金…… | 免费 |
search_vc_lp_commitments | emerging_only?, group_by?, limit?, lp?, max_fund_number?, organization_dfx_id?, ... | 来自 LP 自身公开报告(公共养老金、捐赠基金)的已披露风投基金 LP 承诺:LP、基金、管理人、金额、日期、基金编号 | 免费 |
search_vc_financings | city?, debt_only?, include_out_of_scope?, kind?, limit?, order_by?, ... | 自指定日期以来融资的风投图谱公司,每笔融资均标注为已宣布轮次(新闻稿:轮次类型、阶段、已披露金额)或 SEC…… | 免费 |
search_vc_next_funds | limit?, max_sequence?, min_sequence?, sector?, since?, within_days? | 下一只基金:已知风投管理人的下一只编号基金(例如 Fund II 后的 Fund III),按首次 Form D 日期排列,并附前一只基金、两者间隔年数及…… | 免费 |
search_vc_service_opportunities | limit?, min_amount_usd?, new_only?, provider_type?, since?, trigger_family?, ... | 将风投图谱中已申报或已宣布的触发因素映射到因此产生业务的服务提供商(管理、审计、法律、配售、银行、贷款、保险……) | 免费 |
search_vc_exits | dated_only?, investor_dfx_id?, kinds?, limit?, since?, within_days? | 风投支持公司的收购、IPO 和上市,并附报告该事件的投资者和日期依据:已发生(有日期来源)或已观察到(参见……) | 免费 |
search_vc_repeat_founders | city?, geography?, include_out_of_scope?, limit?, prior_venture_backed_only?, sector?, ... | 在两家或以上运营公司 Form D 申报中列为高管的人士,按新公司列出,并附其首次 Form D 日期、个人…… | 免费 |
search_vc_raise_candidates | city?, geography?, limit?, max_months_since_financing?, min_months_since_financing?, sector?, ... | 按规则列出的可能再次融资的风投支持公司:最后一笔有日期的融资发生在 12 至 36 个月前,之后没有融资记录,没有退出记录,仍列于…… | 免费 |
search_vc_provider_calls | city?, geography?, limit?, min_size_usd?, role?, since?, ... | 为基金管理人、审计师、托管人或配售代理提供的电话联系名单:没有该角色服务商记录的新基金(新基金 Form D)、下一只编号…… | 免费 |
search_vc_opportunities | city?, family?, geography?, limit?, persona?, provider_gap?, ... | 风投机会对象:带日期的信号(基金成立、基金生命周期、公司资本、人员变动、关系变化),每项均包含为何是当下、发生了什么…… | 免费 |
get_re_debt_exposure | distress?, group?, limit?, min_balance?, name?, property_type?, ... | 按持有方汇总 CMBS 债务(SEC ABS-EE 数据清单中每笔贷款的最新读数):group=sponsor(招股说明书附表中的赞助方或剥离担保人,按名……) | 免费 |
search_re_lps_by_manager | limit?, manager?, min_funds? | 根据已发布 LP 承诺生成的资金配置方 × 管理人配对:不同基金数量、承诺总额、首次和最近承诺、后续投资,以及带来源的最新基金 | 免费 |
get_re_org_chain | limit?, name | 按公司名称家族查找:其房地产基金管理人、按生命周期划分的载体、附依据和置信度的已发布持仓、基金贷款及贷款机构集团、CM…… | 免费 |
get_re_property_chain | limit?, owner_ids?, property?, property_dfx_id? | 某栋建筑在纽约市登记的抵押、清偿和转让记录(当事方按申报内容列出);若提供 owner_ids,还会解析登记所有者背后的赞助方;…… | 免费 |
watch_create | baseline?, conditions?, include_failing?, include_historical?, include_unmeasured?, maturity_within_months?, ... | 为此账户保存一项私募信贷调查:研究问题和/或借款人、某位赞助方的借款人或某贷款机构的账簿,以及需要监测的变化(……) | 账户密钥 |
watch_list | nothing | 此账户的监测项,包含状态、最新检查点、已用读取次数和费用 | 账户密钥 |
watch_changes | checkpoint?, include_historical?, watch_id | 自检查点以来的重大变化:每项均附申报文件、申报日期、与贷款机构自身记录的核对结果、NEW_EVENT 或 NEWLY_OBSERVED_HISTORICAL,以及重大…… | 账户密钥 |
watch_reevaluate | checkpoint?, watch_id | 根据检查点以来的变化重新测试记录的结论(到期日、估值、贷款机构、履约情况),并对已保存调查中的主张进行差异比较…… | 账户密钥 |
watch_cancel | watch_id | 取消监测项:不再发送通知,释放配额名额,先前的通知仍可读取 | 账户密钥 |
如果不知道该查询什么,请从 what_can_dfx_answer 开始。 如果答案是否定的,它会明确说明,并记录你的问题,因此 DFX 无法回答的问题会影响后续的开发方向。 |
超越房地产:家族办公室、独立发起人、风险投资
同一套连接方式可跨另外三个 DFX 图谱提供答案,采用一套 ID 方案(dfx:fo:、dfx:isi:、dfx:vc:,以及上文的房地产 ID)、一套响应约定,并且仅通过共享的 CRD、CIK 或 EIN 实现跨图谱身份关联。其他图谱上名称相同的实体只会作为候选项返回,绝不会合并。
家族办公室。 图谱中有 2,575 家办公室(667 家候选办公室、161 家已确认的多家族办公室、341 家可能的单一家族办公室、140 家外包办公室)、4,238 家基金会、748 家持有 13F 仓位的办公室、424 家观察到直接投资的办公室。候选项只是名称,而非类别;AUM、RAUM 和 13F 价值是三个独立数字,绝不会相互替代。
独立发起人。 有 4,206 位发起人、10,773 家资本提供方、97,310 家有劳工部计划申报历史的私营公司,其中 17,081 家带有过渡信号;有 317,710 条已计算的公司与发起人匹配记录,附有原因和阻碍因素;有 2,476 笔已宣布的交易。计划申报信号滞后一年。
风险投资。 有 78,298 只基金,每只基金的金额均单独保留(其中 55,486 只已提交 Form D 销售申报)、363,076 位人士、156,426 家公司和 163,661 轮融资。一轮融资绝不等同于一笔投资。
上述所有领域: search_entities、get_entity(通过一个 ID 获取所有信息:卡片、关系、事件、证据、跨图谱链接)、search_people、search_relationships、relationship_path(说明 X 如何与 Y 建立联系,每一跳都是有证据支持的边)、search_events、verify(SUPPORTED、PARTIALLY_SUPPORTED、CONTRADICTED 或 UNKNOWN,并附带观察结果),以及经济类工具 find_capital_for_opportunity、find_opportunities_for_capital、explain_match(提供原因和阻碍因素,绝不只给出一个分数)、why_now 和 who_should_care。
所有图谱中的联系点都不会通过 MCP 提供。调用 what_can_dfx_answer,并将 domain 设为 family_office、independent_sponsor、venture_capital 或 real_estate 中的任意一个,即可查看该领域的实体类型、事件类别、权限、新鲜度和局限性。
其中究竟包含什么(房地产)
这里有两个几乎没有重叠的群体;将它们混为一谈是误读此服务最常见的原因。
| 对象 | 含义 | 可解析数量 |
|---|---|---|
parcel | 马萨诸塞州。由市政评估和登记构成的图层,包含评估价值、土地用途和登记销售记录。 | 2,479,346 |
property | 全国范围。联邦多户住宅项目:HUD、LIHTC 和 FHA。 | 108,359 |
organization | 所有者、管理者、贷款方和服务商。 | 未单独统计 |
一个地址可能返回其中一类,也可能两类都返回。
已记录的销售
哥伦比亚特区、马萨诸塞州、纽约州和威斯康星州:95,616 份文书,关联 118,821 处物业。
| Tape | 地理范围 | 数据粒度 | 买方 | 卖方 | 重复销售 |
|---|---|---|---|---|---|
municipal recorder extract | 纽约市,五个行政区 | 已记录文书,按经济交易分组 | 是 | 是 | 是 |
statewide assessor roster | 马萨诸塞州,全州 | 评估名册:每处地块一条销售日期和价格记录 | 是 | 否 | 否 |
-
municipal recorder extract:对价不低于 $10,000,000 的契据。这是按 VALUE 刻意筛选,而非按日期筛选:按日期筛选会使重复销售配对中较早的一笔脱离记录。较小金额的纽约州销售不在本批数据中,并非未发生在该市。 -
municipal recorder extract:同一双方在同一天签署的十四份契据合并为一笔交易,并保留十四个文书 ID;一份涉及 318 处物业的契据则作为一笔交易关联至 318 处物业。对价按每份文书记录一次,绝不会拆分到其涉及的物业上。事件标题的任何一方都不会出现自然人姓名。 -
statewide assessor roster:评估名册只记录最后一笔销售,因此无论数据量多大,都无法从中推导重复销售配对和持有期。契据会在其涉及的每处地块上重复记录全部对价,因此allocated_consideration与consideration分开保存;allocation_basis则说明何时采用了我们自己的拆分方式。
事件覆盖范围:数据统计
179,298 条可发布事件,涵盖 25 种类型,由 30 个来源写入;已发布的允许名单包含 29 个来源。
| 事件类型 | 州数 | 已发布 |
|---|---|---|
PROPERTY_SOLD | 4 | 49,391 |
TAX_LIEN_LISTED | 1 | 29,368 |
PERMIT_ISSUED | 3 | 20,988 |
DEED_RECORDED | 1 | 15,170 |
OWNERSHIP_CHANGED | 1 | 15,061 |
COMPLIANCE_PERIOD_ENDING | 56 | 11,956 |
SUBSIDY_CONTRACT_EXPIRING | 54 | 4,721 |
LEASE_EXPIRING | 56 | 4,206 |
FORECLOSURE_FILED | 1 | 4,054 |
CERTIFICATE_OF_OCCUPANCY | 3 | 3,855 |
PORTFOLIO_EXPANDED | 53 | 3,528 |
VACANT_FORECLOSURE_REGISTERED | 0 | 3,500 |
LOAN_MATURITY_SCHEDULED | 52 | 3,298 |
PORTFOLIO_CONTRACTED | 54 | 3,181 |
DISTRESS_FLAG_RAISED | 26 | 3,043 |
DEMOLITION_FILED | 3 | 2,457 |
USE_CONVERSION_PERMITTED | 1 | 926 |
ZONING_EVENT | 1 | 276 |
LOAN_MATURED | 25 | 142 |
FORECLOSURE_EVENT | 21 | 123 |
LOAN_MODIFIED | 5 | 16 |
LOAN_STATUS_CHANGED | 0 | 14 |
PERMIT_STATUS_CHANGED | 0 | 13 |
LOAN_ASSIGNED | 0 | 7 |
BANKRUPTCY_EVENT | 4 | 4 |
ZONING_EVENT 仅涉及哥伦比亚特区。USE_CONVERSION_PERMITTED 仅涉及马萨诸塞州。DEED_RECORDED、OWNERSHIP_CHANGED、TAX_LIEN_LISTED 仅涉及纽约州。FORECLOSURE_FILED 仅涉及宾夕法尼亚州。COMPLIANCE_PERIOD_ENDING、LEASE_EXPIRING、LOAN_MATURITY_SCHEDULED、PORTFOLIO_CONTRACTED、PORTFOLIO_EXPANDED、SUBSIDY_CONTRACT_EXPIRING 为全国范围。多州事件及其覆盖的州数:DISTRESS_FLAG_RAISED(26)、LOAN_MATURED(25)、FORECLOSURE_EVENT(21)、LOAN_MODIFIED(5)、BANKRUPTCY_EVENT(4)、PROPERTY_SOLD(4)、CERTIFICATE_OF_OCCUPANCY(3)、DEMOLITION_FILED(3)、PERMIT_ISSUED(3)。LOAN_ASSIGNED、LOAN_STATUS_CHANGED、PERMIT_STATUS_CHANGED、VACANT_FORECLOSURE_REGISTERED 中的行无法解析到任何州,因此无法通过州筛选找到。
贷款数据集:debt_maturity_schedule
免费,无需密钥。每次调用针对一个美国州和一个未来时间窗口,最多返回 200 笔贷款,每笔贷款一行,按到期日排序:
maturity_date和maturity_basisoriginal_principal_usd、current_principal_usd、interest_rate_pct、origination_date、term_monthsinstrument_type- 贷款方的规范名称,以及已解析时对应的 DFX ID
- 抵押物业:DFX ID、街道地址、城市、州、邮政编码、单元数、物业类型
- 该行的
source_key为什么这些日期值得信赖。 23,870 笔贷款带有到期日,且 23,870 笔中的 23,870 笔都带有maturity_basis = 'confirmed'。 没有一笔是估算得出的、根据贷款期限推断出的,或沿用过时读数的。每个日期都由贷款服务商向 SEC 申报,或由 HUD 记录,随后解析到具体建筑。
search_property_events 返回的是事件:日期、标题、地址。贷款明细表返回的是贷款:本金、贷款方、工具;每笔贷款去重为一行,最多返回 200 行,而不是 50 行,并注明总体数量,让你能分辨答案是完整的还是被截断的。这两个总体的规模不同是有意为之,而且两个数字都是真实的:事件必须归并到一个具体地点,贷款只需完成申报,因此这里可以检索到明细表中的 23,870 笔贷款,而通过事件搜索可以检索到 3,298 个到期事件。
贷款的分布情况。 在 23,870 笔贷款中,有 1,990 笔将在默认的 548 天窗口内到期,而且分布并不均匀。数据截至 2026-10-25:
| 州 | 未来 548 天内到期的贷款 |
|---|---|
| CA | 355 |
| NY | 211 |
| TX | 125 |
| FL | 102 |
| OH | 68 |
| NJ | 62 |
| GA | 60 |
| MI | 59 |
| PA | 56 |
| IL | 52 |
| VA | 44 |
| NV | 42 |
| IN | 40 |
| WA | 38 |
| AZ | 36 |
| NC | 35 |
| CO | 31 |
| LA | 24 |
| MD | 23 |
| MO | 23 |
| SC | 23 |
| AL | 22 |
另外 26 个州在该窗口内各有 1 到 18 笔贷款;蒙大拿州和怀俄明州各有 1 笔。扩大 within_days 的值即可查询更远的到期贷款;每次调用最多返回 200 笔贷款。
这 1,990 笔贷款中,有 255 笔没有唯一的州:一笔贷款若以多栋建筑作为抵押,就没有单一的物业锚点,因此州筛选无法检索到它们。可以通过 get_property_record 检索这些贷款。
明确说明其未涵盖的内容。 以下是服务器通过 dfx_coverage 自行报告的缺口,在此重新列出,方便你了解情况,而不必专门调用它来查找:
-
贷款到期日覆盖范围仅限联邦项目贷款(FHA 保险贷款和机构担保贷款)。契据登记处不对自动化开放,因此这里没有传统融资物业的债务记录。在到期日搜索中找不到某处物业,并不意味着该物业没有债务。
-
LIHTC 合规期由法规规定,且每一期都在 12 月 31 日结束,因此按日分组的计数会呈现 12 月集中到期的现象;这是法规造成的假象,而非市场事件。
-
许可和拆除数据仅覆盖波士顿市。
-
此图谱中的任何预测都从未有过已观测到的结果。这里提供的内容均不含经校准的概率;所有分数都只是排序信号。
-
一个街道地址可能对应多条记录。对 6,114 个此类簇进行统计后发现:2,764 个簇的单元数量一致,很可能是由多个项目登记的同一资产;3,350 个簇报告的单元数量不同,很可能确实是同一地址上的不同建筑,例如分散式开发项目。DFX 没有合并其中任何记录,
resolve()会指出你遇到的是哪种情况,而不会替你做出选择。 -
物业和地块属于彼此独立、几乎没有重叠的总体:大约各有 100,000 个对象,其中只有 661 对是干净的一对一匹配。一个地址可能解析到其中一种、另一种或两者,并且它们会作为不同类型的对象分别返回,而不是合并在一起。
-
物业记录并非每栋建筑一行。已发布的 101,991 条物业记录涵盖 94,859 个不同的标准化地址,因此基于这些记录计算总数会高估约 8%。245 Park Avenue 是一座塔楼,却有 13 条记录,因为 13 个证券化信托分别报告了它。每一行单独来看都是真实的,这正是这种偏差无法从单行中看出的原因。每条记录都包含 address_group_size,便于你查看:1 表示唯一记录,大于 1 时,汇总任何数据前都应先按地址去重。DFX 没有合并这些记录,因为这类群组中有数千组的单元数量各不相同,而且它们确实是同一地址上的不同建筑,而非同一栋建筑被重复记录。
-
成交记录带来自两个粒度不同的数据源,而这种差异决定了它们能回答哪些问题。MASSACHUSETTS 是评估师名册:覆盖全州,每个地块一笔成交,列出买方但从不列出卖方,因此无论数据量多大,都无法从中推导重复交易配对和持有期限,继续摄取该数据也不会改变这一点。NEW YORK 是登记处摘录:覆盖五个行政区,列出双方当事人,并记录每份文书的日期,因此可以推导重复交易和持有期限,但仅限金额达到或超过 $10,000,000 的契据。两者都不是全国成交记录,DFX 也没有全国成交记录。
连接
任何支持 Streamable HTTP 的 MCP 客户端都可以使用。匿名读取无需凭据。先使用核心配置;如果你想按名称使用房地产工具,也请添加完整配置。
{
"mcpServers": {
"dfx": {
"type": "http",
"url": "https://exchange-production-9123.up.railway.app/mcp/core?c=gh-repo"
},
"dfx-full": {
"type": "http",
"url": "https://exchange-production-9123.up.railway.app/mcp?c=gh-repo"
}
}
}
Claude Code:
claude mcp add --transport http dfx 'https://exchange-production-9123.up.railway.app/mcp/core?c=gh-repo'
claude mcp add --transport http dfx-full 'https://exchange-production-9123.up.railway.app/mcp?c=gh-repo'
如果成员使用的客户端无法发送标头(例如 Claude 自定义连接器、ChatGPT 开发者模式),则改为添加 https://exchange-production-9123.up.railway.app/mcp/core/member,并使用 OAuth 2.1 登录。
我们同时提供当前协议版本和较旧的 initialize 握手,因为大多数已部署的客户端仍会发送后者。
通过代码使用:dfx-intel SDK
面向 Python 和 TypeScript 的客户端,可在核心配置上调用 research、verify 和 resolve_name,且无运行时依赖。默认匿名访问;从 DFX_API_KEY 读取成员密钥。
pip install dfx-intel
npm install dfx-intel
可运行示例及其最近一次在生产环境中运行的实际输出,均位于 examples/sdk/:匿名研究、打印每条主张背后的引文、错误处理与重试、分页、使用环境变量中的密钥进行成员访问,以及简短的集成教程。关于如何在匿名访问、OAuth 登录和账户密钥之间选择、各客户端支持的功能以及故障排查,请参阅:
docs/CONNECT.md。
如果你的客户端只支持 stdio
有些客户端会启动子进程,并通过其管道使用 JSON-RPC;它们完全无法访问 URL。bridge/dfx_mcp_stdio.py 是为这类客户端准备的完整适配器:单个文件,仅使用标准库,无需密钥,也不保存状态。它会将每条消息转发到上述端点,并将响应写回。
{
"mcpServers": {
"dfx-real-estate": {
"command": "python3",
"args": ["/path/to/us-property-parcel-real-estate-debt/bridge/dfx_mcp_stdio.py"]
}
}
}
请使用绝对路径。MCP 客户端会从自身的工作目录启动命令,而不是从你的工作目录启动,因此相对路径将无法找到该文件。
如果客户端支持,请直接使用 URL。Streamable HTTP 可用时,桥接器只会增加一个进程和一次跳转,并无额外收益。每次收到 tools/list 请求时,它都会从实时服务读取工具列表,因此 DFX 发布新的事件类别后,已安装的副本也不会过时;桥接器本身并不了解事件类别的概念。
该服务擅长回答的问题
- 该州未来 548 天内有哪些商业抵押贷款到期?贷款方是谁?抵押的是哪栋建筑?
- 自我上次提问以来,DFX 有什么新发现?(
changes_since基于游标,并按照 DFX 得知事实的时间排序,而非事实发生的时间。) - 哪些 LIHTC 合规期和 HUD 补贴合同即将到期?分别位于何处?
- 该地块上次以什么价格卖给了谁?对应的登记簿和页码是什么?
- 谁拥有、管理或为这栋建筑提供贷款?
Agent 调用的三种查询
每种查询都是一次工具调用,包括原样的参数,以及生成此页面时返回的结果。粘贴调用即可;数字来自传输内容,不是本页面的数据。
队列在哪里? 俄亥俄州有补贴的项目中,候补名单为 24 个月或以上的项目,按等待时间从长到短排列。
{"tool": "search_subsidised_housing", "arguments": {"state": "OH", "min_waiting_months": 24, "limit": 10}}
返回 matched: 69 和 10 条记录,等待时间最长的为 85 个月。每条记录都包含可用单元数量、入住率、租金、家庭收入,以及 HUD 为每个单元支付的金额;waiting_list_coverage 则说明该州有多少项目报告了候补名单。全国范围内的单次年度快照(共 29,455 个项目),每条记录都注明了这一点。候补名单为 NULL 表示未披露,绝不代表队列为空。
哪些银行已超过 CRE 指导线? 俄亥俄州受 FDIC 保险的银行中,总 CRE 超过权益 300% 的银行,按集中度从高到低排列。
{"tool": "search_bank_cre_exposure", "arguments": {"state": "OH", "above_guidance": true, "limit": 10}}
返回 matched: 8,每家银行都包含其 CRE 贷款组合相对于权益和资产的情况、不良贷款率和核销率,以及其 UBPR 同业和全国百分位排名。全国 4,313 家银行中,有 626 家在此指标上超过该指导线。该指导标准考察的是总风险资本,而这些比率以权益为基准,因此记录标注为“筛查”,而非“结论”。
哪些贷款即将到期,对应哪栋建筑? 德克萨斯州房产上的证券化贷款和 FHA 承保贷款将在一年内到期,按到期时间从近到远排列。
{"tool": "search_property_events", "arguments": {"event_type": "LOAN_MATURITY_SCHEDULED", "state": "TX", "within_days": 365, "limit": 50}}
返回 77 条事件(页面包含 next_cursor),每条记录都包含建筑物的 dfx_id。然后,对于任意一条记录,使用该 ID 调用 get_property_record,即可免费获取贷款本身的信息:当前本金、利率、原始本金、到期时间和依据。debt_maturity_schedule 包含相同的数据集,并以去重后的全州列表形式呈现,同时附有贷款方名称和完整性指标。
每个问题对应一个页面,并标注了实测覆盖范围
- 哪些商业房地产贷款将在指定州和时间范围内到期?:3,298 条 LOAN_MATURITY_SCHEDULED,覆盖 52 个州和地区。
- 哪些 LIHTC 房产即将结束合规期?:11,956 条 COMPLIANCE_PERIOD_ENDING,覆盖 56 个州和地区。
- 哪些 HUD 补贴房产的合同即将到期?:4,721 条 SUBSIDY_CONTRACT_EXPIRING,覆盖 54 个州和地区。
- 哪些商业房地产正陷入困境、遭遇止赎或进入重组?:3,043 条 DISTRESS_FLAG_RAISED、123 条 FORECLOSURE_EVENT、16 条 LOAN_MODIFIED,覆盖 26 个州。
- 这处房产卖了多少钱,归谁所有?:49,391 条 PROPERTY_SOLD,覆盖 4 个州。
- 哪些商业租约即将到期,建筑物由谁使用?:4,206 条 LEASE_EXPIRING,覆盖 56 个州和地区。
它不擅长回答的问题,并会明确说明
- 任何与个人有关的问题。我们特意不提供个人查询。
- 马萨诸塞州以外的评估和地块数据。
- 通过常规融资的房产所涉及的债务。
- 美国境外的任何内容。
Agent 开发者可能关心的设计说明
changes_since按 DFX 获知事实的时间排序,而非事实发生的时间。 3 月签署的契据可能在 8 月才录入。按日期筛选轮询会让你永远看到相同的记录。- 遇到无法识别的
event_type时,会拒绝请求并附上当前支持的词汇表,而不是返回空列表,因为空列表会让人误以为市场不存在。 - 名称是阻断键,不代表身份。
resolve_organization会返回所有候选项,而不是猜测其中一个。 - 每条返回的事实都附有来源信息:来源、证据类别;对于销售记录,还包括登记簿册和页码。
- 覆盖范围是工具,不是脚注。 在认定空结果意味着市场不存在之前,请先调用
dfx_coverage。
这些数据行背后是什么
29 个已注册数据源通过权利筛选,并通过此端点提供服务,分为 5 类:
- 县和市政记录(20):房产数据层:评估、备案文书、许可证、法规执法和税务状态。
- 联邦项目和统计数据(4):联邦项目登记信息和统计序列:谁获得资助、投保、援助或被统计。
- 公共记录(3):不属于上述类别的公共记录。
- 联邦监管机构申报文件(1):企业、基金和计划按联邦监管机构自己的时间安排,必须向其提交的信息。
- 证券化债务报告(1):按月提供已证券化债务的贷款级别和服务机构报告。
每条返回的数据行都会注明其来源、数据生效日期以及 DFX 读取日期。各类别包含哪些具体数据源尚未公布。
条款
examples/ 中的示例代码采用 MIT 许可证。端点提供的数据不属于此许可证范围:这些数据由 DFX 根据自己的处理流程,从联邦和市政公共来源衍生而来,并仅供使用,不得作为数据集再分发。如果你需要更广泛的数据,欢迎咨询;通常都可以提供。
由 DFX Intelligence 运营。开发者参考文档:https://dfxintel.com/ai/real-estate-mcp
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。