MCP server
SSA Administrative Law Judges (ALJ) Open Data
MCP URL
https://www.ssa-alj-mcpserver-gsahackathon.online/mcp
Streamable HTTP
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
| Tool | Description |
|---|---|
ssa_alj_list_reports | List FY coverage and report 'as of' dates |
ssa_alj_business_queries | List or match curated SSA ALJ business questions |
ssa_alj_source_links | SSA source HTML/XML links for a report snapshot |
ssa_alj_search_judges | Find the published spelling of an ALJ name |
ssa_alj_get_judge_profile | Year-by-year disposition profile for one ALJ |
ssa_alj_compare_offices | Rank hearing offices by disposition rates or volume |
ssa_alj_get_office_profile | Multi-year disposition profile for one hearing office |
ssa_alj_office_processing_ranking | SSA National Ranking by dispositions per day per ALJ |
ssa_alj_national_trend | Multi-year national or regional disposition series |
ssa_alj_monthly_pace | Within-year pace from consecutive FYTD snapshots |
ssa_alj_compare_periods | Biggest movers between two fiscal years |
ssa_alj_outlier_report | Peer z-score outliers for offices or judges |
ssa_alj_within_office_variation | Allowance-rate spread among judges inside an office |
ssa_alj_judge_movements | Judge headcount change and office-to-office moves |
ssa_alj_data_quality_notes | Dataset gaps, anomalies, and what is not published |