@pipeworx/dtcc-swaps

DTCC's public, real-time swap price dissemination feed (pddata.dtcc.com) — individual swap transactions and their pricing terms, disseminated live under CFTC Part 43 for CFTC-regulated swaps (commodity, credit, equity, FX, interest-rate), SEC-regulated security-based swaps (credit, equity, interest-rate) and Canadian-regulator swaps (credit, equity, interest-rate), plus the index of the underlying intraday/end-of-day bulk dissemination files.

Part of Pipeworx — an MCP gateway connecting AI agents to 1863+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

• dtcc_swaps_recent(regulator, asset_class, limit?) — the most-recently disseminated swap transactions for a regulator/asset-class combo (e.g. CFTC/IR), most-recent first, out of the feed's rolling ~100-row window. Each record carries notional, fixed/floating rate terms, execution/effective/ expiration dates, product identifiers, and actionType.

• dtcc_swaps_dissemination_files(regulator, asset_class, granularity?, limit?) — the index of DTCC's public bulk dissemination files (5-minute "slice" files, or one-per-day "cumulative"/EOD files) for a regulator/asset-class, with each file's row count and public download URL. This lists file pointers; it does not download or unzip them.

Related MCP server: financial-trading-risk-aiops-assistant

Auth

Keyless. No account, key, or click-through terms were found anywhere in the reachable surface (see the spike write-up below) — the feed is a public, unauthenticated JSON API on a public S3 bucket with directory listing enabled.

Data sources

• https://pddata.dtcc.com/ppd/api/general/regionname / .../bucketname — resolves the live public S3 bucket name (kgc0418-tdw-data-0 as of 2026-09-23; the pack calls the bucket directly, the same two values the dashboard SPA itself reads at load).

• https://kgc0418-tdw-data-0.s3.amazonaws.com/dashboard/Ticker.json — backs dtcc_swaps_recent. A flat map of {REGULATOR}_{ASSETCLASS} (live keys: CA_CR, CA_EQ, CA_IR, CFTC_CO, CFTC_CR, CFTC_EQ, CFTC_FX, CFTC_IR, SEC_CR, SEC_EQ, SEC_IR) to an array of the ~100 most-recently-disseminated trade records for that bucket. Continuously updated; this pack always fetches it fresh, never caches/mirrors it.

• https://kgc0418-tdw-data-0.s3.amazonaws.com/dashboard/Slice.json (intraday) and .../Cumulative.json (end-of-day) — back dtcc_swaps_dissemination_files. Same {REGULATOR}_{ASSETCLASS} keying, each entry pointing at a downloadable .zip of CSV trade data for that window/day, with a row count.

Traps for the next person

• These endpoints are undiscoverable from the DTCC site's own HTML/JS source by grepping for hostnames — the Angular SPA at pddata.dtcc.com/ppd/ resolves the bucket name from its own /ppd/api/general/* calls at runtime, and reads the JSON files with a relative path built from that response. The bucket name (kgc0418-tdw-data-0) is not literally present anywhere in the shipped JS bundle. It was found by loading the page in a real browser and reading its network requests, not by grepping the bundle. If DTCC ever rotates the bucket, regionname/bucketname are the two calls to re-probe.

• regulator/asset_class combos are not a fixed enum — CA and SEC never carry FX or CO, only CFTC does. Both tools throw a clear error naming the live keys actually present in that call's response rather than trusting a hardcoded list, since DTCC could add/retire a combo without notice.

• Corrections and cancellations are NOT in-place edits. A correction, cancellation, modification or termination of an earlier disseminated trade shows up as its own NEW record in Ticker.json, with actionType set to CORR / EROR / MODI / TERM instead of NEWT. Treat the feed as an append-only event log. A caller who wants only "new trades" should filter actionType === "NEWT" client-side; this pack returns the raw event stream so that behavior isn't silently baked in.

• Ticker.json is a rolling window (~100 rows per bucket), not history. For anything beyond that, dtcc_swaps_dissemination_files points at the underlying zip files (5-min slices or EOD cumulative), but downloading and unzipping those is deliberately out of scope for this pack — it returns the file index (name, URL, row count, window) so a caller can fetch the ones they actually need.

• No licence/terms page was found. www.dtcc.com/legal.php (the general corporate site) 403s on every fetch attempt (Akamai bot wall), unrelated to the pddata.dtcc.com data feed itself, which is unauthenticated throughout. The basis for proxying this data is that DTCC operates as a CFTC/SEC- registered Swap Data Repository and Part 43 of the CFTC's regulations mandates real-time PUBLIC reporting of swap transaction and pricing data — confirmed live via www.cftc.gov/IndustryOversight/DataRepositories/index.htm. Full probe trail: docs/api-wave-2026-09-23-spike.md (source #3).

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "dtcc-swaps": {
      "url": "https://gateway.pipeworx.io/dtcc-swaps/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/dtcc-swaps/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — ask_pipeworx, discover_tools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

This is deliberate, not multiplexing by accident. The meta-tools are what let a scoped connection answer a question this pack does not cover — via ask_pipeworx, which routes across the whole catalog — without you adding a second MCP server. There is currently no way to mount a pack endpoint without them; if the extra schemas cost you more context than the routing is worth, connect to the full gateway once rather than to several pack endpoints.

Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Both URLs reach the same gateway and the same 1863+ data sources. The only difference is which pack's tools are listed directly; ask_pipeworx reaches all of them from either one.

No MCP client? Call it over HTTP

curl -X POST https://gateway.pipeworx.io/v1/tools/dtcc_swaps_recent \
  -H 'Content-Type: application/json' \
  -d '{"regulator":"CFTC","asset_class":"IR","limit":3}'

No account needed for the first calls. Inspect any tool: GET https://gateway.pipeworx.io/v1/tools/dtcc_swaps_recent. Find one: POST https://gateway.pipeworx.io/v1/tools/search_packs with {"query":"..."}.

Run it from npm

@pipeworx/mcp-dtcc-swaps is a local stdio bridge to the Pipeworx gateway: your MCP client starts it with npx, and it forwards every call to the same https://gateway.pipeworx.io/dtcc-swaps/mcp endpoint shown above. It needs network access; there is no offline mode.

{
  "mcpServers": {
    "dtcc-swaps": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-dtcc-swaps"]
    }
  }
}

Without a key it calls anonymously, capped at 50 calls a day. A free account raises that to 200 a day: get a key at https://pipeworx.io/signup and add "env": { "PIPEWORX_API_KEY": "<your key>" } to the server entry. The key is sent as a Bearer token, the same way a hosted connection sends it, so calls are metered and billed exactly as they are there.

It lists only this pack's tools by default. Set PIPEWORX_META_TOOLS=1 to also list ask_pipeworx and the other gateway-wide tools.

Behind an HTTPS proxy: Node's built-in fetch does not read HTTPS_PROXY by default. Newer Node releases honour it when NODE_USE_ENV_PROXY=1 is set; check your Node version's documentation.

Using with ask_pipeworx

Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:

ask_pipeworx({ question: "your question about Dtcc Swaps data" })

The gateway picks the right tool and fills the arguments automatically.

More

• Docs and guides

• pipeworx.io

License

MIT