Skip to content
Eden Engine

US Federal Contract Awards Search (FPDS)

fpds/search-awards

Searches US federal contract awards in the Federal Procurement Data System (FPDS) for awards signed on or after 4 April 2022, by words in the award record such as a vendor name, an agency or a contract description, and returns ten awards a page (use `nextStart` to read on). Each award holds the awarding agency, the contracting agency, the vendor's legal name and Unique Entity ID (UEI), the contract number (PIID), the dates signed, effective and current completion, the obligation of this action, the total obligation and the total value, and the description of the requirement. Vendor addresses, phone numbers and other registration details are not returned. A search with no match returns an empty list. U.S. federal government data from the General Services Administration; served by Eden Engine; not an official GSA or FPDS product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Federal Procurement Data System (GSA)

Source: Federal Procurement Data System (FPDS), U.S. General Services Administration (https://www.fpds.gov). U.S. federal government data. Served by Eden Engine; not an official GSA or FPDS product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "fpds/search-awards" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "fpds/search-awards" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "fpds/search-awards", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "fpds/search-awards", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 25, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9 .,&'-]{1,99}$",
      "description": "Words to find in award records, for example boeing, lockheed martin or a contract number. Letters, digits, spaces and . , & ' - only; the first character must be a letter or digit. Awards signed before 4 April 2022 are never returned."
    },
    "start": {
      "type": "integer",
      "default": 0,
      "maximum": 100000,
      "minimum": 0,
      "multipleOf": 10,
      "description": "Offset of the first award, a multiple of 10 (default 0). Use `nextStart` from the previous answer."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "start",
    "count",
    "awards"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "description": "Awards in this answer (at most 10)."
    },
    "start": {
      "type": "integer",
      "description": "Offset of the first award in this answer."
    },
    "awards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "uei": {
            "type": "string",
            "description": "The vendor's Unique Entity ID."
          },
          "piid": {
            "type": "string",
            "description": "Procurement instrument identifier (contract number) of the award."
          },
          "title": {
            "type": "string",
            "description": "The source's one-line summary, for example DELIVERY ORDER 0001 awarded to BOEING COMPANY, THE, was modified for the amount of $0."
          },
          "agency": {
            "type": "string",
            "description": "Awarding agency name."
          },
          "idvPiid": {
            "type": "string",
            "description": "Contract number of the indefinite-delivery vehicle the award was placed under, when there is one."
          },
          "modNumber": {
            "type": "string",
            "description": "Modification number of this action; 0 for the original."
          },
          "signedDate": {
            "type": "string",
            "description": "Date the action was signed (YYYY-MM-DD); never earlier than 2022-04-04."
          },
          "totalValue": {
            "type": "number",
            "description": "Total contract value including all options, in dollars."
          },
          "vendorName": {
            "type": "string",
            "description": "Vendor's name as registered."
          },
          "description": {
            "type": "string",
            "description": "Description of the requirement as the contracting officer wrote it."
          },
          "effectiveDate": {
            "type": "string",
            "description": "Date the action took effect (YYYY-MM-DD)."
          },
          "recordModified": {
            "type": "string",
            "description": "When FPDS last modified the record (YYYY-MM-DDTHH:MM:SS, Eastern time)."
          },
          "totalObligation": {
            "type": "number",
            "description": "Total dollars obligated on the contract to date."
          },
          "actionObligation": {
            "type": "number",
            "description": "Dollars obligated by this action (may be negative or zero)."
          },
          "contractingAgency": {
            "type": "string",
            "description": "Name of the agency whose office signed the contract."
          },
          "currentCompletionDate": {
            "type": "string",
            "description": "Current completion date (YYYY-MM-DD)."
          }
        },
        "additionalProperties": false
      },
      "description": "The awards, in the source's order."
    },
    "lastStart": {
      "type": "integer",
      "description": "Offset of the last page; absent when there is no result."
    },
    "nextStart": {
      "type": "integer",
      "description": "Offset to ask for the next page; absent on the last page."
    }
  },
  "additionalProperties": false
}