How to Use the FRED GeoFRED — Regional Economic Data MCP in Vercel AI SDK

Q: How do I connect the FRED GeoFRED — Regional Economic Data server to my Vercel AI SDK project?

Install the @ai-sdk/mcp package, then use createMCPClient with the unique Vinkius URL for this server. Pass the resulting tools from mcpClient.tools() into your streamText or generateText call. It's designed to fit right into your existing AI SDK code.

Q: Can I stream map shapes and economic stats at the same time?

Yes. You can have your AI client call getgeoshapes and getregionaldata in parallel. The Vercel AI SDK handles the multiple data streams, so you can render the map outline and populate a data table simultaneously for a really responsive user experience.

Stream FRED economic data directly into your Next.js app with the Vercel AI SDK. No loading spinners, just live maps and metrics.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FRED GeoFRED — Regional Economic Data MCP to Vercel AI SDK

Create your Vinkius account to connect FRED GeoFRED — Regional Economic Data to Vercel AI SDK 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 GeoFRED — Regional Economic Data with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Draw Regional Maps in Real-Time

Get a GeoJSON shape file for any U.S. county, state, or metro area using the `get_geo_shapes` tool. Your user sees the map outline appear instantly in their browser, not after some progress bar finishes. This isn't about waiting for a full API response to download. The Vercel AI SDK streams the shape data from this MCP server directly into your React components. That's how you build an app that feels faster and more interactive than anything that relies on old-school fetch requests.

Populate Live Data Dashboards

Once your map is drawn, use `get_regional_data` to pull the latest unemployment, income, or GDP numbers for that specific area. Your AI client gets the data from the FRED database and streams it right into your UI. Imagine a user selecting a state and watching the county-level stats fill in, one by one, right before their eyes. That’s what happens when your frontend has a direct line to the data source. You're not just showing data; you're showing the data as it arrives.

Discover Data Sources on the Fly

Let your users explore what’s possible without you hardcoding every option. Feed a series ID like 'UNRATE' into `get_series_group` to see what geographic levels are available for it—states, counties, MSAs, etc. Your AI client can use this info to dynamically build a UI. It allows your app to show users that they can pull median income for metro areas or population density for specific counties, all based on what the FRED GeoFRED source says is available right now.

Setup guide

Set up FRED GeoFRED — Regional Economic Data MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all FRED GeoFRED — Regional Economic Data tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent FRED GeoFRED — Regional Economic Data transactions",
});

console.log(text);
await mcpClient.close();

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 GeoFRED — Regional Economic Data 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 GeoFRED — Regional Economic Data MCP in Vercel AI SDK

Install the `@ai-sdk/mcp` package, then use `createMCPClient` with the unique Vinkius URL for this server. Pass the resulting tools from `mcpClient.tools()` into your `streamText` or `generateText` call. It's designed to fit right into your existing AI SDK code.

Yes. You can have your AI client call `get_geo_shapes` and `get_regional_data` in parallel. The Vercel AI SDK handles the multiple data streams, so you can render the map outline and populate a data table simultaneously for a really responsive user experience.

You can access a wide range of U.S. regional economic data. This includes unemployment rates, GDP, and median income for states, counties, and Metropolitan Statistical Areas (MSAs), plus geographic shapefiles for mapping them.

Yes, the MCP client is compatible with Vercel Edge Functions. You can perform the data lookups at the edge, closer to your users and the data source, which reduces latency for an even faster-feeling application.

Your Vercel AI SDK app only requests the specific economic data series and geographic shapefiles you ask for. This MCP server processes the request and returns only that data. Your Vinkius endpoint token is the only credential needed, and the server itself is ephemeral.

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