MCP server

SSA Administrative Law Judges (ALJ) Open Data

GSA MCP SI HACKATHON

MCP URL https://www.ssa-alj-mcpserver-gsahackathon.online/mcp Streamable HTTP
Health https://www.ssa-alj-mcpserver-gsahackathon.online/health

No trailing slash on the MCP URL. Health returns JSON.

Architecture

MCP client

Claude DesktopSettings → Connectors → custom connector
ChatGPT, MCPJam, Inspectorremote MCP URL
Local clientsGoose, Claude Code

Connection

Remote hosted MCP serverRender · HTTPS /mcp
Local processstdio subprocess

MCP server

FastMCP
Tools · 15 Resources Prompts
Services → db.pyparameterised SQL, read-only
SQLitedispositions, FY 2010–2026

MCP Flow

Clientasks a question
POST /mcpstreamable HTTP
FastMCPvalidates arguments
Toolasync wrapper
Serviceone SQL query
JSONfigures plus notes

Tools

ToolDescription
ssa_alj_list_reportsList FY coverage and report 'as of' dates
ssa_alj_business_queriesList or match curated SSA ALJ business questions
ssa_alj_source_linksSSA source HTML/XML links for a report snapshot
ssa_alj_search_judgesFind the published spelling of an ALJ name
ssa_alj_get_judge_profileYear-by-year disposition profile for one ALJ
ssa_alj_compare_officesRank hearing offices by disposition rates or volume
ssa_alj_get_office_profileMulti-year disposition profile for one hearing office
ssa_alj_office_processing_rankingSSA National Ranking by dispositions per day per ALJ
ssa_alj_national_trendMulti-year national or regional disposition series
ssa_alj_monthly_paceWithin-year pace from consecutive FYTD snapshots
ssa_alj_compare_periodsBiggest movers between two fiscal years
ssa_alj_outlier_reportPeer z-score outliers for offices or judges
ssa_alj_within_office_variationAllowance-rate spread among judges inside an office
ssa_alj_judge_movementsJudge headcount change and office-to-office moves
ssa_alj_data_quality_notesDataset gaps, anomalies, and what is not published