[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Treasury Fiscal Data dataset search](https://spiral.ai/integrations/codex/treasury-fiscal-data-dataset-search)

# How to Use Treasury Fiscal Data dataset search in Codex

Returns catalog information for Treasury Fiscal Data datasets and their tables. Use it to find the right source for a question before retrieving figures, checking release dates, or locating published statements.

|  |  |
| --- | --- |
| Model | Treasury Fiscal Data dataset search |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Treasury Fiscal Data dataset search in Codex

- Use Treasury Fiscal Data dataset search to find the Monthly Treasury Statement tables for receipts, outlays, and deficit or surplus, then document the relevant table descriptions in this project's data-source notes.
- Use Treasury Fiscal Data dataset search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Treasury Fiscal Data dataset search and tell me what changed since last week.
- Check Treasury Fiscal Data dataset search and summarize what you find in three bullet points.
- Pull the newest data from Treasury Fiscal Data dataset search and give me the result as a table.

## How to set up Treasury Fiscal Data dataset search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Treasury Fiscal Data dataset search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "fiscaldata-treasury-gov/fiscal-data/datasets",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Treasury Fiscal Data dataset search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Treasury Fiscal Data dataset search tools and prices

- [US Treasury Fiscal Data · Datasets](https://spiral.ai/tools/alexandria/fiscaldata-treasury-gov/fiscal-data/datasets) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| query |  | — | Keywords; every word must match (case-insensitive) somewhere in the dataset id, title, descriptions, table names or column names. Omit to list every dataset. |
| cursor |  | — | next_cursor from the previous page of the same query. |
| page_size | 1 to 100 | 10 | Datasets per page. |
| dataset_id |  | — | Exact Fiscal Data dataset id such as 015-BFS-2014Q3-065; not_found when the catalog has no such dataset. Pattern: ^015-BFS-[0-9]{4}Q[1-4]-[0-9A-Za-z]{2,4}$. |

## What can you do with Treasury Fiscal Data dataset search in Codex?

Build a federal finance dashboard with Treasury debt, cash, and budget figures tied to their reporting periods. A coding agent can use dataset descriptions, historical records, release estimates, and published statements to make the dashboard's calculations easier to inspect.

### Prepare a monthly federal budget briefing

Find the Monthly Treasury Statement tables, check the expected publication date, and retrieve the newest receipts and outlays. Compare them with earlier periods and locate the official statement for the briefing's source material.

### Explain changes in Treasury's cash balance

Identify the Daily Treasury Statement tables, plan checks around expected releases, and compare the newest cash balance with earlier observations. Locate the corresponding statement to examine deposits, withdrawals, and the report's notes.

### Review quarterly currency reporting rates

Find Treasury's exchange-rate dataset and expected releases, retrieve the newest Canadian dollar and Mexican peso observations, and compare earlier quarters. Locate the published report while checking raw records separately for amendments omitted from the PDF.

### Run an economic newsroom's release desk

Build a watchlist of Treasury datasets and expected publication times. For each release, compare the newest figures with the preceding period and locate any accompanying published statement before drafting the update.

### Chart the composition of national debt

Find Debt to the Penny and compare debt held by the public with intragovernmental holdings over a chosen period. Add the newest observation to show how both components contribute to the total.

### Check a budget chart against its published statement

Retrieve the Monthly Treasury Statement records behind a chart and locate the statement for the same period. Check the units and distinguish detail rows from subtotals before recalculating the chart.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Treasury Fiscal Data dataset search in other agents

- [Amp](https://spiral.ai/integrations/amp/treasury-fiscal-data-dataset-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/treasury-fiscal-data-dataset-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/treasury-fiscal-data-dataset-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/treasury-fiscal-data-dataset-search)
- [Cline](https://spiral.ai/integrations/cline/treasury-fiscal-data-dataset-search)
- [Cursor](https://spiral.ai/integrations/cursor/treasury-fiscal-data-dataset-search)
- [Devin](https://spiral.ai/integrations/devin/treasury-fiscal-data-dataset-search)
- [dots](https://spiral.ai/integrations/dots/treasury-fiscal-data-dataset-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/treasury-fiscal-data-dataset-search)
- [Gemini](https://spiral.ai/integrations/gemini/treasury-fiscal-data-dataset-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/treasury-fiscal-data-dataset-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/treasury-fiscal-data-dataset-search)
- [goose](https://spiral.ai/integrations/goose/treasury-fiscal-data-dataset-search)
- [Grok](https://spiral.ai/integrations/grok/treasury-fiscal-data-dataset-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/treasury-fiscal-data-dataset-search)
- [Hermes](https://spiral.ai/integrations/hermes/treasury-fiscal-data-dataset-search)
- [Instinct](https://spiral.ai/integrations/instinct/treasury-fiscal-data-dataset-search)
- [Manus](https://spiral.ai/integrations/manus/treasury-fiscal-data-dataset-search)
- [Muse](https://spiral.ai/integrations/muse/treasury-fiscal-data-dataset-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/treasury-fiscal-data-dataset-search)
- [n8n](https://spiral.ai/integrations/n8n/treasury-fiscal-data-dataset-search)
- [Notion](https://spiral.ai/integrations/notion/treasury-fiscal-data-dataset-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/treasury-fiscal-data-dataset-search)
- [opencode](https://spiral.ai/integrations/opencode/treasury-fiscal-data-dataset-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/treasury-fiscal-data-dataset-search)
- [Raycast](https://spiral.ai/integrations/raycast/treasury-fiscal-data-dataset-search)
- [VS Code](https://spiral.ai/integrations/vscode/treasury-fiscal-data-dataset-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/treasury-fiscal-data-dataset-search)
- [Zapier](https://spiral.ai/integrations/zapier/treasury-fiscal-data-dataset-search)

## More Codex guides

- [Tiingo ticker search](https://spiral.ai/integrations/codex/tiingo-ticker-search)
- [Treasury Fiscal Data latest figures](https://spiral.ai/integrations/codex/treasury-fiscal-data-latest-figures)
- [Tiingo ticker metadata](https://spiral.ai/integrations/codex/tiingo-ticker-metadata)
- [Treasury Fiscal Data published reports](https://spiral.ai/integrations/codex/treasury-fiscal-data-published-reports)
- [Tiingo historical stock prices](https://spiral.ai/integrations/codex/tiingo-historical-stock-prices)
- [Treasury Fiscal Data release calendar](https://spiral.ai/integrations/codex/treasury-fiscal-data-release-calendar)

## Questions about Treasury Fiscal Data dataset search in Codex

**Can Codex use Treasury Fiscal Data dataset search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Treasury Fiscal Data dataset search like any built-in tool.

**How much does Treasury Fiscal Data dataset search cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Treasury Fiscal Data dataset search in Codex?**

No. Spiral runs Treasury Fiscal Data dataset search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Treasury Fiscal Data dataset search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Treasury Fiscal Data dataset search runs?**

Treasury Fiscal Data dataset search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How current are Treasury's national debt figures?**

Debt to the Penny is updated at the end of each business day with the previous business day's data. Its latest observation is a daily accounting figure, not a continuously updated debt counter.

**Are Treasury's release dates guaranteed?**

Treasury describes its release calendar as estimated dates and times for upcoming releases. Use it to plan a refresh, then check whether the expected reporting period has actually appeared.

**Can I reuse Fiscal Data in a commercial report or application?**

Yes. Treasury explicitly permits copying, adapting, redistributing, and otherwise using the data for commercial and noncommercial purposes.

**Can Fiscal Data tell me someone's tax refund or payment status?**

No. Fiscal Data publishes government data and explicitly says it has no access to personal data or the ability to resolve personal inquiries.

**Why might a calculated spending total disagree with a Treasury statement?**

Monthly Treasury Statement tables include total and subtotal rows, so summing every row can double-count amounts. Daily Treasury Statement figures also have a specific precision limit: they are rounded to the nearest million.

