SACS.ai MCP — California School District Financial Data
SACS California school finance: public district financial data, CDE filings, comparisons, briefings.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- LOWen sacs_search_districts
- LOWen sacs_explain_code
- LOWen sacs_district_context_pack_batch
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"sacs-mcp": {
"url": "https://mcp.sacs.ai/mcp"
}
}
}Puntos de conexión remotos
https://mcp.sacs.ai/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢sacs_search_districts(query, limit, offset, client_id)
Resolve a public California district name, 7-digit LEA, or 14-digit CDS code.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"maxLength": 100,
"minLength": 2,
"title": "Query",
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 500,
"minimum": 0,
"title": "Offset",
"type": "integer"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"query"
],
"additionalProperties": false,
"title": "sacs_search_districtsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟢sacs_list_public_datasets(district_identifier, limit, offset, client_id)
List versioned official public SACS datasets for one district.
Esquema de entrada
{
"type": "object",
"properties": {
"district_identifier": {
"maxLength": 100,
"minLength": 2,
"title": "District Identifier",
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 500,
"minimum": 0,
"title": "Offset",
"type": "integer"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"district_identifier"
],
"additionalProperties": false,
"title": "sacs_list_public_datasetsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟢sacs_query_financial_summary(district_identifier, dataset_ref, fund_code_min, fund_code_max, resource_code_min, ...)
Return bounded aggregate financial summaries for one explicit official dataset.
Esquema de entrada
{
"type": "object",
"properties": {
"district_identifier": {
"maxLength": 100,
"minLength": 2,
"title": "District Identifier",
"type": "string"
},
"dataset_ref": {
"maxLength": 64,
"minLength": 10,
"pattern": "^official:[1-9][0-9]*$",
"title": "Dataset Ref",
"type": "string"
},
"fund_code_min": {
"anyOf": [
{
"description": "Two-digit SACS fund code",
"pattern": "^[0-9]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fund Code Min"
},
"fund_code_max": {
"anyOf": [
{
"description": "Two-digit SACS fund code",
"pattern": "^[0-9]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fund Code Max"
},
"resource_code_min": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Resource Code Min"
},
"resource_code_max": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Resource Code Max"
},
"goal_code_min": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Goal Code Min"
},
"goal_code_max": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Goal Code Max"
},
"function_code_min": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Function Code Min"
},
"function_code_max": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Function Code Max"
},
"object_code_min": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Object Code Min"
},
"object_code_max": {
"anyOf": [
{
"pattern": "^[0-9]{4}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Object Code Max"
},
"group_limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"title": "Group Limit",
"type": "integer"
},
"include_zero_categories": {
"default": false,
"description": "Include zero-amount object category and group rows.",
"title": "Include Zero Categories",
"type": "boolean"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"district_identifier",
"dataset_ref"
],
"additionalProperties": false,
"title": "sacs_query_financial_summaryArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟢sacs_compare_districts(base_district_identifier, base_dataset_ref, compare_district_identifier, compare_dataset_ref, fund_codes, ...)
Compare deterministic object-category totals for two explicit official datasets.
Esquema de entrada
{
"type": "object",
"properties": {
"base_district_identifier": {
"maxLength": 100,
"minLength": 2,
"title": "Base District Identifier",
"type": "string"
},
"base_dataset_ref": {
"maxLength": 64,
"minLength": 10,
"pattern": "^official:[1-9][0-9]*$",
"title": "Base Dataset Ref",
"type": "string"
},
"compare_district_identifier": {
"maxLength": 100,
"minLength": 2,
"title": "Compare District Identifier",
"type": "string"
},
"compare_dataset_ref": {
"maxLength": 64,
"minLength": 10,
"pattern": "^official:[1-9][0-9]*$",
"title": "Compare Dataset Ref",
"type": "string"
},
"fund_codes": {
"anyOf": [
{
"items": {
"description": "Two-digit SACS fund code",
"pattern": "^[0-9]{2}$",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Fund Codes"
},
"resource_codes": {
"anyOf": [
{
"items": {
"pattern": "^[0-9]{4}$",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Resource Codes"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"base_district_identifier",
"base_dataset_ref",
"compare_district_identifier",
"compare_dataset_ref"
],
"additionalProperties": false,
"title": "sacs_compare_districtsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟢sacs_district_context_pack(district_identifier, fund_codes, basis, fiscal_year_min, fiscal_year_max, ...)
Build fiscal-distress rows with source filing details. Deficit spending is signed net operating result / expenditure; negative means deficit.
Esquema de entrada
{
"type": "object",
"properties": {
"district_identifier": {
"maxLength": 100,
"minLength": 2,
"title": "District Identifier",
"type": "string"
},
"fund_codes": {
"anyOf": [
{
"items": {
"description": "Inclusive two-digit SACS fund bound",
"pattern": "^[0-9]{2}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Fund Codes"
},
"basis": {
"default": "estimated_actuals",
"enum": [
"estimated_actuals",
"unaudited_actuals",
"adopted_budget",
"first_interim",
"second_interim"
],
"title": "Basis",
"type": "string"
},
"fiscal_year_min": {
"anyOf": [
{
"pattern": "^[0-9]{4}-[0-9]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fiscal Year Min"
},
"fiscal_year_max": {
"anyOf": [
{
"pattern": "^[0-9]{4}-[0-9]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fiscal Year Max"
},
"include_balance_sheet_from_actuals": {
"default": true,
"title": "Include Balance Sheet From Actuals",
"type": "boolean"
},
"one_time_resource_codes": {
"anyOf": [
{
"items": {
"pattern": "^[0-9]{4}$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "One Time Resource Codes"
},
"detail": {
"default": "full",
"enum": [
"summary",
"full"
],
"title": "Detail",
"type": "string"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"district_identifier"
],
"additionalProperties": false,
"title": "sacs_district_context_packArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟢sacs_district_context_pack_batch(district_identifiers, fund_codes, basis, fiscal_year_min, fiscal_year_max, ...)
Build bounded district packs with source filing details. Deficit spending is signed net operating result / expenditure; negative means deficit.
Esquema de entrada
{
"type": "object",
"properties": {
"district_identifiers": {
"items": {
"maxLength": 100,
"minLength": 2,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"title": "District Identifiers",
"type": "array"
},
"fund_codes": {
"anyOf": [
{
"items": {
"description": "Inclusive two-digit SACS fund bound",
"pattern": "^[0-9]{2}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Fund Codes"
},
"basis": {
"default": "estimated_actuals",
"enum": [
"estimated_actuals",
"unaudited_actuals",
"adopted_budget",
"first_interim",
"second_interim"
],
"title": "Basis",
"type": "string"
},
"fiscal_year_min": {
"anyOf": [
{
"pattern": "^[0-9]{4}-[0-9]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fiscal Year Min"
},
"fiscal_year_max": {
"anyOf": [
{
"pattern": "^[0-9]{4}-[0-9]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fiscal Year Max"
},
"include_balance_sheet_from_actuals": {
"default": true,
"title": "Include Balance Sheet From Actuals",
"type": "boolean"
},
"one_time_resource_codes": {
"anyOf": [
{
"items": {
"pattern": "^[0-9]{4}$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "One Time Resource Codes"
},
"detail": {
"default": "summary",
"enum": [
"summary",
"full"
],
"title": "Detail",
"type": "string"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"district_identifiers"
],
"additionalProperties": false,
"title": "sacs_district_context_pack_batchArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟢sacs_explain_code(code_type, query, limit, offset, client_id)
Explain current public fund, resource, goal, function, or object codes.
Esquema de entrada
{
"type": "object",
"properties": {
"code_type": {
"enum": [
"fund",
"resource",
"goal",
"function",
"object"
],
"title": "Code Type",
"type": "string"
},
"query": {
"maxLength": 80,
"minLength": 1,
"title": "Query",
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 500,
"minimum": 0,
"title": "Offset",
"type": "integer"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
}
},
"required": [
"code_type",
"query"
],
"additionalProperties": false,
"title": "sacs_explain_codeArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟡sacs_register_client(consent_to_store, client_id, user_type, home_district_cds, agent_client, ...)
Optionally register this MCP installation. Before calling, tell the operator registration is voluntary, data access works without it, list the fields to be stored, and obtain consent. Never infer or submit personal or confidential information.
Esquema de entrada
{
"type": "object",
"properties": {
"consent_to_store": {
"const": true,
"description": "Must be true, and only after the operator accepts the disclosed storage.",
"title": "Consent To Store",
"type": "boolean"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
},
"user_type": {
"anyOf": [
{
"enum": [
"district_staff",
"county_office_staff",
"state_agency_staff",
"researcher",
"consultant",
"vendor",
"community_member",
"other",
"prefer_not_to_say"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "User Type"
},
"home_district_cds": {
"anyOf": [
{
"pattern": "^[0-9]{14}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Home District Cds"
},
"agent_client": {
"anyOf": [
{
"maxLength": 100,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Agent Client"
},
"use_case": {
"anyOf": [
{
"maxLength": 500,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Use Case"
}
},
"required": [
"consent_to_store"
],
"additionalProperties": false,
"title": "sacs_register_clientArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}🟡sacs_submit_feedback(sentiment, message, client_id, feedback_type, related_request_id, ...)
Send voluntary good, bad, corrective, missing-context, or feature-request feedback, anonymously or with a registered client ID. Tell the operator what will be sent; never include personal, student, personnel, or confidential information.
Esquema de entrada
{
"type": "object",
"properties": {
"sentiment": {
"enum": [
"good",
"bad",
"mixed"
],
"title": "Sentiment",
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 2,
"title": "Message",
"type": "string"
},
"client_id": {
"anyOf": [
{
"pattern": "^sacs_client_[0-9a-f]{32}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Id"
},
"feedback_type": {
"default": "general",
"enum": [
"general",
"feature_request",
"incorrect",
"incomplete",
"stale",
"missing_context"
],
"title": "Feedback Type",
"type": "string"
},
"related_request_id": {
"anyOf": [
{
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Related Request Id"
},
"related_data_version": {
"anyOf": [
{
"maxLength": 256,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Related Data Version"
}
},
"required": [
"sentiment",
"message"
],
"additionalProperties": false,
"title": "sacs_submit_feedbackArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"contract_version": {
"const": "sacs.mcp.v1",
"default": "sacs.mcp.v1",
"title": "Contract Version",
"type": "string"
},
"data_version": {
"maxLength": 256,
"minLength": 1,
"title": "Data Version",
"type": "string"
},
"request_id": {
"maxLength": 128,
"minLength": 8,
"title": "Request Id",
"type": "string"
},
"source_provenance": {
"items": {
"$ref": "#/$defs/SourceProvenance"
},
"title": "Source Provenance",
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Limitations",
"type": "array"
},
"ok": {
"title": "Ok",
"type": "boolean"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Data"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/PublicError"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"data_version",
"request_id",
"ok"
],
"$defs": {
"PublicError": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"invalid_request",
"not_found",
"private_scope_denied",
"dataset_mismatch",
"payload_rejected",
"backend_unavailable"
],
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 500,
"minLength": 1,
"title": "Message",
"type": "string"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"title": "PublicError",
"type": "object"
},
"SourceProvenance": {
"additionalProperties": false,
"properties": {
"source": {
"maxLength": 120,
"minLength": 1,
"title": "Source",
"type": "string"
},
"record_ref": {
"maxLength": 160,
"minLength": 1,
"title": "Record Ref",
"type": "string"
},
"description": {
"maxLength": 500,
"minLength": 1,
"title": "Description",
"type": "string"
}
},
"required": [
"source",
"record_ref",
"description"
],
"title": "SourceProvenance",
"type": "object"
}
},
"additionalProperties": false,
"title": "PublicToolResponse"
}Comunidad
Evidencia