How to Use the FRED Categories — Economic Data Taxonomy MCP in Windsurf

Q: How do I install FRED Categories — Economic Data Taxonomy in Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file. Add the server details under the mcpServers object, then click Refresh in the MCP panel. You can also use the built-in MCP Marketplace for a one-click install.

Let Windsurf's Cascade autonomously map macroeconomic indicators directly into your workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FRED Categories — Economic Data Taxonomy MCP to Windsurf

Create your Vinkius account to connect FRED Categories — Economic Data Taxonomy to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup FRED Categories — Economic Data Taxonomy with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous taxonomy traversal in Windsurf

The `get_category` tool pulls metadata for root nodes like Money, Banking, & Finance. Cascade doesn't stop there. Your agent automatically fires `get_category_children` to walk down the hierarchy without waiting for your permission. You ask for labor market data. Windsurf maps the path from category 10 down to specific local employment branches using this MCP server. It builds the category tree in memory and shows you the exact path it took.

Filter thousands of economic series

Cascade calls `get_category_series` to pull the specific indicators under a discovered category. It filters out the noise by specifying frequency and units right in the request. You don't have to manually click through web portals anymore. Cascade grabs the raw series IDs and drops them directly into your Python scripts or Jupyter notebooks.

Discover dimensions via tags

To clean up messy economic data, Cascade runs `get_category_tags` to see exactly how FRED organizes a specific node. It pulls the available dimensions before trying to query the series. That means your agent knows exactly which tags to apply when it finally fetches the data. You get a clean, filtered dataset ready for your macroeconomic models.

Setup guide

Set up FRED Categories — Economic Data Taxonomy MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the FRED Categories — Economic Data Taxonomy MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my FRED Categories — Economic Data Taxonomy payment history." If connected, Cascade will call the FRED Categories — Economic Data Taxonomy tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "fred-categories-economic-data-taxonomy-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by FRED. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect FRED Categories — Economic Data Taxonomy now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about FRED Categories — Economic Data Taxonomy MCP in Windsurf

Edit your `~/.codeium/windsurf/mcp_config.json` file. Add the server details under the `mcpServers` object, then click Refresh in the MCP panel. You can also use the built-in MCP Marketplace for a one-click install.

Cascade handles the entire traversal process. It hits the root node and recursively fetches children until it finds the specific economic series you requested. You just set the target.

Writing manual HTTP requests to walk a category tree wastes time. Cascade chains the requests autonomously, mapping the taxonomy and writing the data fetching code in one step.

It checks the available dimensions first. By pulling tags and category metadata, the agent filters the series list by frequency and unit before importing anything into your workspace.

No. This server only reads public macroeconomic category structures and series metadata from FRED. Your local code, API keys, and model parameters never leave your local machine.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript