# DOD Contracts MCP

> Use the search_contracts tool to query the Federal Procurement Data System (FPDS), giving you direct access to massive government spending records. Filter and analyze Department of Defense (DOD) contracts and federal contract awards using standardized FPDS syntax directly from your AI agent.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** federal-procurement, government-contracts, defense-spending, data-mining, public-records

## Description

Monitoring federal spending used to mean manually navigating complex, siloed government websites. Now, this MCP lets you query the entire Federal Procurement Data System record set right through your AI client. You can track everything from basic procurement actions to major contract awards across all federal agencies. If you need visibility into who's getting paid for defense projects or what specific agency is spending money on cloud infrastructure, this tool delivers the raw data. By connecting it via Vinkius, you get immediate access to thousands of other specialized services alongside government records. You can filter results specifically for the Department of Defense using department or agency codes, making competitor tracking and opportunity identification simple. Just ask your agent to search federal contracts, and it handles the rest.

## Tools

### search_contracts
Searches the federal contracts database using FPDS Atom Feed, allowing you to specify Department IDs (like '9700') or Agency Codes in your query.

## Prompt Examples

**Prompt:** 
```
Search for DOD contracts related to 'cybersecurity' using search_contracts.
```

**Response:** 
```
I've searched the FPDS for DOD cybersecurity contracts. I found several entries, including a recent award for 'Network Defense Services' to CyberCorp and a 'Security Operations' contract for the Air Force. Would you like details on a specific entry?
```

**Prompt:** 
```
Find federal contracts for 'Lockheed Martin' using search_contracts.
```

**Response:** 
```
Querying FPDS for 'Lockheed Martin'... I've retrieved the latest 10 contract actions. They include various aerospace and defense projects across different agencies. Should I list the PIIDs and award amounts for these?
```

**Prompt:** 
```
Get the next 10 results for the DOD 'cloud services' search using search_contracts with start=10.
```

**Response:** 
```
Fetching the next page of results (records 11-20) for DOD cloud services... I've found additional contracts involving cloud migration and infrastructure support. Would you like me to summarize the vendors involved in this batch?
```

## Capabilities

### Track DOD Spending
Isolates records filtered specifically for Department of Defense activity using required departmental identifiers.

### Search by Procurement Syntax
Runs complex queries across the entire FPDS database using established federal search parameters.

### Analyze Historical Trends
Retrieves past contract awards and spending data to identify predictable procurement cycles.

### Process Large Datasets
Handles massive result sets by allowing you to fetch data in manageable batches, avoiding timeouts.

## Use Cases

### Assessing Competitor Movements
A defense firm needs to know what rivals are winning in cybersecurity. They ask their agent to use the search_contracts tool, targeting DOD contracts with 'cybersecurity.' The agent pulls a list of recent awards and award amounts for review.

### Verifying Public Spending
A journalist is researching federal transparency regarding cloud migration. They instruct their agent to run a search_contracts query, focusing on 'cloud services' across multiple agencies to build an article detailing public spending habits.

### Projecting Market Needs
A market analyst wants to predict future defense budgets for networking hardware. They use the MCP to run a search_contracts query over the last five years, analyzing trends in awarded contracts using department IDs.

## Benefits

- Pinpoint specific DOD contracts. Instead of sifting through thousands of irrelevant records, you can filter results directly for the Department of Defense using standard codes and syntax.
- Analyze vendor performance quickly. Use this MCP to track historical spending patterns and identify which contractors repeatedly win bids across different agencies.
- Get raw data for deep analysis. The tool returns structured XML contract entries, perfect for feeding into your own data warehouse or reporting system.
- Manage large queries easily. You don't have to download massive files; the MCP supports pagination, letting you fetch results in smaller, manageable batches of 10.
- Query any federal agency. While it shines on DOD contracts, it allows searching across various agencies using standard FPDS search syntax.

## How It Works

The bottom line is you get immediate access to deep, raw government spending data without needing to know complex database syntax.

1. First, subscribe to this MCP and configure your access credentials within Vinkius.
2. Next, prompt your AI agent with specific search criteria—for example, targeting a specific department ID or agency code.
3. Finally, the tool executes the query against the FPDS feed, returning structured XML data containing contract entries.

## Frequently Asked Questions

**How do I specifically target Department of Defense (DOD) contracts?**
To target DOD contracts, include `DEPARTMENT_ID:"9700"` or `AGENCY_CODE:"9700"` in your `sQuery` parameter when using the `search_contracts` tool.

**Can I paginate through large sets of contract results?**
Yes. The `search_contracts` tool supports a `start` parameter. Results are returned in batches of 10, so you can increment the start number (e.g., 10, 20, 30) to see more records.

**What search syntax should I use for the sQuery parameter?**
The `search_contracts` tool uses the standard FPDS Atom Feed search syntax. You can search by keywords, or use specific fields like `VENDOR_NAME:"Example Corp"` or `PIID:"ContractID"`.

**How do I first set up the connection for `search_contracts`?**
You must configure your access identifier within Vinkius first. Once connected, your AI agent can run `search_contracts` against the live FPDS feed without needing credentials in every prompt.

**What format does `search_contracts` return?**
The tool returns raw XML data containing all contract entries. Your agent reads this structured XML, letting you parse it into clean tables or extract specific data points easily.

**What should I do if `search_contracts` throws an error?**
If the search fails, check your syntax carefully and ensure all required parameters are included. The agent will provide specific error codes detailing exactly what needs fixing for a successful run.

**Are there rate limits when using `search_contracts`?**
While the underlying feed manages throughput, making too many rapid calls might trigger temporary slowdowns. We recommend adding small delays between consecutive `search_contracts` runs to maintain performance.

**Can I filter federal contracts results using `search_contracts` by date range?**
Yes, you can integrate specific date parameters into your sQuery syntax. Use the appropriate date fields to narrow the search window for contract activity within any specified timeframe.