# io.github.cyanheads/treasury-fiscaldata-mcp-server (remote · treasury-fiscaldata.caseyjhand.com)

MCP server for US Treasury Fiscal Data — debt, interest rates, exchange rates, and spending.

- Trust score: 68/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `treasury-fiscaldata.caseyjhand.com`: 68/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/treasury-fiscaldata.md), [page](https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/treasury-fiscaldata)
- npm · `@cyanheads/treasury-fiscaldata-mcp-server`: 35/100, [markdown](https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/cyanheads-treasury-fiscaldata-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/cyanheads-treasury-fiscaldata-mcp-server)

## Channel facts

- Endpoint: `https://treasury-fiscaldata.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.5`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 7 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2204 tokens (~314/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http cyanheads-treasury-fiscaldata-mcp-server https://treasury-fiscaldata.caseyjhand.com/mcp
```

### Codex

```toml
[mcp_servers.cyanheads-treasury-fiscaldata-mcp-server]
url = "https://treasury-fiscaldata.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-treasury-fiscaldata-mcp-server": {
      "type": "remote",
      "url": "https://treasury-fiscaldata.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-treasury-fiscaldata-mcp-server --url https://treasury-fiscaldata.caseyjhand.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-treasury-fiscaldata-mcp-server:
    url: "https://treasury-fiscaldata.caseyjhand.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-treasury-fiscaldata-mcp-server": {
      "type": "http",
      "url": "https://treasury-fiscaldata.caseyjhand.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 67, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 65, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 63, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 62)

First indexed and scored.

## MCP tools (7)

### `treasury_list_datasets` (~186 tokens)

List Treasury Fiscal Data Datasets

Browse the curated catalog of US Treasury Fiscal Data API endpoints. Returns endpoint paths, field names, descriptions, and update cadence for each dataset. Use this tool before treasury_query_dataset to discover the correct endpoint path and field names — a typo in either causes a 400 error from the API. The catalog is a curated subset of the full API — pass any endpoint path directly to treasury_query_dataset to query datasets not listed here. The catalog covers debt, interest rates, exchange rates, revenue/spending, savings bonds, and securities datasets.

Input parameters:

- `category` (string): Filter by category. Omit to list all datasets. Options: debt, interest_rates, exchange_rates, revenue_spending, savings_bonds, securities, other.
- `search` (string): Keyword filter against dataset name and description (case-insensitive substring match). Useful for narrowing results when the category is uncertain.

Output parameters:

- `datasets` (array): Matching datasets.
- `total` (number): Total matching datasets.

### `treasury_query_dataset` (~424 tokens)

Query Treasury Fiscal Data Dataset

Query any Treasury Fiscal Data endpoint by path, field list, filters, sort, and page. Call treasury_list_datasets first to get the correct endpoint path and exact field names — a typo in either causes a 400. Filter syntax: each condition is { field, operator, value } where operator is eq/gt/gte/lt/lte/in (e.g., record_date:gte:2024-01-01). Multiple conditions are ANDed together. All response values are strings per the API contract, including numbers and dates; "null" (string) means no value. Supply canvas_id to register the page result into a named DataCanvas dataframe and query it later with treasury_dataframe_query (requires CANVAS_PROVIDER_TYPE=duckdb on the server).

Input parameters:

- `canvas_id` (string): DataCanvas ID to spill results into for SQL analysis. Omit to receive results inline. Requires CANVAS_PROVIDER_TYPE=duckdb on the server. When provided, the full page result is registered as a datafr…
- `endpoint` (string, required): Endpoint path returned by treasury_list_datasets (e.g., "/v2/accounting/od/debt_to_penny"). Include the leading slash.
- `fields` (array): Fields to return. Omit to return all fields. Specify field names exactly as listed by treasury_list_datasets — a typo causes a 400.
- `filters` (array): Filter conditions (ANDed together). Multiple filters on different fields are combined in one filter= parameter.
- `page_number` (integer): Page to fetch (1-indexed). Check total_pages in the response to know if more pages exist.
- `page_size` (integer): Rows per page. Default 100. Raise to 10000 to minimize round trips for small datasets. For large time-series pulls, use canvas_id with treasury_dataframe_query instead.
- `sort` (string): Sort expression: field name optionally prefixed with "-" for descending (e.g., "-record_date" for newest-first).

Output parameters:

- `applied_filters` (string): Filter expression sent to the API, for verification.
- `canvas_expires_at` (string): ISO 8601 expiry for the canvas dataframe.
- `canvas_id` (string): DataCanvas ID where this page is registered. Use with treasury_dataframe_query to run SQL.
- `data` (array): Rows returned. All values are strings per API contract — including numeric and date fields. Convert in the calling context. Null values appear as the string "null".
- `endpoint` (string): Endpoint that was queried.
- `field_labels` (object): Human-readable label for each returned field.
- `notice` (string): Guidance when results are empty, a field typo is suspected, or the endpoint was not found in the catalog.
- `page_number` (number): Current page (1-indexed).
- `page_size` (number): Rows per page.
- `totalCount` (number): Total rows matching the query across all pages — discloses that this page is a subset.
- `total_count` (number): Total rows matching the query (across all pages).
- `total_pages` (number): Total pages at the current page_size.

### `treasury_get_debt` (~345 tokens)

Get National Debt

Fetch national debt (Debt to the Penny) — total public debt outstanding broken into publicly-held debt and intragovernmental holdings. Three modes: "latest" returns the most recent business day's record; "date" returns the record for a specific date (must be a business day — the API only records debt on days markets are open); "series" returns a date range and optionally spills results to DataCanvas for SQL analysis via treasury_dataframe_query. Records go back to 1993-01-04. As of 2026-05-28 the total debt is approximately $39.18T.

Input parameters:

- `canvas_id` (string): DataCanvas table name (df_XXXXX_XXXXX) to register series results into for SQL analysis. When provided, or when the series exceeds 500 rows, the full result is registered and the name is returned in…
- `date` (string): ISO 8601 date (YYYY-MM-DD) for mode=date. Must be a business day; the API only records debt on days the market is open.
- `end_date` (string): ISO 8601 end date for mode=series (inclusive). Defaults to today.
- `mode` (string): "latest" returns the most recent day's record. "date" returns the record for a specific date. "series" returns a date range — use with start_date and end_date.
- `start_date` (string): ISO 8601 start date for mode=series (inclusive). Fiscal Data has daily debt records back to 1993-01-04.

Output parameters:

- `canvas_expires_at` (string): ISO 8601 expiry for the canvas dataframe.
- `canvas_id` (string): DataCanvas table name when series was spilled. Use treasury_dataframe_query to run SQL.
- `debt_held_public` (string): Debt held by the public (external creditors, Fed, foreign governments) in USD.
- `intragovernmental_holdings` (string): Intragovernmental holdings (debt owed to federal trust funds, Social Security, etc.) in USD.
- `record_date` (string): Date of this debt record (YYYY-MM-DD). For series mode, the most recent date.
- `series` (array): All records for mode=series (may be truncated when spilled to canvas).
- `total_debt` (string): Total public debt outstanding in USD (string — convert as needed). Example: "39176301795549.40".
- `total_records` (number): Total matching records for mode=series.

### `treasury_get_interest_rates` (~320 tokens)

Get Treasury Interest Rates

Average interest rates Treasury pays on its outstanding securities by security type. Answers "what is the government's cost of borrowing?" Covers Bills, Notes, Bonds, TIPS, Floating Rate Notes, and aggregate marketable/non-marketable totals. Updated monthly (end-of-month records). Mode "latest" returns the most recent month's rates for all or one security type; "series" returns a time history. As of 2026-04-30: Bills 3.696%, Notes 3.230%, Bonds 3.403%, TIPS 1.068%, FRN 3.764%, Total Interest-bearing Debt 3.340%.

Input parameters:

- `canvas_id` (string): DataCanvas table name (df_XXXXX_XXXXX) to register series results into for SQL analysis. When provided, or when mode=series and results exceed 200 rows, the result is registered and canvas_id is retu…
- `end_date` (string): ISO 8601 end date for mode=series. Defaults to today.
- `mode` (string): "latest" returns the most recent month's rates. "series" returns a time range.
- `security_type` (string): Filter to one security type. Omit for all types. Use the exact string — the API does exact-match filtering on security_desc.
- `start_date` (string): ISO 8601 start date for mode=series (YYYY-MM-DD, must be end-of-month for meaningful results).

Output parameters:

- `as_of_date` (string): Most recent record date returned (YYYY-MM-DD).
- `canvas_expires_at` (string): ISO 8601 expiry for the canvas dataframe.
- `canvas_id` (string): DataCanvas table name for series results. Use treasury_dataframe_query to run SQL.
- `notice` (string): Guidance when no records match — lists valid security types or notes the empty date range.
- `rates` (array): Interest rate records.
- `total_records` (number): Total matching records.

### `treasury_get_exchange_rates` (~348 tokens)

Get Treasury Exchange Rates

Official Treasury reporting exchange rates for ~130 countries — the rates US federal agencies are required to use when converting foreign currency to USD for official reporting. Published quarterly (March 31, June 30, Sep 30, Dec 31). Rate is expressed as foreign currency units per 1 USD (e.g., Japan-Yen: 159.41 means 1 USD = 159.41 JPY). These are NOT market exchange rates and are not suitable for financial transaction pricing. The latest quarter available is 2026-03-31 (Q1 2026).

Input parameters:

- `canvas_id` (string): DataCanvas table name (df_XXXXX_XXXXX) to register series results into for SQL analysis. Useful when pulling multi-year history for many countries (~18,800 rows total). When provided, or when mode=se…
- `countries` (array): Filter to specific countries by exact country name (e.g., ["Japan", "Germany", "France"]). Case-sensitive, matches the "country" field. Omit for all ~130 countries in the quarter.
- `end_date` (string): ISO 8601 end date for mode=series.
- `mode` (string): "latest" returns the most recently published quarter's rates. "series" returns a date range of quarterly reports.
- `start_date` (string): ISO 8601 start date for mode=series. Rates are published end-of-quarter (March 31, June 30, Sep 30, Dec 31).

Output parameters:

- `as_of_date` (string): Quarter-end date of the most recent rates (YYYY-MM-DD).
- `canvas_expires_at` (string): ISO 8601 expiry for the canvas dataframe.
- `canvas_id` (string): DataCanvas table name for series results. Use treasury_dataframe_query to run SQL.
- `effective_date` (string): Effective date of the rates (same as record_date).
- `note` (string): Contextual note reminding that these are official reporting rates, not market rates.
- `notice` (string): Guidance when a requested country was not found or returned no records.
- `rates` (array): Exchange rates for the requested countries/quarter.
- `total_records` (number): Total records returned.

### `treasury_dataframe_describe` (~115 tokens)

Describe Treasury Dataframes

List DataCanvas dataframes materialized by treasury_query_dataset, treasury_get_debt, treasury_get_interest_rates, and treasury_get_exchange_rates. Each entry surfaces source tool, query parameters, creation/expiry timestamps, row count, and column schema. Use this tool before treasury_dataframe_query to discover table names and column types. Requires CANVAS_PROVIDER_TYPE=duckdb.

Input parameters:

- `name` (string): Optional dataframe table name (df_XXXXX_XXXXX) to describe a single dataframe. Omit to list all active dataframes.

Output parameters:

- `dataframes` (array): Active dataframes for this tenant, newest first. Empty when none are registered.

### `treasury_dataframe_query` (~290 tokens)

Query Treasury Dataframes

Run a single-statement SELECT against DataCanvas dataframes registered by treasury_query_dataset, treasury_get_debt, treasury_get_interest_rates, and treasury_get_exchange_rates. Read-only: writes, DDL, DROP, COPY, PRAGMA, ATTACH, and external-file table functions are rejected. System catalogs (information_schema, pg_catalog, sqlite_master, duckdb_*) are denied at the bridge layer. All Treasury dataframe columns are VARCHAR — CAST to DECIMAL or DATE for arithmetic and date comparisons. Use treasury_dataframe_describe to list available table names and column schemas before querying.

Input parameters:

- `preview` (integer): Rows in the immediate response. Defaults to row_limit. Set lower when using register_as.
- `register_as` (string): Persist result as a new dataframe. Use to chain analyses. The name must match df_XXXXX_XXXXX format or be a fresh df_<id>.
- `row_limit` (integer): Hard cap on rows in the response. Default 1000, max 10000.
- `sql` (string, required): Single-statement SELECT against df_<id> tables. All values in Treasury dataframes are VARCHAR (strings) per the API contract — CAST to DECIMAL or DATE for arithmetic and date comparisons. Example: SE…

Output parameters:

- `columns` (array): Column names in projection order.
- `expires_at` (string): ISO 8601 expiry timestamp for the newly registered dataframe, when applicable.
- `notice` (string): Guidance when the query returned no rows, or when results were capped by row_limit.
- `registered_as` (string): Set when register_as was supplied and the new dataframe was materialized.
- `row_count` (number): Total rows the query produced (may exceed rows.length when capped).
- `rows` (array): Materialized rows, bounded by preview / row_limit.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/treasury-fiscaldata#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 67
- 2026-08-01: 67
- 2026-07-31: 67
- 2026-07-30: 65
- 2026-07-29: 64
- 2026-07-28: 64
- 2026-07-27: 63
- 2026-07-26: 62

## Links

- Remote endpoint: https://treasury-fiscaldata.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/treasury-fiscaldata-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/treasury-fiscaldata/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/treasury-fiscaldata/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-treasury-fiscaldata-mcp-server/treasury-fiscaldata