FRED GeoFRED Regional Data MCP. Map Economic Trends Across US Geography.
FRED GeoFRED — Regional Economic Data connects your AI client to comprehensive U.S. economic metrics. It provides unemployment, income levels, and GDP data broken down by state, county, MSA, or Federal Reserve District. Get cross-sectional regional comparisons and necessary geographic boundaries for detailed analysis.
Give Claude and any AI agent real-world access
Retrieve the GeoJSON shape files needed for mapping data across specific U.S. regions.
Check which types of geographic breakdowns (like state or county) exist for a given economic metric.
Fetch specific regional economic data points, such as unemployment rates or income levels, broken down by geography.
Ask an AI about this
Waiting for input…
What AI agents can do with FRED GeoFRED Regional Economic Data - 3 Tools
Use these tools to discover available regions for any metric, pull cross-sectional data across US geography, and retrieve the necessary map boundaries.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using FRED GeoFRED — Regional Economic Data MCPGet Regional Data
Retrieves cross-sectional regional economic data for specified U.S. areas like states or counties.
Get Series Group
Determines the available region types and units for any given FRED series ID to...
Get Geo Shapes
Downloads standardized geographic shape files, including boundaries for counties and...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with FRED GeoFRED — Regional Economic Data, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Comparing US regions used to be a spreadsheet nightmare.
If you work in location intelligence or policy, you know the drill: You pull a national metric for unemployment. Then, you have to open 20 different tabs and download regional breakdowns—one sheet per state, another for counties, another for MSAs. Copy-pasting these numbers into a master Excel sheet is tedious, error-prone work that takes hours.
With this MCP, your agent handles the complexity. You tell it you need unemployment data broken down by MSA; the agent finds the right series group, pulls all the regional metrics, and provides clean, structured data ready for immediate comparison.
get_geo_shapes gives you map boundaries instantly.
The hardest part of mapping is getting the correct shape files. Manually sourcing GeoJSON for 50 states, 3000 counties, and various MSAs and ensuring they all align is a massive data engineering lift that usually stalls projects.
Now, your agent uses get_geo_shapes to pull standardized boundary data instantly. The result isn't just clean coordinates; it’s the ready-to-use foundation for any complex visualization you build.
What FRED GeoFRED Regional Data MCP does for your AI
If you're building a dashboard that needs to show how economics play out across the country, this MCP is what you need. It takes standard national economic time series data—like unemployment rates or median income—and breaks it down into specific geographical regions. You can pull regional snapshots for any U.S. area type, including states, counties, and metro areas.
Plus, it gets you the GeoJSON-compatible shape files required to actually map that data visually. When your agent needs to compare performance across different geographic boundaries or build a spatial analysis piece, this MCP makes that possible. You'll connect through Vinkius, giving your AI client access to thousands of other specialized tools alongside these economic datasets.
019d759f-1813-70da-b02a-9fdb79346965 How to set up FRED GeoFRED Regional Data MCP
The bottom line is that you guide your AI client through three specific calls: discovery of available regions, retrieval of regional metrics, and fetching the map boundaries.
First, use the get_series_group tool with a FRED series ID (like UNRATE) to figure out what geographic breakdowns and data units are available.
Next, call get_regional_data. This sends the specific metric, the desired region type (e.g., county), and any necessary filters for your agent to pull the actual cross-sectional numbers.
Finally, if you need to plot this data visually, use get_geo_shapes to retrieve the corresponding boundary files needed for mapping.
Who uses FRED GeoFRED Regional Data MCP
This MCP serves real estate analysts and economic policy makers who deal with location intelligence daily. If you're tired of manually pulling data from different spreadsheets or dashboards to compare an MSA's income against a county's unemployment rate, this is for you.
Compares historical economic metrics across state lines, using the MCP to pull cross-sectional data sets that would otherwise require multiple manual database queries.
Builds geographic dashboards by pairing regional economic indicators with shape files to visualize trends like median income variation across counties.
Gathers diverse data points—like unemployment and poverty rates—for specific Federal Reserve Districts (FRB) to inform policy recommendations.
Benefits of connecting FRED GeoFRED Regional Data MCP
See regional snapshots of key metrics. You can pull specific data like unemployment, income levels, or poverty rates for any state, county, or MSA using get_regional_data.
Validate your data scope instantly. Before pulling figures, use get_series_group to confirm exactly what geographic breakdowns exist for a given economic indicator and its units.
Build professional maps quickly. The MCP provides necessary GeoJSON-compatible shape files via get_geo_shapes, allowing you to visualize regional boundaries alongside the pulled metrics.
Compare performance across diverse areas. This tool lets you compare regions from various groupings (like BEA or FRB) without switching data sources or spreadsheets.
Avoid data gaps in your reports. By checking available region types through get_series_group, you ensure your agent doesn't miss necessary geographic scope when running analyses.
FRED GeoFRED Regional Data MCP use cases
A Housing Market Analysis
A real estate consultant needs to compare median income across three specific metro areas (MSAs) and see which one has the lowest housing price index. The agent first uses get_series_group to validate the data, then calls get_regional_data for the metrics, and finally asks for get_geo_shapes to create a visual comparison map.
Policy Briefing on Unemployment
A policy advisor needs to show the difference in unemployment rates between states versus counties. The agent uses get_series_group to confirm both region types are available, then runs get_regional_data twice—once for the state level and once for the county level—to create a comprehensive report.
Academic Research on Poverty
A researcher needs standardized boundaries for mapping poverty rates across all 50 states. The agent first uses get_series_group to validate the 'poverty' series, then calls get_geo_shapes to get the state outlines, and finally runs get_regional_data to populate the metrics.
Inter-State Business Comparison
A corporate strategy team wants to compare GDP growth across different Federal Reserve Districts (FRB). The agent uses get_series_group to confirm FRB is a valid region type, then calls get_regional_data for the specific time period and district grouping.
FRED GeoFRED Regional Data MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Assuming data exists by default
Trying to run regional analysis directly without knowing if the metric supports county-level breakdowns. This often results in partial or incorrect national averages being returned.
Always start with get_series_group. It confirms the series ID and tells you exactly which region types (county, msa, state) are supported before attempting to use get_regional_data.
Using the wrong geographic scope
Pulling data for a metro area (MSA) when the analysis actually requires only state-level data. This mixes metrics and makes comparisons inaccurate.
Use get_series_group first to see if your target region type is 'msa' or 'state'. Then, specify that exact scope in your call to get_regional_data.
Forgetting the map boundaries
Getting a list of numbers for various regions but having no way to visualize where those regions actually are on a map.
After getting the regional data, run get_geo_shapes. This provides the necessary GeoJSON files so your agent can build accurate choropleth maps.
When to use FRED GeoFRED Regional Data MCP
Use this MCP if your core need is to compare economic performance (like income or unemployment) across different defined geographical boundaries—be it a county, state, or metro area. You must be working with data that requires spatial context for analysis.
Don't use it if you just need a single national time series value (e.g., the national average GDP). For simple point-in-time metrics across the whole country, other general economic tools might suffice. Also, if your goal is purely structural database modeling without needing geographic boundaries, this MCP adds unnecessary complexity.
If you need to pull data and map it, use get_regional_data combined with get_geo_shapes. If you're just figuring out what metrics are even available for a region type, start with get_series_group.
Frequently asked questions about FRED GeoFRED Regional Data MCP
How do I know if a metric is available by county using get_series_group? +
You run get_series_group with the desired FRED series ID. The resulting metadata will list all supported region types, confirming whether 'county' or other local breakdowns are valid for that specific metric.
What if I need to compare data across different regions like BEA and FRB? +
You can use get_regional_data multiple times. You just need to confirm the region type (bea or frb) is valid for your metric first, using get_series_group.
Does FRED GeoFRED support international data? +
No, this MCP is specialized for U.S. internal economics. It supports US region types like state, county, and MSA, but not global country comparisons.
Can I get the boundaries for multiple regions at once with get_geo_shapes? +
Yes, you specify the desired shape type (e.g., 'state' and 'county') in a single call to get_geo_shapes, ensuring consistency across your mapping project.
What kind of data can I pull using get_regional_data? +
You can retrieve various cross-sectional economic metrics including unemployment, median income, poverty rates, and GDP breakdowns for specific US regions.