# Usda Soil

> Usda Soil is a freemium MCP server for analytics and data. Soil at any US coordinate, its named soil series and SQL over the SSURGO survey. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API
- **Website:** https://pipeworx.io/packs/usda-soil
- **Repository:** https://github.com/pipeworx-io/mcp-usda-soil
- **MCP Registry name:** io.github.pipeworx-io/usda-soil
- **Categories:** analytics and data, health and science
- **Listing updated:** 2026-11-14

## About

Soil survey data from USDA-NRCS is reachable at three depths. A point lookup returns the map unit key, symbol, official name, acreage, farmland class and survey area publication date. A second tool opens one map unit to list its soil series with percentage of the unit, taxonomic class, drainage class, slope range, hydrologic group, land capability class and hydric rating, and can add depth horizons with sand, silt and clay, organic matter, pH, available water capacity and Ksat. The third runs read-only SQL against the full SSURGO schema.

The README says SSURGO is field-mapped at 1:12,000 to 1:63,360 scale and republished annually. It covers only the United States and its territories, and is distinct from the ISRIC soilgrids pack, which is a global 250 m modelled prediction.

The pack hides several traps: the backend is SQL Server so queries use TOP, errors arrive as XML and are unwrapped to a readable sentence, empty results are labelled as such, and point geometry takes longitude first. It needs no key.

## Features

- **Soil at a point:** Maps a latitude and longitude to its SSURGO map unit and official name.
- **Soil series detail:** Lists series in a map unit with taxonomy, drainage, slope and hydrologic group.
- **Depth horizons:** Optionally adds sand, silt, clay, organic matter, pH, water capacity and Ksat.
- **Read-only SQL:** Runs SELECT queries over legend, mapunit, component, chorizon and cointerp tables.
- **Readable errors:** Unwraps the service's XML errors into one clear sentence.
- **Keyless access:** Reads the public USDA service without a key.

## Good for

- Check soil drainage and slope for a farm parcel
- Pull hydric ratings for a wetland screening
- Get organic matter and pH by horizon for a field
- Run custom queries across the soil survey schema

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http usda-soil https://gateway.pipeworx.io/usda-soil/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/usda-soil/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "usda-soil": {
      "url": "https://gateway.pipeworx.io/usda-soil/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "usda-soil": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/usda-soil/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "usda-soil": {
      "serverUrl": "https://gateway.pipeworx.io/usda-soil/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "usda-soil": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/usda-soil/mcp"
    }
  }
}
```

## Tools

- `usda_soil_mapunit_at_point`: Returns the SSURGO map unit at a US latitude and longitude.
- `usda_soil_components`: Lists the soil series in a map unit, optionally with depth horizons.
- `usda_soil_query`: Runs a read-only SQL SELECT over the SSURGO schema.

## FAQ

### Does it cover countries outside the US?

No. It covers the United States and its territories; the README suggests soilgrids elsewhere.

### What kind of SQL does it accept?

Read-only SELECT statements in T-SQL, so use TOP rather than LIMIT.

### Is an empty result an error?

No, but the tool says so explicitly instead of presenting it as a finding.

### Does it need an API key?

No. It is keyless; an optional Pipeworx key raises daily caps.

### Is Usda Soil free?

Usda Soil has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Usda Soil to Claude Code?

Run this command in your terminal: claude mcp add --transport http usda-soil https://gateway.pipeworx.io/usda-soil/mcp

### What are the best alternatives to Usda Soil?

The closest alternatives to Usda Soil are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tooluniverse, Oya Browser and Tapetide - Indian Stock Market MCP.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/usda-soil
