[Integrations](https://spiral.ai/integrations) › [Grok](https://spiral.ai/integrations/grok) › [FRED publisher directory](https://spiral.ai/integrations/grok/fred-publisher-directory)

# How to Use FRED publisher directory in Grok

Returns FRED's economic data publishers with IDs, names, real-time dates, and available websites or notes. Use it to discover publishers and find the IDs needed for publisher-specific research.

|  |  |
| --- | --- |
| Model | FRED publisher directory |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.013 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with FRED publisher directory in Grok

- Use FRED publisher directory to find the Bureau of Economic Analysis, Bureau of Labor Statistics, and Census Bureau, then show their publisher IDs and available websites.
- Use FRED publisher directory to find the Bank of England, Bank of Italy, Bank of Japan, and Bank of Mexico, then compare their returned publisher records.
- Use FRED publisher directory to look this up and give me the result as a table.
- Pull the latest numbers from FRED publisher directory and tell me what changed since last week.
- Check FRED publisher directory and summarize what you find in three bullet points.

## How to set up FRED publisher directory in Grok

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

### Use the Grok connector

1. **Add a custom connector**: In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

3. **Check that it is connected**: Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

### Use the Spiral skill

1. **Send Grok 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 FRED publisher directory**: 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/sources/sources",
    "input": {
      "limit": 1000
    }
  }'
```

Then paste one of the prompts above: Grok finds FRED publisher directory on Spiral, shows the price and runs it.

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

## FRED publisher directory tools and prices

- [FRED · Sources](https://spiral.ai/tools/alexandria/fred/sources/sources) (Alexandria): $0.013 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | … to 1000 | 1000 | Records to return. The default is the maximum, so a naive call is a large response rather than a page. |
| offset |  | 0 | Records to skip. Page by adding `limit` to it; `count` in the envelope is the full match total. |
| order_by | source_id, name, realtime_start, realtime_end | source_id | Which source attribute to sort by. |
| sort_order | asc, desc | asc | Sort direction. |
| realtime_end |  | — | End of the real-time period, YYYY-MM-DD. Defaults to today. Set 9999-12-31 for the full revision history. |
| realtime_start |  | — | Start of the real-time period, YYYY-MM-DD. Defaults to today, which means the current vintage only. Set 1776-07-04 for the full revision history. Setting one bound implies the other. |

## What can you do with FRED publisher directory in Grok?

Prepare a source appendix that identifies the publishers and releases behind an economic research topic. A chat app can turn FRED's publisher names, institutional links, and release metadata into a readable briefing.

### Prepare an economic report's source appendix

Find the report's publishers in FRED, resolve their names and available websites, and identify the releases associated with each publisher.

### Start research with a statistical agency

Find the Bureau of Economic Analysis in the directory, check its publisher record, and review its FRED-listed releases before selecting a dataset.

### Review publisher attribution in a dashboard

Compare a dashboard's publisher labels with FRED's directory and publisher records. Check release names and available links to clarify which publication each label refers to.

### Check historical source descriptions

Request publisher and release metadata for a past real-time period to examine the attribution information available then.

### Compare international economic publishers

Identify overseas central banks in FRED's directory and inspect their publisher records to compare names and available institutional websites.

## Overview

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

## FRED publisher directory in other agents

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

## More Grok guides

- [FRED publisher details](https://spiral.ai/integrations/grok/fred-publisher-details)
- [FRED publisher releases](https://spiral.ai/integrations/grok/fred-publisher-releases)
- [FRED publication date history](https://spiral.ai/integrations/grok/fred-publication-date-history)
- [FRED recently updated series](https://spiral.ai/integrations/grok/fred-recently-updated-series)
- [FRED historical observations](https://spiral.ai/integrations/grok/fred-historical-observations)
- [FRED related categories](https://spiral.ai/integrations/grok/fred-related-categories)

## Questions about FRED publisher directory in Grok

**Can Grok use FRED publisher directory?**

Yes. Add Spiral to Grok as an MCP server, and Grok can find and run FRED publisher directory like any built-in tool.

**How much does FRED publisher directory cost in Grok?**

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

**Do I need an Alexandria account to use FRED publisher directory in Grok?**

No. Spiral runs FRED publisher directory 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 publisher directory in Grok?**

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

**Does Grok wait while FRED publisher directory runs?**

FRED publisher directory runs in the background. Grok starts the run, checks on it and gives you the json when it's ready.

**Do these FRED tools return GDP, inflation, or interest-rate values?**

They return publisher and release metadata, such as names, IDs, links, and real-time dates. FRED publisher releases identifies statistical releases; it does not return the observations within them.

**Does FRED cover publishers outside the United States?**

Yes. Its publisher directory includes the Bank of England, Bank of Italy, Bank of Japan, and Bank of Mexico.

**Does a real-time date of today mean the publisher updated its data today?**

No. FRED's usual real-time default means information available today about the past. Sources and releases also have historical real-time periods, so these dates describe FRED's information history rather than a publication schedule.

**Does every FRED publisher record include a website and description?**

No. FRED explicitly makes publisher links and notes optional, so a directory entry or publisher detail record can omit either.

**How much of FRED's publisher catalog can one request return?**

Publisher-directory and publisher-release list requests each allow up to 1,000 results. Both expose a total count and offset for pagination; publisher details retrieves a selected source instead of a catalog page.

