Finra Fixed Income

What Finra Fixed Income does

Finra Fixed Income provides MCP access to FINRA’s Fixed Income Market data group through the Pipeworx gateway. The data covers aggregate activity and indicators across several areas: US Treasury trading volumes, corporate and agency debt breadth and sentiment, corporate 144A measures, agency MBS and other securitized-product activity, pricing series for TBA, CMO, CMBS, and CBO/CDO/CLO products, and capped-volume data.

The service is intended for questions about market-wide behavior, such as how much Treasury volume traded, whether corporate-market breadth was positive, or how activity changed over a selected reporting period. It does not expose individual bond transactions or the TRACE transaction tape.

How it works

Connect an MCP client to the Pipeworx endpoint:

{
  "mcpServers": {
    "finra-fixed-income": {
      "url": "https://gateway.pipeworx.io/finra-fixed-income/mcp"
    }
  }
}

Call finra_fixed_income_datasets first to obtain the available dataset keys, descriptions, and date field used by each series. Then pass one of those keys to finra_fixed_income_series. Without date parameters, the series tool targets FINRA’s latest published period. start_date and end_date restrict the returned window, and limit controls the response size.

Treasury datasets additionally accept product_category and benchmark filters. When those filters are used, the response includes summed volumes across the returned category and benchmark rows. The service accounts for dataset-specific date fields and uses available partition information to select recent data; some pricing datasets instead use a trailing window.

Setup and configuration

The hosted MCP endpoint uses a Pipeworx platform key or a bring-your-own FINRA credential. The platform configuration names PLATFORM_FINRA_KEY as the platform credential. FINRA authentication uses OAuth2 client credentials, with the client ID and secret combined as clientId:clientSecret.

A free FINRA Individual/Public credential covers the Fixed Income group. Before it can authenticate, the FINRA account must be activated: registration produces a Gateway UserID, the API terms must be accepted in the API Console, and the secret must be set through the emailed activation link. That link expires after 24 hours. FINRA’s token endpoint is hosted at ews.fip.finra.org.

Tools and capabilities

• finra_fixed_income_datasets lists the available series, their dataset keys, measurements, and date fields. It does not require a caller key.
• finra_fixed_income_series retrieves aggregate observations using a dataset key and optional date range and row limit.
• Treasury queries can filter by product category and benchmark, with totals aggregated across returned rows.
• Responses include FINRA attribution identifying the data owner and source.
• Calls are zero-rated under the stated licensing arrangement and do not consume credits.

Limitations and notes

The service contains aggregate statistics only. Requests for individual bond trades cannot be fulfilled through this endpoint; FINRA licenses transaction-level TRACE data separately. Recent date ranges may return no observations because the source series are published with a reporting lag.

The weekly Treasury aggregate is excluded because it returned no rows across the tested periods, including FINRA’s documented example range. Daily and monthly Treasury aggregates remain available. Dataset date fields differ, so a date filter must match the field associated with that dataset.

Callers may use the data for non-commercial personal or professional purposes under the stated terms, but may not redistribute it. FINRA attribution is included in responses. The endpoint also exposes shared Pipeworx gateway tools in addition to the two fixed-income tools, so an MCP client may display more tools than this server-specific list.