[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [FRED economic data tags](https://spiral.ai/integrations/instinct/fred-economic-data-tags)

# How to Use FRED economic data tags in Instinct

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.

|  |  |
| --- | --- |
| Model | FRED economic data tags |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with FRED economic data tags in Instinct

- 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.
- 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 Instinct

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

### Use the Spiral skill

1. **Send Instinct 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. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

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

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

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

## FRED economic data tags tools and prices

- [FRED (Federal Reserve Economic Data) · Tags](https://spiral.ai/tools/alexandria/fred-stlouisfed-org/economic-data/tags) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 1000 | 1 | 1-based page (50 rows per page); pass `next_page` from the previous result. |

## What can you do with FRED economic data tags in Instinct?

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.

## Overview

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

## FRED economic data tags in other agents

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

## More Instinct guides

- [FRED economic categories](https://spiral.ai/integrations/instinct/fred-economic-categories)
- [FRED economic data values](https://spiral.ai/integrations/instinct/fred-economic-data-values)
- [FRED data sources](https://spiral.ai/integrations/instinct/fred-data-sources)
- [FRED economic release calendar](https://spiral.ai/integrations/instinct/fred-economic-release-calendar)
- [FRED child categories](https://spiral.ai/integrations/instinct/fred-child-categories)
- [FRED economic release directory](https://spiral.ai/integrations/instinct/fred-economic-release-directory)

## Questions about FRED economic data tags in Instinct

**Can Instinct use FRED economic data tags?**

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

**How much does FRED economic data tags cost in Instinct?**

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

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

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs FRED economic data tags on its own Alexandria account.

**How long does it take to set up FRED economic data tags in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while FRED economic data tags runs?**

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

