# FRED GeoFRED MCP for AI Agents AI Agent Connect

> FRED GeoFRED — Regional Economic Data provides direct access to granular economic metrics for U.S. states, counties, and metro areas. It turns national FRED data into geographic snapshots, letting you pull unemployment rates, median incomes, and GDP figures by specific region. It's designed for anyone building geographic economic dashboards or doing location-based analysis.

## Overview
- **Category:** brain-trust
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dQz3eOwtKv9Ev8XPtYBXUvr4NHOeJqxCMzSQWAYm/ai-agent-connect
- **Tags:** regional-economics, geographic-data, demographics, economic-indicators, mapping, spatial-analysis

## Description

FRED GeoFRED turns national economic time series into cross-sectional geographic data. Most economic research starts with a mess of tabs where you're jumping between the FRED website, searching for a series like unemployment, and trying to figure out if they even have a breakdown by county or metro area. This Connector changes that by letting your agent pull regional snapshots directly from the official FRED database. Instead of manually searching for separate datasets, you can ask for specific data points like income, poverty, or housing prices across different geographic boundaries. It handles the heavy lifting of mapping national series to specific regions like BEA areas or Federal Reserve districts. When you use this through the Vinkius catalog, you get a way to bridge the gap between raw economic indicators and spatial analysis. You can grab the actual geographic boundaries needed for maps, too, so you don't have to hunt for GeoJSON files. It's about getting the right numbers for the right place without the usual data-wrangling headache.

## Tools

### get_series_group
Find the correct series group ID and available region types for a specific FRED series ID. Use this to see what geographic breakdowns exist.

### get_regional_data
Pull cross-sectional economic data for specific regions like states, counties, or MSAs. This lets you get localized numbers for your analysis.

### get_geo_shapes
Get geographic shape files and GeoJSON boundaries for mapping different regional types. This saves you from hunting for boundary files.

## Prompt Examples

**Prompt:** 
```
What is the unemployment rate by state?
```

**Response:** 
```
📊 **Unemployment Rate by State (Latest)**

| State | Rate |
|-------|------|
| Nevada | 5.4% |
| DC | 5.2% |
| California | 5.1% |
| ...national avg... | 3.7% |
| South Dakota | 2.0% |
| Vermont | 1.9% |
| North Dakota | 1.8% |

51 regions returned from GeoFRED.
```

**Prompt:** 
```
Compare median household income across metro areas
```

**Response:** 
```
💵 **Median Household Income — Top 5 MSAs**

1. San Jose-Sunnyvale: $145K
2. Washington-Arlington: $118K
3. San Francisco-Oakland: $115K
4. Seattle-Tacoma: $105K
5. Boston-Cambridge: $102K

National median: $75K
```

**Prompt:** 
```
Get the geographic boundaries for U.S. states
```

**Response:** 
```
🗺 **State Boundaries — GeoJSON**

Returned shape data for all 50 states + DC.
Includes: FIPS codes, state names, boundary coordinates.

Use with regional data to build choropleth maps.
```

## Capabilities

### Pull regional economic snapshots
Get specific data like income or unemployment for states, counties, and metro areas.

### Identify geographic breakdowns
Find out which region types are available for any given FRED series.

### Fetch geographic boundaries
Download GeoJSON-compatible shapes for mapping different regions.

## Use Cases

### Comparing metro areas
An analyst wants to see which MSAs have the highest median income for a new retail location.

### State-level unemployment
A policy maker needs a quick snapshot of unemployment rates across all 50 states to identify trends.

### Mapping county GDP
A developer needs GeoJSON boundaries and GDP data to create a choropleth map of a specific state.

### Regional economic trends
A researcher wants to see how housing prices differ between census regions to study migration.

## Benefits

- Skip the manual data hunting by using get_series_group to instantly find the right regional breakdowns for any FRED series.
- Build accurate maps faster by grabbing GeoJSON-compatible boundaries directly via get_geo_shapes.
- Get precise local insights like median income by MSA using get_regional_data instead of relying on broad national averages.
- Save hours of data cleaning because the Connector handles the mapping of national series to specific geographic regions.
- Make better investment decisions by comparing economic performance across different Federal Reserve districts and BEA areas.

## How It Works

The bottom line is you get localized economic data ready for analysis or visualization without the manual research.

1. Enter a FRED series ID like UNRATE into the series group tool to find the correct ID and available regions.
2. Specify the region type you need, such as MSA, county, or state, to pull the data.
3. Get the cross-sectional economic data or geographic shapes for your map.

## Frequently Asked Questions

**Can FRED GeoFRED MCP provide county-level data?**
Yes, it pulls data for counties, MSAs, and even Fed districts. This makes it useful for very granular local analysis.

**Does FRED GeoFRED MCP include map boundaries?**
Yes, it provides GeoJSON-compatible shapes for various regions, which you can use to build maps directly.

**Can I use FRED GeoFRED MCP for real estate analysis?**
It is ideal for that. You can compare median incomes and housing prices across different metro areas to identify trends.

**What regions does FRED GeoFRED MCP cover?**
It covers states, counties, MSAs, BEA areas, and Federal Reserve districts.

**How do I find specific data for a FRED series?**
You can ask the agent to identify the correct series group for any FRED ID to see which regions are available.

**Can FRED GeoFRED MCP help with poverty stats?**
Yes, it can pull poverty data for different geographic regions to help identify underserved areas.

**What is GeoFRED?**
GeoFRED is the geographic extension of FRED. While FRED provides national time series, GeoFRED breaks that data down by state, county, metropolitan area, and Federal Reserve district — enabling regional economic comparisons and choropleth mapping.