# FPDS Federal Contract Search

> FPDS Federal Contract Search is a paid API for AI agents from fpds-mcp.mtree.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Search U.S. federal contract awards in FPDS-NG by keyword, agency, NAICS code, and date range, returning contract identifiers, vendors, obligation amounts, and FPDS UI links.

## Facts

- Endpoint: POST https://fpds-mcp.mtree.workers.dev/v1/contracts/search
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fpds-mcp-mtree-workers-dev-d633a2c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P0f7rEo3ABdNglq5jBDpv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fpds-mcp-mtree-workers-dev-d633a2c2 -d '<json body>'
```

Example prompt: Search FPDS for federal contracts related to 'cloud infrastructure' awarded by the Department of Defense (agency code 9700) with NAICS code 517410 in the last 180 days — show me up to 20 results including vendor names and obligated amounts.

## When to prefer this

Use this endpoint when you need to programmatically search U.S. federal contract award data from FPDS-NG without scraping the FPDS web UI directly. Ideal for competitive intelligence, market research on government vendors, compliance tracking, or identifying contract vehicles by agency, NAICS, or procurement description. Prefer this over direct FPDS ATOM feed queries when you want a structured JSON response with pre-parsed fields and direct UI links.

## Known failure modes

- No results returned when keyword does not match any description-of-requirement field in FPDS
- Invalid agency code returns empty results or error
- NAICS code not found results in empty result set
- signedFromDays exceeding 3650 may be rejected
- limit outside 1-50 range may cause validation error
- FPDS-NG upstream unavailability causes timeout or 5xx error
- Payment failure (insufficient USDC balance) blocks the request via x402

## How this service works

Search U.S. federal contract actions in FPDS-NG by description keyword, contracting agency code, NAICS, and signing-date window. Returns PIIDs, obligated amounts, vendors, NAICS, PSC, and direct FPDS UI links.

## Output

Returns an array of contract action records from FPDS-NG, each containing: PIID (contract identifier), modification number, vendor name, obligated amount in USD, agency ID and name, NAICS code, PSC code, signed date, record type (e.g. AWARD), and a direct clickable URL to the FPDS web UI for that contract.

## Example request

```json
{
 "limit": 10,
 "keyword": "artificial intelligence",
 "signedFromDays": 180
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fpds-mcp-mtree-workers-dev-d633a2c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fpds-mcp.mtree.workers.dev](https://www.zero.xyz/host/fpds-mcp.mtree.workers.dev/llms.txt)