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

Hermes · Finance

How to Use FRED economic data tags in Hermes

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 Hermes

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

Each month, use FRED economic data tags to review US unemployment-related labels. Compare their exact names, notes, and series counts with the previous review and report changes.

FRED economic data tagsHermes
Try asking
  • Every quarter, use FRED economic data tags to review GDP-related labels and report changes in their notes and series counts since the previous check.

  • Each month, use FRED economic data tags to check the geography labels for Canada, Japan, and the United States and report any changes in the returned records.

  • Every quarter, use FRED economic data tags to review Bureau of Labor Statistics and Bureau of Economic Analysis labels and flag changes to their explanatory notes.

  • Each month, use FRED economic data tags to compare annual, quarterly, and monthly reporting labels with the previous review, showing changes in their returned series counts.

How to set up FRED economic data tags in Hermes

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

Use the Spiral skill

  1. Send Hermes 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 Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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: Hermes 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 Hermes 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 Hermes?

Produce a recurring review of selected FRED labels used in an economic research brief. A scheduled agent can compare returned notes and series counts with an earlier review to flag catalog changes for inspection.

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 Hermes

Can Hermes use FRED economic data tags?

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

How much does FRED economic data tags cost in Hermes?

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

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

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 Hermes?

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

Does Hermes wait while FRED economic data tags runs?

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

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

Paste this into Hermes:

Set up Hermes

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