# ERS USDA MCP for AI Agents AI Agent Connect

> ERS USDA MCP gives your AI agent direct access to the USDA's Agricultural Resource Management Survey (ARMS). It pulls real-time data on farm finances, production practices, and resource usage across the U.S. Use it to query specific years, states, and farm types without manual CSV downloads.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_HgvDO23igRkfy615pLSsFA2VZZTsXARonxiIwEVC/ai-agent-connect
- **Tags:** agriculture, economic-data, survey-data, farm-finance, public-records, data-retrieval

## Description

The ERS USDA MCP connects you to the USDA Economic Research Service to pull data from the Agricultural Resource Management Survey (ARMS). It pulls hard data on farm business finances, production practices, and resource usage across the United States. Instead of hunting through government websites or downloading messy spreadsheets to find out how much farm income changed in a specific state, you can just ask your AI agent to grab the numbers. It handles the heavy lifting of navigating the ARMS dataset, so you can focus on what the numbers actually mean for your research. Whether you're looking for historical trends in farm expenses or specific data on operator households, it pulls the raw info you need without the administrative headache of manual data collection. It's one of the many tools available in the Vinkius catalog that turns static government records into actionable data for your projects.

## Tools

### get_arms_reports
get_arms_reports shows available reports and variables. This helps you identify which specific data points are available for your query.

### get_arms_states
get_arms_states lists all ARMS states and their metadata. Use it to understand regional agricultural economies.

### get_arms_variables
get_arms_variables provides detailed metadata for ARMS variables. Use it to ensure you're interpreting the data correctly.

### get_arms_surveydata
get_arms_surveydata fetches actual survey results for specific years and reports. This is the primary tool for pulling farm financial data.

### get_arms_farmtypes
get_arms_farmtypes lists all farm classifications. Use it to see how the survey categorizes farms by production or size.

### get_arms_years
get_arms_years lists all available survey years. It lets you quickly see the historical range for your longitudinal analysis.

### get_arms_categories
get_arms_categories lists ARMS categories and subcategories. This helps you segment your research by specific farm types or operations.

## Prompt Examples

**Prompt:** 
```
What years of ARMS data are available?
```

**Response:** 
```
I've checked the available survey years for the ARMS dataset. Data is currently available for the following years:

* **Recent Years:** 2021, 2022
* **Historical Range:** [Full list of available years retrieved]

Which year would you like to focus on for your analysis?
```

**Prompt:** 
```
Get the 2022 income statement survey data.
```

**Response:** 
```
I've retrieved the 2022 income statement data. Here are the key financial metrics:

| Metric | Value |
| :--- | :--- |
| **Gross Cash Farm Income** | [Data] |
| **Total Cash Expenses** | [Data] |
| **Net Cash Farm Income** | [Data] |

Would you like me to break this down by state or farm type?
```

**Prompt:** 
```
List the different farm types available in the survey.
```

**Response:** 
```
The ARMS dataset includes several farm classifications. Here are the primary types you can filter by:

* **Operator Households**
* **Commercial Farms**
* **Farm Typology Categories**

Let me know if you'd like to see the specific data for any of these categories.
```

## Capabilities

### Pull farm financial data
Use get_arms_surveydata to grab specific financial metrics for farm businesses.

### List available survey years
Check get_arms_years to see the full range of historical data available.

### Filter by farm types
Use get_arms_farmtypes to see how different farms are classified by size and production.

### Retrieve state metadata
Get regional economic data via get_arms_states for specific U.S. locations.

### Inspect variable definitions
Use get_arms_variables to see exactly what each data point represents in the survey.

### Access report categories
Identify specific data points using get_arms_reports for your research needs.

## Use Cases

### Comparing farm income trends
An economist needs to see if farm expenses rose in 2022. They ask the agent to pull 2022 income statements using get_arms_surveydata.

### Identifying farm classifications
A researcher wants to know how many operator households exist. They use get_arms_farmtypes to see the available categories.

### Regional economic mapping
A policy analyst needs to compare five states. They use get_arms_states to get the regional metadata first.

### Verifying data definitions
A data scientist wants to check what a specific variable means. They use get_arms_variables to see the official USDA definitions.

## Benefits

- Skip manual CSV downloads by pulling survey results directly via get_arms_surveydata.
- Build accurate historical models by checking available dates with get_arms_years.
- Ensure data accuracy by inspecting variable definitions with get_arms_variables.
- Segment research quickly by filtering for specific classifications using get_arms_farmtypes.
- Analyze regional differences by pulling state-specific metadata with get_arms_states.
- Identify specific data points for your project using get_arms_reports.

## How It Works

The bottom line is you get direct access to USDA agricultural economic data without manual downloads.

1. Subscribe to the Connector and add your ERS USDA API key to your configuration.
2. Connect the Connector to your AI client like Claude, Cursor, or Windsurf.
3. Ask your agent to pull specific survey results, years, or farm classifications.

## Frequently Asked Questions

**Can the ERS USDA MCP pull farm income data?**
Yes, it can pull detailed financial metrics like gross cash farm income, total expenses, and net income directly from the USDA's ARMS survey.

**How do I get USDA ARMS survey results with an AI?**
You can connect this Connector to your AI client. Once connected, you can simply ask the agent to fetch survey results for specific years or reports.

**Does the ERS USDA MCP support historical farm data?**
It does. You can query the Connector to see all available survey years and pull historical data to perform longitudinal analysis of farm finances.

**Can I use ERS USDA MCP to see different farm categories?**
Yes, the Connector can list all available farm types and categories, allowing you to segment your research by farm size or production type.

**Is there a way to get state-specific agricultural data?**
Yes, you can use the Connector to retrieve metadata for all ARMS states to understand regional agricultural economies and production practices.

**How do I find USDA farm finance variables?**
The Connector allows your agent to inspect detailed metadata and definitions for all variables used in the ARMS dataset to ensure accurate interpretation.

**What is required to fetch specific survey results using this server?**
To use the `get_arms_surveydata` tool, you must provide at least one year and either a 'report' name (like income+statement) or a specific 'variable' ID (like igcfi).

**Can I see which states are available in the ARMS dataset?**
Yes! Use the `get_arms_states` tool to retrieve a list of all U.S. states covered by the survey along with their associated metadata.

**How do I find the meaning of a specific variable code like 'igcfi'?**
You can use the `get_arms_variables` tool to fetch detailed metadata and descriptions for all variables used in the Agricultural Resource Management Survey.