# USITC DataWeb MCP for AI Agents AI Agent Connect

> USITC DataWeb lets you pull official US trade statistics directly into your AI workflow. You can query import and export data, trade balances, and commodity trends using standard classifications like HS codes or NAICS. It cuts out the manual work of hunting through government portals to find specific trade volumes, allowing you to focus on analysis instead of data gathering.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_flwdprXg2iFp4wcsdyGol5MvmiapXZHEH4lrdUWS/ai-agent-connect
- **Tags:** international-trade, import-export, tariff-data, economic-statistics, trade-balance, commodity-data

## Description

If you spend your day digging through government websites to find out how much grain was imported from Brazil or what the trade balance looks like for electronics, you know how tedious that manual hunt is. This Connector lets your agent do the heavy lifting for you. Instead of downloading CSVs and trying to filter them yourself, you can just ask your AI client to pull the latest figures. It connects directly to the International Trade Commission's data, meaning you get official numbers on commodities, countries, and time periods without the friction. It's one of the many tools you can find in the Vinkius catalog to turn raw government data into actual insights. You can explore available tables, check which fields are valid, and run detailed queries to see how trade flows are shifting. It turns a multi-step research project into a simple conversation.

## Tools

### list_metadata_values
This tool lists valid values for a specific field, like a list of all country codes. It helps you ensure your queries use the correct identifiers.

### list_metadata_fields
Use this to see every field available within a specific data table. It lets you know exactly what information you can pull for a given category.

### query_trade_data
This is the main tool for fetching trade statistics based on your specific filters. It handles large sets of criteria to give you precise import or export numbers.

### list_metadata_tables
This tool shows you all the different tables available in the DataWeb. It's the best place to start when you're figuring out which data set to query.

## Prompt Examples

**Prompt:** 
```
What were the total exports of automobiles to Mexico in 2022?
```

**Response:** 
```
I've pulled the trade statistics for automobiles exported to Mexico in 2022.

| Year | Country | Commodity | Total Value |
| :--- | :--- | :--- | :--- |
| 2022 | Mexico | Automobiles | $X.X Billion |

Would you like a month-by-month breakdown of these exports?
```

**Prompt:** 
```
Show me the fields available in the imports table so I know what I can filter by.
```

**Response:** 
```
For the **imports** table, you can filter by the following fields:

*   **Commodity**
*   **Country**
*   **Year**
*   **Month**
*   **Customs Value**

Let me know if you'd like to see the valid values for any of these specific fields.
```

**Prompt:** 
```
What are the valid country codes for trade data?
```

**Response:** 
```
I've retrieved the list of valid country codes. Here are a few examples:

*   **Canada**: 1220
*   **China**: 1560
*   **Mexico**: 3780

I can pull the full list for you if you'd like to see every available code.
```

## Capabilities

### Fetch import and export volumes
Get specific numbers on goods moving in and out of the country by commodity.

### Check trade balances
See the difference between imports and exports for specific countries.

### Explore data tables
Browse all available data sets to find the right category for your research.

### Identify valid codes
Find the correct country codes or commodity levels before running a query.

### Analyze time-series trends
Retrieve annual or monthly data to see how trade patterns change over time.

### Query multiple standards
Work with HS, SITC, or NAICS classifications depending on your reporting needs.

## Use Cases

### Finding export values
The agent finds the specific value for automobiles exported to Mexico in 2022 by querying the trade data.

### Checking available filters
The agent lists all filters like commodity, country, and year when asked about the imports table.

### Verifying country codes
The agent provides a list of codes to ensure the query is correct before pulling large datasets.

### Analyzing historical trends
The agent pulls annual data to show the trade balance for live animals from Canada over the last 5 years.

## Benefits

- Get trade volumes without manual CSV downloads. Use the query tool to get specific numbers instantly.
- Ensure query accuracy by checking valid country codes. This prevents errors in your final data.
- See all available fields before running a query. This helps you plan your data request.
- Analyze long-term trends with monthly and annual data. You can see how trade balances have shifted over time.
- Work with multiple standards like HS or NAICS. This makes it easy to align with different reporting requirements.

## How It Works

The bottom line is you get official trade statistics without ever leaving your chat window.

1. Add your USITC DataWeb API key to your configuration.
2. Ask your agent to explore the available tables or specific trade stats.
3. Get back structured trade data ready for analysis.

## Frequently Asked Questions

**Can I use the USITC DataWeb MCP to find specific HS codes?**
Yes, it lets you explore metadata to find valid codes and classifications used by the International Trade Commission.

**Does this Connector provide real-time shipping updates?**
No, it provides official trade statistics and historical data, not real-time tracking for individual shipments.

**Can I query trade data for specific years?**
Yes, you can retrieve annual and monthly data to analyze trade trends over different time periods.

**Is the data from the USITC DataWeb official?**
Yes, it pulls directly from the International Trade Commission's official government data sources.

**How do I find out which commodities are available?**
You can ask your agent to list the available fields and values for the trade data tables to see what's included.

**Can I use this to see the trade balance between two countries?**
Yes, you can query the trade balance data for specific regions and commodities to see the net flow of trade.

**How do I find the correct country code for a trade query?**
You can use the `list_metadata_values` tool. Provide the table ID (e.g., 'imports') and the field ID for countries to see a full list of valid USITC country codes.

**What classification systems are supported for commodity queries?**
The server supports 'hs' (Harmonized System), 'sitc' (Standard International Trade Classification), and 'naics' (North American Industry Classification System) via the `query_trade_data` tool.

**Can I see what data tables are available before querying?**
Yes, use the `list_metadata_tables` tool to retrieve a list of all available data tables and their identifiers from the USITC DataWeb API.