How to Use the USAspending (Federal Spending) MCP in OpenAI Agents SDK

Q: Can I use USAspending (Federal Spending) data with OpenAI Agents SDK for time tracking?

Absolutely. The searchspendingovertime tool aggregates transaction amounts over specific periods. This means your agent can build reports that track spending trends year-over-year or quarter-by-quarter.

Q: How does USAspending (Federal Spending) help with recipient identification using OpenAI Agents SDK?

You can list all recipients via listrecipients or get deep details on specific entities using getrecipient. This is crucial when your agent needs to confirm who received the federal funds.

Build production-grade federal spending analysis agents with OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect USAspending (Federal Spending) MCP to OpenAI Agents SDK

Create your Vinkius account to connect USAspending (Federal Spending) 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 USAspending (Federal Spending) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track agency budgets and obligations.

Get a summary of transactions and current obligations for any specific government agency using `get_agency_awards`. You can also check historical budget data, running reports on budgetary resources and obligations by fiscal year with `get_agency_budgetary_resources`. This lets your agent build detailed spending profiles. It's perfect for systems that need to know exactly how much money an agency has set aside versus what it's actually obligated to spend.

Search and visualize spending patterns.

Need to see where the federal money is going? Use `search_spending_by_geography` to filter transactions by state, county, or congressional district. You can also track aggregated transaction amounts over time using `search_spending_over_time`. These tools allow your agent to build visualizations and reports that show spending concentrations. It moves beyond simple totals; you get spatial and temporal data points.

Get comprehensive award details.

Don't just look at the total number of awards. Use `get_award` to pull all the specific details for a single federal grant or contract. You can also map out related spending using `get_subawards`, which lists sub-agencies and offices with obligated amounts. Your agent uses this data to trace funds from the primary award down through its entire chain of obligation, giving full visibility into the money trail.

Setup guide

Set up USAspending (Federal Spending) 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 USAspending (Federal Spending) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives USAspending (Federal Spending) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate USAspending (Federal Spending) 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="USAspending (Federal Spending) Agent",
            instructions="You have access to USAspending (Federal Spending) 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 USAspending. 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 USAspending (Federal Spending) 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 USAspending (Federal Spending) MCP in OpenAI Agents SDK

Your agent treats the MCP Server as a set of callable tools. When you ask it to 'find spending in Texas,' your AI client automatically invokes `search_spending_by_geography` and feeds you the results, keeping everything inside its guardrails.

Absolutely. The `search_spending_over_time` tool aggregates transaction amounts over specific periods. This means your agent can build reports that track spending trends year-over-year or quarter-by-quarter.

This server handles award details, transaction records, and budgetary resources. Specifically, you're dealing with federal account information, agency funding levels, and detailed spending amounts.

You can list all recipients via `list_recipients` or get deep details on specific entities using `get_recipient`. This is crucial when your agent needs to confirm who received the federal funds.

The server touches data regarding award details, transactions, and budgetary resources. The built-in guardrails ensure that actions are validated before execution.

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