Skip to content
MCP server

Usda Soil

Soil at any US coordinate, its named soil series and SQL over the SSURGO survey

Install
Pricing
Freemium
Platforms
API
Runs
Locally or Remotely
Version
0.2.1
Listing updated
2 days ago

About Usda Soil

Usda Soil is a freemium MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/usda-soil/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "usda-soil": {
      "url": "https://gateway.pipeworx.io/usda-soil/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free tier: 50 calls a day anonymous, 200 with a free account; paid plans from $49/month or pay as you go

Prices change. Check pipeworx.io before you buy.

Usda Soil 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 to Usda Soil

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  4. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data