BEA (Bureau of Economic Analysis)

Provides access to BEA data such as GDP, personal income, regional economics, and industry statistics via an MCP server.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a local BEA MCP Server to access U.S. economic data such as GDP, personal income, regional indicators, and industry statistics. This MCP server lets you query BEA data through a simple, configurable interface and exposes a set of tools to discover datasets, parameters, and actual data programmatically.

How to use

You install and run the BEA MCP Server locally, then connect your MCP client to it using the configuration you provide. Start the server with your API key and use the exposed tools to list datasets, fetch parameter values, and query BEA data by dataset, geography, year, and other refinements. Use the results to build dashboards, analyses, or data-driven applications that rely on BEA data.

How to install

Prerequisites you need before starting are Node.js installed on your system and access to a BEA API key.

Prepare your BEA API key by signing up at BEA API sign-up page.
Create or edit your MCP configuration to run the BEA MCP Server locally. Use the following snippet as your configuration.

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

Additional configuration and usage notes

The BEA MCP Server exposes several tools to interact with BEA data. You can discover datasets, inspect required parameters, fetch valid values for parameters, and perform full data queries.

Available tools

list_datasets

List all available BEA datasets such as NIPA, Regional, GDPbyIndustry, International, etc.

get_parameters

Retrieve required parameters for a specific dataset, helping you understand what inputs are needed.

get_parameter_values

Fetch valid values for a chosen dataset parameter to construct valid queries.

query

Fetch BEA data with full parameter control, including dataset, tableName, lineCode, geoFips, year, frequency, and industry.

get_regional_income

Shortcut to obtain personal income data by state or county, with options for year and lineCode.

get_gdp_by_state

Shortcut to retrieve state-level GDP data, with optional industry filtering.