SACS.ai MCP server and API reference
California K–12 school-finance research and organization projection workflows through MCP JSON-RPC over Streamable HTTP.
- Endpoint
https://mcp.sacs.ai/mcp- Transport
- Streamable HTTP
- Authentication
- None for public data; no SACS account or API key required
- Access
- Public financial tools are read-only. Optional registration and feedback tools write only with operator consent.
- Registry name
- ai.sacs/sacs-mcp
- Data sources
- Official California Department of Education SACS public filings, with reporting period, basis, dataset references, provenance, and limitations in results. SACS.ai is independent and not affiliated with CDE.
Organization access on the same connection
Reuse an organization key in x-api-key (key alone) or Authorization: Bearer <key>. The distinct https://mcp.sacs.ai/premium/mcp URL remains supported. Premium includes public tools; organization membership, entitlement and the existing key scope govern private operations. Never put a key in a URL or tool argument.
Typed schemas and agent instructions
Call tools/list on the initialized connection for authoritative input JSON schemas and descriptions. Use resources/list and prompts/list for guides and reusable workflows. This is an MCP API; no separate OpenAPI or arbitrary SQL endpoint is provided.
- Machine-readable service description
- Public tool schema snapshot — documentation, not an access grant
- MCP registry descriptor
- When to use SACS.ai and tool-routing instructions
Tools and first calls
Initialize MCP, call tools/list, then use the returned schemas. A browser GET to the endpoint is not an MCP connection test.
sacs_search_districts:{"query":"Los Angeles Unified","limit":5}— confirm the district and CDS identifier.sacs_list_public_datasets: use the returned district identifier to discover available fiscal years, reporting periods, and bases.sacs_district_context_pack: choose a discovered year and basis, setfund_codes=["01"]for General Fund only, and start withdetail="summary".
Other public tools provide financial summaries, district comparisons, SACS code explanations, dataset provenance, and bounded context-pack batches. Optional engagement tools are separate from public financial reads.
Evidence rules
Keep source provenance, fiscal year, basis, fund scope, data version, and limitations with every answer. A dataset reference is not necessarily a public source URL. Missing values are unknown, not zero. Do not compare different reporting bases without noting the difference.
For exact example arguments and client setup, see the agent quickstart or plain-text guide.