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