Connect an agent to the DFX graph

Nine graphs, built from US public records (SEC, IRS, DOL, Census, state and local filings) and the websites of the organisations themselves, joined by shared identifiers such as CRD, CIK, EIN and SEC fund ids rather than by name. Every entity has a stable id of the form dfx:<graph>:<id> that resolves to a page at /data-factory/entity/<graph>/<id>.

• Real Estate graph re

  Properties, parcels, debt, subsidy, tenancy and the organizations behind them

• Private Equity graph pe

  Sponsors, funds, professionals, portfolio companies, transactions and the capital behind them

• Venture Capital graph vc

  Firms, funds, partners, companies, rounds and who invests alongside whom

• Family Offices graph fo

  Offices, principals, vehicles, foundations, managers and the investments they make directly

• Independent Sponsors graph isi

  Deal-by-deal acquirers, the companies they buy, and the capital providers who finance them

• RIA / Wealth Management graph ria

  Registered advisers, the advisors who work at them, their private funds, owners, affiliates and every advisor move

• Real Estate Funds graph ref

  Real estate fund managers, their vehicles, and the bridge from fund capital to the properties, loans and lenders underneath

• Private Credit graph pc

  Credit providers, BDCs and credit funds, the borrowers they finance, every facility as filed, and the sponsors behind the borrowers

• Allocators graph al

  Who owns the capital: public and corporate pensions, Taft-Hartley plans, endowments, foundations, insurers and pools, their consultants, and the commitments they disclose

How many firms, funds and advisers each graph holds changes daily, so it is not printed here. The live, dated counts with their definitions are on /statistics and the sources with their freshness on /data-factory/sources.

Endpoint

https://exchange-production-9123.up.railway.app/mcp

Transport

Streamable HTTP. POST JSON-RPC to the endpoint; no session id is issued or required.

Authentication

None for the free tier. No key, no OAuth, no signup.

Tools

129 read-only tools when listed on 2026-10-10: universal tools (search_entities, resolve_name, get_entity, search_people, search_relationships, relationship_path, search_events, verify, changes_since) and tools per graph. Every tool is annotated read-only and non-destructive.

Core profile

https://exchange-production-9123.up.railway.app/mcp/core lists 14 of the same tools, about 29,000 characters of schema instead of 300,000. It leads with research: one question about one entity or one workflow (credit by sponsor, advisor movement, allocator to company) answered in one call, under 12 KB, with the resolved entity, an answer built only from cited rows, typed facts, relationships, dated events, what is unknown and what the free tier withheld. Every core tool declares an outputSchema and returns structuredContent. No model runs inside it.

Look before connecting

A plain GET on the endpoint returns the tool schemas without a handshake. Start an agent with what_can_dfx_answer, which maps a question to the graphs and tools that can answer it.

Registry

Listed in the official MCP registry as io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt. That listing and the server’s own serverInfo.name (dfx-real-estate, title DFX Intelligence) still describe the real estate subset where the server began; the endpoint itself serves every graph above.

claude mcp add --transport http dfx https://exchange-production-9123.up.railway.app/mcp

{
  "mcpServers": {
    "dfx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://exchange-production-9123.up.railway.app/mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "dfx": {
      "url": "https://exchange-production-9123.up.railway.app/mcp"
    }
  }
}

{
  "servers": {
    "dfx": {
      "type": "http",
      "url": "https://exchange-production-9123.up.railway.app/mcp"
    }
  }
}

Lists

The first 5 rows are named; the rest are counted, so an agent knows how many exist.

Records

Identity, classification, dates, counts and sources. The first 3 related entries per section are named, the rest counted. Long text fields stop after a lead-in.

People and contacts

Decision-maker names are withheld. Contact values (email, phone, profile links) are never returned on any tier, only their type and count.

Real estate

Property, parcel, ownership and CRE debt tools are not masked. The loan tape returns up to 200 loans per call.

Rate limits

20 calls a minute and 300 an hour per caller. Tools whose name contains search or changes share a tighter 60 an hour. initialize and tools/list are not counted.

When limited

The call returns an error result with state: RATE_LIMITED, a retry_after and charged: false. No call on this endpoint is billed.

Every answer is a JSON envelope serialised as text in content[0].text. It names the capability and version, when it was answered, whether it succeeded, and a state.

curl -s https://exchange-production-9123.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_entities","arguments":{"query":"Pritzker","limit":3}}}'

The shape of the answer. Values are placeholders; field names are from a live call on 2026-10-10.

{
  "jsonrpc": "2.0", "id": 1,
  "result": { "content": [ { "type": "text", "text": "<the JSON below, as a string>" } ] }
}

{
  "dfx": { "capability": "search_entities", "layer": "dfx_intelligence",
           "version": "1.0.0", "answered_at": "2026-10-10T16:17:23Z" },
  "ok": true,
  "state": "OK",
  "query": { "text": "Pritzker", "domains": ["real_estate", "family_office", "..."] },
  "results": [
    {
      "dfx_id": "dfx:fo:<uuid>",
      "domain": "family_office",
      "entity_type": "family_office",
      "name": "<name>",
      "city": "<city>", "state": "<state>",
      "class": { "value": "<class>", "confidence": 0.85, "basis": "<why, in words>" },
      "counts": { "people": 32, "decision_makers": 3, "...": "..." },
      "citation": { "status": "cited", "url": "<source url>", "...": "..." }
    }
  ]
}

For agents that call HTTP rather than MCP. Read-only, versioned by path. Full parameters, the public allowance per plan and refusal shapes are on the API reference.

state

OK, NO_MATCH, NOT_COVERED, UNKNOWN or DATA_WITHHELD. Not covered and withheld are said, not returned as an empty success.

Sources

Fact-bearing rows carry a source (key, name, URL) and a citation block whose status is cited or uncited, so an agent can tell which facts arrive with a source attached.

Dates

answered_at on every answer; observed_at (when DFX saw it) and effective_at (when it happened) on events.

Confidence

Classifications and events carry a confidence and a basis in words. Real estate debt rows carry a maturity basis instead.

Verification

verify takes a claim in plain words and returns a verdict with evidence (source URL, quote, confidence) and any contradictions.

Citing DFX

Cite the entity page (https://dfxintel.com/data-factory/entity/<graph>/<id>) and the date on the answer. For published figures, each dataset page carries a recommended citation: /datasets.

Stated plainly so an agent does not plan around something that is not there.

• A self-serve paid tier for agents Coming

  No plan on the pricing page includes API keys or unmasked MCP answers today.

• API keys and higher volumes Talk to us

  Available only under an Institutional agreement. Other plans cannot create keys (api_not_in_plan).

• Webhooks and push alerts Coming

  Nothing is pushed to an agent. Poll changes_since on the MCP with the cursor it returns.

• Research sessions and saved state Coming

  Every call stands alone. There is no session, watchlist or saved search an agent can create or resume over MCP.

• An OpenAPI document for the v1 API Coming

  The API reference page is the specification for now.

For keyed access, volume or a use the free tier does not fit, talk to us.