`usa_award_search`

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

Search federal contract awards by keywords, agency, date range, or industry code (e.g., ‘541511’ for IT consulting). Returns recipient, award amount, dates, and contract type.

Parameters

Name	Type	Required	Description
`keywords`	array	yes	Search keywords (e.g., [“cybersecurity”, “cloud”])
`items`	string	no
`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