K12 Safety MCP Server

Overview

The K12 Safety MCP Server exposes the complete K12 Education tool registry, covering Emergency Operation Plan (EOP) operations, scenario-specific annex kickoffs, role lookup helpers, and Quick Reference Guide (QRG) workflows. With 28 registered tools, it is the largest MCP server in the platform.

Server Metadata

Property	Value
Factory	`createK12SafetyMcpServer()`
Source	`packages/domain-k12/src/mcp-server.ts`
Version	1.0.0
Tool Count	28 (21 EOP/annex/role tools + 7 QRG)
Skip Flag	`MASTRA_SKIP_K12_MCP`
Tool Registry	`packages/domain-k12/src/tools.ts`

Factory Implementation

// packages/domain-k12/src/mcp-server.ts
import { MCPServer } from '@mastra/mcp';
import { k12SafetyTools } from './tools.ts';

export const createK12SafetyMcpServer = () =>
  new MCPServer({
    name: 'K12 Safety MCP Server',
    version: '1.0.0',
    description:
      'Provides tools for assessing K12 content safety signals and retrieving escalation guidance.',
    tools: k12SafetyTools,
  });

Tool Registry

The tool registry at packages/domain-k12/src/tools.ts exports 28 tools. The QRG tools are spread from packages/domain-k12/src/qrg/index.ts; the remaining tools live in the top-level K12 package.

EOP, Annex, and Role Tools (21)

Tool ID	Description
`k12-lkp-task-status-by-session-or-request`	Query monitoring rows by sessionId or requestId to show status history
`k12-lkp-task-request-result`	Fetch the persisted request row and attached response fields
`k12-insert-task-in-monitoring-table`	Insert a status/monitoring row into `K12SAFETY.log_EOP_TaskStatus`
`k12-insert-task-request-log`	Insert a full workflow request into `K12SAFETY.log_EOP_TaskRequests`
`k12-update-task-request-response`	Record the workflow's final response payload into the request log
`k12-update-task-status`	Update an existing monitoring row's status and message
`k12-cancel-task-request`	Request cancellation for an in-flight workflow run
`k12-annex-editing-kickoff`	Main entry point to kick off the EOP/Annex editing workflow
`k12-district-planning-kickoff`	Start the district-planning annex scenario workflow
`k12-facility-planning-kickoff`	Start the facility-planning annex scenario workflow
`k12-functional-annex-kickoff`	Start the functional-annex scenario workflow
`k12-hazard-annex-kickoff`	Start the hazard-annex scenario workflow
`k12-functional-annex-suggest-roles-kickoff`	Suggest EOP roles for functional-annex planning
`k12-hazard-annex-suggest-roles-kickoff`	Suggest EOP roles for hazard-annex planning
`k12-functional-annex-suggest-responsibilities-kickoff`	Suggest responsibilities for functional-annex planning
`k12-hazard-annex-suggest-responsibilities-kickoff`	Suggest responsibilities for hazard-annex planning
`k12-annex-editing-status`	Poll the status of an in-flight EOP editing workflow
`k12-annex-editing-result`	Retrieve the final result of a completed EOP editing workflow
`k12-get-emergency-operation-plan-snapshot`	Get an EOP snapshot from MOEOP for contextual prompts
`k12-get-selected-eop-roles`	Read selected EOP role assignments for a plan/context
`k12-get-eop-role-universe`	Read the available EOP role universe

QRG Tools (7)

These tools are defined in packages/domain-k12/src/qrg/index.ts and spread into the main tool registry:

Tool ID	Description
`k12-qrg-generation-kickoff`	Start a QRG generation workflow from an EOP
`k12-qrg-generation-status`	Poll the status of a QRG generation workflow
`k12-qrg-generation-result`	Retrieve the final generated QRGs
`k12-qrg-editing-kickoff`	Start a QRG editing workflow
`k12-qrg-editing-status`	Poll the status of a QRG editing workflow
`k12-qrg-editing-result`	Retrieve the result of a QRG editing workflow
`k12-qrg-cancel`	Cancel an in-flight QRG generation or editing workflow

Implementation Notes

QRG Sub-Module Pattern

The QRG tools are maintained in a separate sub-module (./qrg/index.ts) for organizational clarity but are spread into the top-level registry using the object spread operator:

// packages/domain-k12/src/tools.ts
import { annexEditingKickoffTool } from './annex-editing-kickoff.ts';
import { insertTaskRequestTool } from './insert-task-request-tool.ts';
import { qrgTools } from './qrg/index.ts';

export const k12SafetyTools = {
  'k12-annex-editing-kickoff': annexEditingKickoffTool,
  'k12-insert-task-request-log': insertTaskRequestTool,
  // Other EOP, annex scenario, status/result, and role tools...
  ...qrgTools,  // 7 QRG tools merged into the flat registry
};

This means all 28 tools appear as a flat list in the MCP server -- there is no sub-grouping visible to MCP clients.

Domain Gating

The K12 Safety MCP server is only loaded when MASTRA_TARGET includes k12 (or is set to all). It can also be explicitly disabled via MASTRA_SKIP_K12_MCP regardless of the target.

Database Dependencies

Most K12 tools require an active Azure SQL connection. The tools use the K12SAFETY schema with tables including:

log_EOP_TaskRequests -- Full request/response payloads
log_EOP_TaskStatus -- Status monitoring rows
log_Jobs -- General job tracking
qrg_requests, qrg_generations, qrg_generated_items -- QRG lifecycle

MOEOP Integration

The k12-get-emergency-operation-plan-snapshot tool calls an external MOEOP (Missouri EOP) API to fetch plan documents. This requires the K12_MOEOP_API_ENDPOINT environment variable to be configured.

Code Locations

Server factory: packages/domain-k12/src/mcp-server.ts
Tool registry: packages/domain-k12/src/tools.ts
QRG sub-module: packages/domain-k12/src/qrg/index.ts
Individual tools: packages/domain-k12/src/*.ts
Tests: tests/shared/unit/mcp-servers/mcp-servers.test.ts (K12 Safety MCP Server describe block)
Tool-level tests: packages/domain-k12/tests/tools/

Overview​

Server Metadata​

Factory Implementation​

Tool Registry​

EOP, Annex, and Role Tools (21)​

QRG Tools (7)​

Implementation Notes​

QRG Sub-Module Pattern​

Domain Gating​

Database Dependencies​

MOEOP Integration​

Code Locations​