gacaseMCP

Model Context Protocol (MCP) server for Georgia's SuitCASE standards API (https://case.georgiastandards.org/ims/case/v1p1/), which publishes Georgia's standards, course codes and CTAE frameworks in the 1EdTech CASE® 1.1 format.

It lets AI assistants find Georgia standards, course codes, CTAE clusters and pathways, and walk the standards hierarchy. Results come back as summaries and pages rather than whole frameworks, which can hold thousands of items.

📘 Full documentation: User Guide

This is an independent project that reads the public SuitCASE API. It is not an official GaDOE service.

🛠️ Tools

Every list is paged with limit (max 200) and offset, and returns next_offset when there's more.

Related MCP server: University Course Catalog MCP Server

🚀 Quick Start

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m gacaseMCP.main          # stdio MCP server

Inspect the tools interactively with the MCP Inspector (from mcp[cli]):

mcp dev main.py

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "gacaseMCP": {
      "command": "/path/to/gacaseMCP/.venv/bin/python",
      "args": ["-m", "gacaseMCP.main"],
      "env": { "PYTHONPATH": "/path/to/gacaseMCP" }
    }
  }
}

Antigravity CLI picks up .agents/mcp_config.json automatically.

⚙️ Configuration

Frameworks are downloaded once and cached, so walking the tree or searching repeatedly doesn't re-download multi-megabyte packages.

🧪 Tests

pip install -e ".[test]"
python -m pytest

Tests run against synthetic CASE responses (no network).

Notes on Georgia's data

• Georgia lists retired frameworks alongside current ones (for example, the Georgia Standards of Excellence ELA framework is Deprecated; the current K–12 ELA framework is Adopted). Check adoption_status before aligning to a framework.

• Some item codes repeat within a framework. get_item returns the candidates and asks for an identifier when a code is ambiguous.

• Item types differ by framework: ELA uses Domain / Big Idea / Standard / Skill; CTAE uses Course / Content Standard / Element / Component. get_framework_by_id lists the types in each.