sacs.ai

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.

Cowork connection instructions · Projection workflow

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.

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.

  1. sacs_search_districts: {"query":"Los Angeles Unified","limit":5} — confirm the district and CDS identifier.
  2. sacs_list_public_datasets: use the returned district identifier to discover available fiscal years, reporting periods, and bases.
  3. sacs_district_context_pack: choose a discovered year and basis, set fund_codes=["01"] for General Fund only, and start with detail="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.