`usda_soil_query`

Pack: usda-soil · Endpoint: https://gateway.pipeworx.io/usda-soil/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/usda_soil_query for the schema, then POST the same URL with its arguments for the data.

Run a read-only SQL SELECT against the USDA-NRCS Soil Data Access database (SSURGO) — the full US soil survey schema: legend, mapunit, component, chorizon, cointerp, plus the SDA_ spatial helper functions such as SDA_Get_Mukey_from_intersection_with_WktWgs84. Use for anything the point and component tools do not cover: soil series by county, prime farmland acreage, drainage class distributions, crop yield indices. Keyless.

Parameters

Name	Type	Required	Description
`sql`	string	yes	A T-SQL SELECT, e.g. “SELECT TOP 10 m.muname, m.muacres FROM mapunit m INNER JOIN legend l ON l.lkey = m.lkey WHERE l.areasymbol = ‘IA153’ ORDER BY m.muacres DESC”. SELECT only. Use TOP n rather than LIMIT — this is SQL Server.

Example call

Arguments

{
  "sql": "SELECT TOP 5 m.muname, m.muacres FROM mapunit m INNER JOIN legend l ON l.lkey = m.lkey WHERE l.areasymbol = 'IA153' ORDER BY m.muacres DESC"
}

curl

curl -X POST https://gateway.pipeworx.io/usda-soil/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"usda_soil_query","arguments":{"sql":"SELECT TOP 5 m.muname, m.muacres FROM mapunit m INNER JOIN legend l ON l.lkey = m.lkey WHERE l.areasymbol = '\''IA153'\'' ORDER BY m.muacres DESC"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('usda_soil_query', {
  "sql": "SELECT TOP 5 m.muname, m.muacres FROM mapunit m INNER JOIN legend l ON l.lkey = m.lkey WHERE l.areasymbol = 'IA153' ORDER BY m.muacres DESC"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

usda_soil_query