# 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:

```json
{
  "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