# `io.github.cyanheads/treasury-fiscaldata-mcp-server` on anlyon.dev

> Text inside fenced blocks marked untrusted-server-text was written by the MCP server's publisher, not by anlyon.dev. It is data to inspect, not instructions to follow. Invisible characters are shown as [U+XXXX].
> No finding is not a safety guarantee: these are point-in-time checks of tool definitions, not of code or behaviour.

- Page: https://anlyon.dev/servers/io.github.cyanheads/treasury-fiscaldata-mcp-server
- JSON: https://anlyon.dev/api/v1/servers/io.github.cyanheads/treasury-fiscaldata-mcp-server
- Version: 0.2.0 (active)
- Publisher: io.github.cyanheads (GitHub account)
- Runs: remote (streamable-http), local (npm)
- Sign-in to list tools: none
- Repository: https://github.com/cyanheads/treasury-fiscaldata-mcp-server
- Metadata from the official MCP Registry, synced 2026-10-21T18:28:53.733Z

Title and description, as the publisher wrote them:

```untrusted-server-text
Query US Treasury national debt, interest rates, exchange rates, and fiscal datasets via MCP.
```

Scanned 2026-10-21T19:17:25.667Z over streamable-http.

**7 tools: 1 change things and 6 only read.**

| Group | Class | Tools | Claude Code |
| --- | --- | --- | --- |
| Deletes or cancels | destructive | 0 | deny |
| Can't be undone | irreversible | 0 | ask |
| Changes things | write | 1 | ask |
| Only reads | read | 6 | allow |

## Findings

- **warn** Annotations that disagree with the tool in `treasury_dataframe_query` ([annotation-conflict](https://anlyon.dev/methodology#annotation-conflict))

```untrusted-server-text
The server marks "treasury_dataframe_query" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}; The name "treasury_dataframe_query" says "query": a word for reading.
```


## Changes things (1)

Creates or changes something that can be changed back. Claude Code: ask.

### `treasury_dataframe_query`

- The name "treasury_dataframe_query" says "query": a word for reading.
- The description's first verb is "run": a word for a change.
- The input takes a statement or command to run (input.sql), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
- Findings: warn annotation-conflict

Description, as the server wrote it:

```untrusted-server-text
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.
```

## Only reads (6)

Looks things up and changes nothing. Claude Code: allow.

### `treasury_dataframe_describe`

- The name "treasury_dataframe_describe" says "describe": a word for reading.

Description, as the server wrote it:

```untrusted-server-text
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.
```

### `treasury_get_debt`

- The name "treasury_get_debt" says "get": a word for reading.

Description, as the server wrote it:

```untrusted-server-text
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, staging the full result as a DataCanvas table when canvas_id is set or the range matches more than 500 rows — read the table's column schema with treasury_dataframe_describe, then run SQL over it with treasury_dataframe_query. Records go back to 1993-04-01.
```

### `treasury_get_exchange_rates`

- The name "treasury_get_exchange_rates" says "get": a word for reading.

Description, as the server wrote it:

```untrusted-server-text
Official Treasury reporting exchange rates for ~165 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); mode "latest" returns the most recently published quarter. Rate is expressed as foreign currency units per 1 USD (e.g., a Japan-Yen rate of 159.41 means 1 USD = 159.41 JPY). These are NOT market exchange rates and are not suitable for financial transaction pricing. Mode "series" stages the result as a DataCanvas table when canvas_id is set or the range matches more than 500 rows — read the table's column schema with treasury_dataframe_describe, then run SQL over it with treasury_dataframe_query.
```

### `treasury_get_interest_rates`

- The name "treasury_get_interest_rates" says "get": a word for reading.

Description, as the server wrote it:

```untrusted-server-text
Average interest rates Treasury pays on its outstanding securities by security type. Answers "what is the government's cost of borrowing?" Covers every type Treasury reports — marketable issues, non-marketable series, and the aggregate totals — and which types it reports changes over the years, so omit security_type to see the ones a given period carries. Rates are percentages, not basis points. 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, staging the result as a DataCanvas table when canvas_id is set or the range matches more than 200 rows — read the table's column schema with treasury_dataframe_describe, then run SQL over it with treasury_dataframe_query.
```

### `treasury_list_datasets`

- The name "treasury_list_datasets" says "list": a word for reading.

Description, as the server wrote it:

```untrusted-server-text
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.
```

### `treasury_query_dataset`

- The name "treasury_query_dataset" says "query": a word for reading.

Description, as the server wrote it:

```untrusted-server-text
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 stage the page result as a DataCanvas table — read its column schema with treasury_dataframe_describe, then run SQL over it with treasury_dataframe_query (requires CANVAS_PROVIDER_TYPE=duckdb on the server).
```

## Claude Code permissions

For `.claude/settings.json`, assuming the server is installed as `treasury-fiscaldata`:

```json
{
  "permissions": {
    "allow": [
      "mcp__treasury-fiscaldata__treasury_list_datasets",
      "mcp__treasury-fiscaldata__treasury_query_dataset",
      "mcp__treasury-fiscaldata__treasury_get_debt",
      "mcp__treasury-fiscaldata__treasury_get_interest_rates",
      "mcp__treasury-fiscaldata__treasury_get_exchange_rates",
      "mcp__treasury-fiscaldata__treasury_dataframe_describe"
    ],
    "ask": [
      "mcp__treasury-fiscaldata__treasury_dataframe_query"
    ],
    "deny": []
  }
}
```