Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

US Federal Spend Intelligence — connector documentation

  • MCP endpoint: https://us-spend-intel.connectorbay.com/mcp
  • REST API: POST https://us-spend-intel.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://us-spend-intel.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
  • Health: https://us-spend-intel.connectorbay.com/health · Tool schemas: https://us-spend-intel.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/us-spend-intel · agent@connectorbay.com

What US Federal Spend Intelligence is for

US Federal Spend Intelligence reads the public USAspending.gov API (U.S. Department of the Treasury) to help a small business size the federal market. autocomplete_recipient and find_recipients turn a company name, UEI or DUNS into the recipient records USAspending keeps, with recipient_id, UEI and total obligations for contracts or grants. recipient_profile gives one business's profile: parent, alternate names, business types, location and obligation totals for the latest window, a fiscal year or all time. autocomplete_naics, autocomplete_psc and autocomplete_awarding_agency turn plain words into NAICS industry codes, product and service codes and awarding agencies. award_detail returns one award: amounts, dates, agencies, recipient, NAICS, product code, competition fields and subaward totals. Amounts are exact decimal strings of federal obligations as agencies report them, not revenue or payments. Business recipients only: profiles that USAspending flags as individuals are refused, and executive compensation fields are never returned. Every answer names its source and retrieval date and notes that USAspending lags agency reporting. It does not rank recipients by NAICS or agency (see BUILD_NOTES).

Ask your assistant things like:

  • "How does USAspending spell Lockheed Martin's recipient names, what UEI does it have and how much did it receive in federal contracts?"
  • "Give me the federal profile of this competitor: parent company, business types and total obligations."
  • "What is the NAICS code for custom computer programming and the product and service code for software?"
  • "What is the USAspending agency id for the Department of Veterans Affairs and its sub-agencies?"
  • "Show me the details of federal award CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-."

What it does

  • autocomplete_recipient: Find federal award recipients by business name or UEI fragment in USAspending (names as USAspending spells them).
  • find_recipients: List recipient records for a name, UEI or DUNS with recipient_id, UEI and total obligations, largest first.
  • recipient_profile: Profile of one business recipient: parent, business types, location and obligation totals for a period.
  • autocomplete_naics: Match plain words or a code fragment to NAICS industry codes as USAspending lists them.
  • autocomplete_psc: Match plain words or a code fragment to product and service codes (PSC) as USAspending lists them.
  • autocomplete_awarding_agency: Match plain words to awarding agencies and their USAspending agency ids.
  • award_detail: Details for one federal award by its generated award id: amount, dates, agencies, recipient, NAICS and product code.

Data sources

Reference data from official sources (api.usaspending.gov); every answer states its source, date and validity period.

What it is not

US Federal Spend Intelligence is independent; not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Names of rails, schemes and standards are used only to say what a tool works with. It is read-only: it never sends, pays, files or signs anything for you, and it never looks up private individuals.

Not advice. General information only, not legal, contracting or financial advice. US Federal Spend Intelligence is an independent tool: it is not affiliated with, endorsed by or operated by USAspending.gov, the U.S. Department of the Treasury, the General Services Administration or any other government body. Figures are federal obligations as agencies report them to USAspending, which lags reporting and can be revised; they are not company revenue or payments received. Check the cited official source before you rely on a result.

Built for: United States. Languages: English.

Tools

Find businesses and profiles

autocomplete_recipient — Find federal award recipients by business name or UEI fragment in USAspending. Use for "How does USAspending spell Lockheed Martin?" or "Which recipient names in USAspending contain aerospace?". Args: search_text, limit.

find_recipients — List recipient records for a business name, UEI or DUNS with recipient_id, UEI and total obligations, largest first. Use for "What UEI does Lockheed Martin have in USAspending and how much did it receive in federal contracts?" or "Which recipient records match this competitor's name?". Args: keyword, award_type, limit.

recipient_profile — Profile of one business recipient: parent, alternate names, business types, location and obligation totals for a period. Business recipients only. Use for "Give me the federal profile of this competitor: parent company, business types and total obligations" or "Who is the parent of the recipient with UEI ZFN2JJXBLZT3?". Args: recipient_id, uei, period.

Codes and agencies

autocomplete_naics — Match plain words or a code fragment to NAICS industry codes as USAspending lists them. Use for "What is the NAICS code for custom computer programming?" or "Which NAICS codes mention janitorial?". Args: search_text, limit.

autocomplete_psc — Match plain words or a code fragment to product and service codes (PSC) as USAspending lists them. Use for "What is the product and service code for software?" or "Which PSC codes cover janitorial services?". Args: search_text, limit.

autocomplete_awarding_agency — Match plain words to awarding agencies and sub-agencies with their USAspending agency ids. Use for "What is the USAspending agency id for the Department of Veterans Affairs?" or "Which sub-agencies does USAspending list for Labor?". Args: search_text, limit.

Award details

award_detail — Details for one federal award: amounts, dates, awarding and funding agencies, business recipient, NAICS, product code and competition fields. Use for "Show me the details of federal award CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-" or "Who was the awarding office and what was the NAICS code of this contract?". Args: award_id.

Conventions

  • Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
  • Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
  • Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/us-spend-intel/support