AwardCast Federal Contracts

Search AwardCast's US federal contracting record: buying agencies, federal contractors, and solicitations open right now. Call this first for any question about who buys, who sells, or what is open in US federal procurement. Returns results with an id and a citable URL; pass the id to the fetch tool to open the full record.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search term: an agency name (\"Department of Veterans Affairs\"), a company name, a NAICS code (\"541519\"), a solicitation number, or a word from the work itself (\"stucco\")."
    },
    "limit": {
      "default": 20,
      "description": "How many results to return, 1 to 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Opaque id; pass it unchanged to the fetch tool."
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "Public canonical URL, used as the citation."
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Open the full record behind an id returned by search: an agency profile with price by category and its top winners, a contractor's award history, or a solicitation with its scope and deadline. Call this whenever you need the detail behind a search result, and always before citing a number.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The exact id returned by search, unchanged."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string",
      "description": "The complete record, as prose."
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url",
    "metadata"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Accuracy scorecard for AwardCast's forecasts, scored against the real contract value once FPDS publishes it. Call this when the user asks whether the forecasts are reliable, what the margin of error is, or wants evidence before trusting a number. Returns coverage and median error by value band, including where the model is weakest.

{
  "type": "object",
  "properties": {}
}

US federal solicitations OPEN right now, from SAM.gov, each with the buying agency, the NAICS code and the place of performance. Call this when the user asks what is open, hunts for opportunities in a sector or agency, or wants to know what they can bid on. Does not return a price forecast: for that, point the user to https://awardcast.ai/pricing.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "How many solicitations to return, 1 to 50. Use 5 to 10 for an exploratory question, and the ceiling only when the user asked for the full list.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

US federal contracts nearing expiry that are likely to be recompeted, i.e. opportunities BEFORE they become a published solicitation. Each carries the incumbent and the current contract value. Call this when the user plans pipeline, asks what is coming, or wants to position ahead of competitors. Distinct from open_solicitations, which is already open for bids today.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "How many contracts to return, 1 to 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Buying profile of a US federal agency: how many contracts it awards, how much it obligates, what share is competed, the typical price per NAICS category, its largest contractors, and which of its contracts expire soon. Call this when the user asks how an agency buys, what it pays, or who already sells to it.

{
  "type": "object",
  "properties": {
    "agency": {
      "type": "string",
      "minLength": 1,
      "description": "The agency name (\"Department of Veterans Affairs\") or its slug (\"department-of-veterans-affairs\"). Both work."
    }
  },
  "required": [
    "agency"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Federal award history of a contractor: how many contracts it has won, total obligated, median win value, which agencies it sells to, its recent awards, and its set-aside status (small business, 8(a), HUBZone, WOSB, SDVOSB). Call this when the user asks about a competitor, about the incumbent on a contract, or who has already won in a given market.

{
  "type": "object",
  "properties": {
    "uei": {
      "type": "string",
      "minLength": 1,
      "description": "The company UEI (SAM.gov 12-character identifier, e.g. \"W52ZM2KUANR3\"). If you only have the name, find the UEI with the search tool first."
    }
  },
  "required": [
    "uei"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Historical closing-price range for an agency and NAICS category pair: the 10th percentile, median and 90th percentile of contracts already awarded, plus the average number of competing offers. Call this when the user asks what a contract in this market usually goes for, or wants a benchmark before pricing a bid. This is aggregated HISTORY, not a forecast: the forecast for a specific solicitation is paid, at https://awardcast.ai/pricing.

{
  "type": "object",
  "properties": {
    "agency": {
      "type": "string",
      "minLength": 1,
      "description": "Agency name as it appears in USASpending, e.g. \"Department of Defense\"."
    },
    "naics": {
      "type": "string",
      "minLength": 2,
      "description": "Six-digit NAICS code, e.g. \"541519\"."
    }
  },
  "required": [
    "agency",
    "naics"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}