README.md
Access U.S. economic data including GDP, personal income, regional economics, and industry statistics.
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 from https://apps.bea.gov/api/signup/Configuration
claude_desktop_config.json
{
"bea": {
"command": "node",
"args": ["/path/to/bea/dist/index.js"],
"env": {
"BEA_API_KEY": "your-api-key"
}
}
}Try it
→List all available BEA datasets.
→Get required parameters for the Regional dataset.
→Get valid TableName values for the Regional dataset.
→Query per capita personal income for all states over the last 5 years.
→Get GDP for California and Texas in 2022 and 2023.