`usa_award_search`

Pack: usaspending · Endpoint: https://gateway.pipeworx.io/usaspending/mcp

Search US federal PROCUREMENT CONTRACTS / government contract awards for goods and services — by keywords, state where the work is performed, awarding agency, date range, or NAICS industry code (e.g., ‘541511’ for IT consulting). Answers “find procurement contracts in ”, “government contracts for ”, “federal awards to companies in Maryland”. Returns recipient, award amount, dates, and contract type.

Parameters

Name	Type	Required	Description
`keywords`	array	yes	Search keywords (e.g., [“cybersecurity”, “cloud”] or [“goods”, “services”])
`items`	string	no
`state`	string	no	Place-of-performance US state, 2-letter code (e.g., “MD”, “TX”). Filters to contracts performed in that state.
`agency`	string	no	Awarding agency name (e.g., “Department of Defense”)
`start_date`	string	yes	Start date in YYYY-MM-DD format
`end_date`	string	yes	End date in YYYY-MM-DD format
`naics`	string	no	NAICS code to filter by (e.g., “541512”)
`set_aside`	string	no	Set-aside type filter
`limit`	number	no	Number of results (1-100, default 10)

Example call

Arguments

{
  "keywords": [
    "cybersecurity"
  ],
  "start_date": "2024-01-01",
  "end_date": "2024-12-31"
}

curl

curl -X POST https://gateway.pipeworx.io/usaspending/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"usa_award_search","arguments":{"keywords":["cybersecurity"],"start_date":"2024-01-01","end_date":"2024-12-31"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('usa_award_search', {
  "keywords": [
    "cybersecurity"
  ],
  "start_date": "2024-01-01",
  "end_date": "2024-12-31"
});

More examples

{
  "keywords": [
    "cloud",
    "infrastructure"
  ],
  "agency": "Department of Defense",
  "start_date": "2023-01-01",
  "end_date": "2024-12-31",
  "naics": "541512",
  "limit": 25
}

Response shape

Always returns: total_results, limit, awards

Field	Type	Description
`total_results`	number	Total number of matching awards
`limit`	number	Number of results returned
`awards`	array	List of matching contract awards

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_results": {
      "type": "number",
      "description": "Total number of matching awards"
    },
    "limit": {
      "type": "number",
      "description": "Number of results returned"
    },
    "awards": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "award_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unique award identifier"
          },
          "recipient_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the contractor/recipient"
          },
          "award_amount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total award amount in dollars"
          },
          "total_outlays": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total amount paid out"
          },
          "start_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Award start date"
          },
          "end_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Award end date"
          },
          "awarding_agency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the awarding agency"
          },
          "awarding_sub_agency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sub-agency that awarded the contract"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Award description"
          },
          "naics_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "NAICS industry code"
          },
          "contract_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Type of contract award"
          }
        },
        "required": [
          "award_id",
          "recipient_name",
          "award_amount",
          "total_outlays",
          "start_date",
          "end_date",
          "awarding_agency",
          "awarding_sub_agency",
          "description",
          "naics_code",
          "contract_type"
        ]
      },
      "description": "List of matching contract awards"
    }
  },
  "required": [
    "total_results",
    "limit",
    "awards"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "usaspending": {
      "url": "https://gateway.pipeworx.io/usaspending/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

usa_award_search