README.md
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
- Get a free API key at: https://apps.bea.gov/api/signup/
- 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
Tools 6
list_datasetsList all available BEA datasets.get_parametersGet required parameters for a specific dataset.get_parameter_valuesGet valid values for a dataset parameter.queryFetch BEA data with full parameter control.get_regional_incomeShortcut for personal income data by state/county.get_gdp_by_stateShortcut for state-level GDP data.Environment Variables
BEA_API_KEYrequiredAPI key obtained from the BEA websiteTry it
→What are the available datasets I can query from the BEA?
→Get the per capita personal income for all states for the last 5 years.
→Retrieve the GDP data for California and Texas for 2022 and 2023.
→List the valid table names for the Regional dataset.
→What is the total personal income for my state over the last 5 years?