{"openapi":"3.1.0","info":{"title":"US Federal Spend Intelligence API","version":"0.1.0","description":"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,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://us-spend-intel.connectorbay.com/mcp.\n\nDisclaimer: 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.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/us-spend-intel/docs"},"termsOfService":"https://connectorbay.com/us-spend-intel/terms"},"servers":[{"url":"https://us-spend-intel.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/us-spend-intel/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/autocomplete_recipient":{"post":{"operationId":"autocomplete_recipient","summary":"Find federal award recipients by business name or UEI fragment in USAspending. Use for \"How does USAspending spell Lockh","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search_text":{"description":"Part of a business name or a UEI (2 to 100 characters), for example lockheed martin","title":"Search Text","type":"string"},"limit":{"default":10,"description":"Maximum number of matches, 1 to 25","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["search_text"],"title":"autocomplete_recipientArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_recipients":{"post":{"operationId":"find_recipients","summary":"List recipient records for a business name, UEI or DUNS with recipient_id, UEI and total obligations, largest first. Use","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"description":"Business name, UEI or DUNS to match (2 to 100 characters), for example lockheed martin","title":"Keyword","type":"string"},"award_type":{"default":"contracts","description":"Which awards to total: contracts or grants","title":"Award Type","type":"string"},"limit":{"default":10,"description":"Maximum number of recipient records, 1 to 25","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["keyword"],"title":"find_recipientsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/recipient_profile":{"post":{"operationId":"recipient_profile","summary":"Profile of one business recipient: parent, alternate names, business types, location and obligation totals for a period.","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"recipient_id":{"default":"","description":"recipient_id from find_recipients (a hash ending in -C, -P or -R). Give this or uei, not both","title":"Recipient Id","type":"string"},"uei":{"default":"","description":"12-character UEI, for example ZFN2JJXBLZT3. Give this or recipient_id, not both","title":"Uei","type":"string"},"period":{"default":"latest","description":"latest (USAspending's most recent 12 months), all (all time) or a four-digit fiscal year such as 2025","title":"Period","type":"string"}},"title":"recipient_profileArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/autocomplete_naics":{"post":{"operationId":"autocomplete_naics","summary":"Match plain words or a code fragment to NAICS industry codes as USAspending lists them. Use for \"What is the NAICS code ","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search_text":{"description":"Industry words or a NAICS code fragment (2 to 100 characters), for example computer programming","title":"Search Text","type":"string"},"limit":{"default":10,"description":"Maximum number of matches, 1 to 25","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["search_text"],"title":"autocomplete_naicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/autocomplete_psc":{"post":{"operationId":"autocomplete_psc","summary":"Match plain words or a code fragment to product and service codes (PSC) as USAspending lists them. Use for \"What is the ","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search_text":{"description":"Product or service words or a PSC fragment (2 to 100 characters), for example software","title":"Search Text","type":"string"},"limit":{"default":10,"description":"Maximum number of matches, 1 to 25","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["search_text"],"title":"autocomplete_pscArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/autocomplete_awarding_agency":{"post":{"operationId":"autocomplete_awarding_agency","summary":"Match plain words to awarding agencies and sub-agencies with their USAspending agency ids. Use for \"What is the USAspend","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search_text":{"description":"Agency name words (2 to 100 characters), for example veterans","title":"Search Text","type":"string"},"limit":{"default":10,"description":"Maximum number of matches, 1 to 25","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["search_text"],"title":"autocomplete_awarding_agencyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/award_detail":{"post":{"operationId":"award_detail","summary":"Details for one federal award: amounts, dates, awarding and funding agencies, business recipient, NAICS, product code an","description":"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?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"award_id":{"description":"USAspending generated award id, for example CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-","title":"Award Id","type":"string"}},"required":["award_id"],"title":"award_detailArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}