BEA (Bureau of Economic Analysis) MCP Server

Access U.S. economic data including GDP, personal income, regional economics, and industry statistics.

Data Available

• GDP - Gross Domestic Product (national and by state)
• Personal Income - Income by state, county, and metro area
• Regional Economic Accounts - State and local economic indicators
• Industry Data - GDP by industry sector
• International Trade - Trade statistics

Setup

1. Get a free API key at: https://apps.bea.gov/api/signup/
2. Add to your MCP config:

{
  "bea": {
    "command": "node",
    "args": ["/path/to/bea/dist/index.js"],
    "env": {
      "BEA_API_KEY": "your-api-key"
    }
  }
}

Tools

list_datasets

List all available BEA datasets.

Returns: NIPA, Regional, GDPbyIndustry, International, etc.

get_parameters

Get required parameters for a specific dataset.

Parameter	Required	Description
dataset	Yes	Dataset name (e.g., "Regional", "NIPA")

get_parameter_values

Get valid values for a dataset parameter.

Parameter	Required	Description
dataset	Yes	Dataset name
parameter	Yes	Parameter name (e.g., "TableName", "LineCode", "GeoFips")

Example: Get available tables in Regional dataset

dataset: "Regional"
parameter: "TableName"

query

Fetch BEA data with full parameter control.

Parameter	Required	Description
dataset	Yes	Dataset name
tableName	Varies	Table identifier
lineCode	Varies	Line code for specific series
geoFips	Varies	Geographic FIPS codes
year	Varies	Year(s) - single, comma-separated, or "ALL", "LAST5"
frequency	Varies	A (annual), Q (quarterly), M (monthly)
industry	Varies	Industry code (for GDP by Industry)

get_regional_income

Shortcut for personal income data by state/county.

Parameter	Required	Description
geoFips	Yes	"STATE" for all states, "COUNTY" for all counties, or specific FIPS
year	Yes	Year(s)
lineCode	No	1=Total income, 2=Per capita income, 3=Population

Example: Get per capita income for all states, last 5 years

geoFips: "STATE"
year: "LAST5"
lineCode: "2"

get_gdp_by_state

Shortcut for state-level GDP data.

Parameter	Required	Description
geoFips	Yes	"STATE" or specific FIPS codes
year	Yes	Year(s)
industry	No	"ALL" for total, or specific NAICS

Example: Get GDP for California and Texas

geoFips: "06000,48000"
year: "2022,2023"
industry: "ALL"

Common Line Codes (Regional Income)

Code	Description
1	Total Personal Income
2	Per Capita Personal Income
3	Population
10	Wages and Salaries
45	Dividends, Interest, Rent
50	Transfer Receipts

Rate Limits

• 100 requests per minute
• 100 MB data per minute

Documentation

• API Documentation: https://apps.bea.gov/api/
• Data Tables: https://www.bea.gov/data