# JurisdictionMCPRemote

Hosted (Cloudflare Workers, TypeScript) rewrite of the SUTS jurisdiction MCP
server — so firm users connect over a URL with **zero local install** (Claude
Desktop native custom connector) instead of running Python locally.

**Status:** Phase A complete — Worker built and validated locally. 12/12 unit
tests pass, `tsc --noEmit` clean, and it serves MCP over HTTP via `wrangler dev`
(`resolve_address` returned Denver `10006` / `0.0915`; `check_cache_freshness`
correct). **Next: Phase B** — Microsoft Entra OAuth + deploy (see `HOSTING.md`).
The working local original is the sibling `JurisdictionMCP` repo — leave it
running until this is deployed and trusted.

Run locally: `npm install` → `npm test` → put `SUTS_API_KEY=...` in `.dev.vars`
→ `npm run dev` → drive with `node scripts/check.mjs` or the MCP Inspector.

## What's here now (seed / reference)

| Path | Purpose |
|------|---------|
| `CONTRACT.md` | **The spec to implement** — tool return shapes, TTR API, freshness rule + test vectors, rate-limit behavior. Build against this. |
| `HOSTING.md` | Full deployment roadmap + OAuth (firm-email) auth plan. |
| `samples/` | Real TTR responses — use as TS test fixtures. |
| `reference-python/` | The source-of-truth Python implementation being ported (`freshness.py`, `ttr_client.py`, tests). Not part of the Worker; reference only. |

## Next steps

See `HOSTING.md`. In short: install Node + wrangler, scaffold the McpAgent
(OAuth template), port the two tools per `CONTRACT.md`, add a Durable Object
rate-limiter, test with MCP Inspector, deploy, restrict auth to `@affinity.cpa`,
connect via Claude's native connector.