`education_find_schools`

Pack: education-data · Endpoint: https://gateway.pipeworx.io/education-data/mcp

Find US K-12 PUBLIC SCHOOLS by state, with optional city or name filter. Keyless federal data (NCES Common Core of Data via the Urban Institute). Returns each school’s NCES id, name, district, city, enrollment, charter/magnet status, grade range, and free/reduced-price lunch counts. Use for “public schools in <city/state>”, “how many students at ”, “charter schools in ”, “which schools have the highest enrollment”. For school DISTRICTS use education_find_districts; for COLLEGES use the college-scorecard pack instead — this covers K-12 only.

Parameters

Name	Type	Required	Description
`state`	string	yes	US state name or 2-letter abbreviation, e.g. “Colorado” or “CO”. Required.
`city`	string	no	Optional city filter, matched case-insensitively against the school’s city.
`name_contains`	string	no	Optional substring match on the school name, e.g. “Lincoln”.
`charter_only`	boolean	no	Return only charter schools.
`year`	number	no	School year (data year). Default 2020.
`limit`	number	no	Max schools to return (1-100, default 25).

Example call

Arguments

{
  "state": "TX",
  "city": "Austin"
}

curl

curl -X POST https://gateway.pipeworx.io/education-data/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"education_find_schools","arguments":{"state":"TX","city":"Austin"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('education_find_schools', {
  "state": "TX",
  "city": "Austin"
});

More examples

{
  "state": "MA",
  "charter_only": true,
  "limit": 25
}

Connect

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

{
  "mcpServers": {
    "education-data": {
      "url": "https://gateway.pipeworx.io/education-data/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

education_find_schools