How to Use the BEA (Bureau of Economic Analysis) MCP in OpenAI Agents SDK

Q: How do I connect the BEA (Bureau of Economic Analysis) data to my OpenAI Agents SDK project?

Just pip install openai-agents and point the MCPServerStreamableHttp client to the Vinkius endpoint URL. Pass the server instance to your Agent constructor. The tools are discovered automatically.

Q: Can my OpenAI Agent get specific data like quarterly GDP from the BEA (Bureau of Economic Analysis)?

Yes. Your agent can use the getdata tool. You'll specify the dataset, table, frequency, and years as a JSON string to get exactly the GDP numbers you need.

Q: What's the best way for an OpenAI Agent to find the right BEA (Bureau of Economic Analysis) dataset parameters?

Have your agent call getdatasetlist to see what's available, then getparameterlist for the chosen dataset. This interactive discovery process is much more reliable than hardcoding parameter names.

Build production-ready OpenAI Agents that safely pull and analyze official US economic data from the BEA.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BEA (Bureau of Economic Analysis) MCP to OpenAI Agents SDK

Create your Vinkius account to connect BEA (Bureau of Economic Analysis) to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup BEA (Bureau of Economic Analysis) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Specific Economic Data, Safely

This tool connects your agent directly to the Bureau of Economic Analysis API. Use `get_data` to pull specific metrics like GDP, personal income, or industry-specific numbers. No more manual CSV downloads or wrestling with outdated data sources. The real value here is for production agents. You can build specialized agents—one to explore datasets with `get_dataset_list`, another to execute the final query. With the OpenAI Agents SDK, you can enforce guardrails so your agent only pulls from approved NIPA tables, preventing costly or incorrect API calls.

Build Valid BEA Requests Interactively

Your agent doesn't have to guess at API parameters. The `get_parameter_list` tool shows exactly which filters are available for any given BEA dataset, like 'NIPA' or 'Regional'. It’s a straightforward way to see what’s required. From there, `get_parameter_values` lists all valid inputs for a parameter. This lets you create an interactive experience where your agent guides the user to a valid query, step-by-step. It's a solid pattern for building reliable financial reporting or analysis agents with this MCP Server.

Trace Every Data Point with this MCP Server

When your agent uses the `get_data` tool, every action is tracked in the OpenAI dashboard. You get full visibility into the exact parameters sent to the BEA and the raw data that came back. This isn't just for debugging. It's an audit trail. For financial applications where data provenance matters, you have a clear record of your agent's work. This MCP setup gives you the raw economic stats plus the receipts to prove where they came from.

Setup guide

Set up BEA (Bureau of Economic Analysis) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all BEA (Bureau of Economic Analysis) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives BEA (Bureau of Economic Analysis) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate BEA (Bureau of Economic Analysis) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="BEA (Bureau of Economic Analysis) Agent",
            instructions="You have access to BEA (Bureau of Economic Analysis) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BEA (Bureau of Economic Analysis). All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect BEA (Bureau of Economic Analysis) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about BEA (Bureau of Economic Analysis) MCP in OpenAI Agents SDK

Just `pip install openai-agents` and point the `MCPServerStreamableHttp` client to the Vinkius endpoint URL. Pass the server instance to your Agent constructor. The tools are discovered automatically.

Yes. Your agent can use the `get_data` tool. You'll specify the dataset, table, frequency, and years as a JSON string to get exactly the GDP numbers you need.

Have your agent call `get_dataset_list` to see what's available, then `get_parameter_list` for the chosen dataset. This interactive discovery process is much more reliable than hardcoding parameter names.

It's as current as the BEA's official API. This MCP tool connects directly, so when the Bureau publishes new data, your agent gets it immediately.

The only data sent to the Vinkius MCP endpoint are the specific dataset and parameter requests your agent makes, like a request for 'NIPA' data for '2023'. Your prompts and other agent data are not exposed to this server. The connection is ephemeral and secured by your unique endpoint token.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript