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

Gemini CLI · Finance

How to Use FRED economic data tags in Gemini CLI

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 Gemini CLI

Copy an example into Gemini CLI, 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 tagsGemini CLI
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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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: Gemini CLI 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 Gemini CLI 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 Gemini CLI?

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 Gemini CLI

Can Gemini CLI use FRED economic data tags?

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

How much does FRED economic data tags cost in Gemini CLI?

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

Do I need an Alexandria account to use FRED economic data tags in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while FRED economic data tags runs?

FRED economic data tags runs in the background. Gemini CLI 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 Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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