Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Finance

How to Use FRED economic data tags in Claude Code

Find FRED's labels for economic series, with notes, tag types, popularity, and series counts. Use them to choose exact search terms for topics, places, sources, and reporting frequencies before looking up series.

Prompts to try with FRED economic data tags in Claude Code

Copy an example into Claude Code, or ask in your own words.

Use FRED economic data tags to find labels relevant to US unemployment, monthly reporting, and seasonal adjustment, then compare them with the search terms in my dashboard project.

FRED economic data tagsClaude Code
Try asking
  • Use FRED economic data tags to identify labels for Canada, Japan, and the United States, then draft a geography selector using only labels actually returned.

  • Use FRED economic data tags to find Bureau of Labor Statistics and Bureau of Economic Analysis labels and notes, then add their explanations to my project's research glossary.

  • Use FRED economic data tags to find GDP-related labels and compare their returned series counts in a small table for my research notebook.

  • Use FRED economic data tags to check the unemployment and GDP labels saved in my project, and report which exact names appear in the returned data.

How to set up FRED economic data tags in Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run FRED economic data tags

    One request; the result comes back by polling or a webhook.

    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": "fred-stlouisfed-org/economic-data/tags",
        "input": {
          "page": 1
        }
      }'

Then paste one of the prompts above: Claude Code finds FRED economic data tags on Spiral, shows the price and runs it.

FRED economic data tags providers and prices

Spiral runs FRED economic data tags through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
FRED (Federal Reserve Economic Data) · Tags
fred-stlouisfed-org/economic-data/tags

Settings you can ask for

Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 10001

1-based page (50 rows per page); pass next_page from the previous result.

Every API field of FRED (Federal Reserve Economic Data) · Tags is on its tool page: open its card above.

What can you do with FRED economic data tags in Claude Code?

Build a series picker around actual FRED labels for topics, places, sources, and frequencies. A coding agent can compare returned labels with your project's search vocabulary and explain mismatches before you select economic series.

Plan an economic dashboard

Find exact labels for US unemployment, GDP, reporting frequency, and seasonal adjustment before selecting dashboard series.

Prepare international research

Identify geography labels for Canada, Japan, and the United States, keeping country names separate from geography types.

Choose source labels

Find the catalog labels and explanatory notes for the Bureau of Labor Statistics and Bureau of Economic Analysis before searching their series.

Explain catalog abbreviations

Turn returned tag names, notes, and types into a short glossary for researchers choosing economic series.

Check research vocabulary

Compare proposed search labels for a US labor-market study with actual returned FRED labels before attempting a combined series search.

Review catalog changes

Compare a selected set of returned tags with a previous snapshot to identify changed notes or series counts for a research topic.

Questions about FRED economic data tags in Claude Code

Can Claude Code use FRED economic data tags?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run FRED economic data tags like any built-in tool.

How much does FRED economic data tags cost in Claude Code?

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

Do I need an Alexandria account to use FRED economic data tags in Claude Code?

No. Spiral runs FRED economic data tags on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up FRED economic data tags in Claude Code?

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

Does Claude Code wait while FRED economic data tags runs?

FRED economic data tags runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

Do FRED tags include GDP or unemployment values?

Tags describe economic series rather than providing their observations. A tag record includes descriptive metadata, popularity, and a series count; retrieving GDP or unemployment values requires a separate observation lookup.

What kinds of labels does FRED use?

FRED has eight tag sections: concepts, geography types, geographies, frequencies, sources, releases, seasonal adjustments, and citation and copyright. Geography and geography type are separate sections.

Is FRED limited to US government data?

FRED includes national and international economic series from both public and private sources. Its scope extends beyond statistics produced by the Federal Reserve.

Does a tag's creation date show when economic values last changed?

The tag record's timestamp describes the tag's creation. Economic series have their own releases and revisions: FRED displays the latest validated version and archives replaced versions in ALFRED.

Can I combine any tags I find?

FRED's tag-based series search requires every included tag to match the same series. Finding two labels separately does not prove that any series carries both; FRED has a separate related-tags lookup to examine combinations.

Get started

Start using FRED economic data tags in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options