Mercor MCP proxy

The single source of truth for the Mercor MCP proxy. The proxy lets an SPL mint scoped, expiring access tokens for experts in front of the one Mercor MCP key. This repo replaced the copy in ChristianNorth/cc-mercor on 2026-07-30; every change lands here.

Layout

• server/ — the Modal app and its Supabase migrations (server/supabase/migrations/).
• skills/mercor-mcp-proxy-spl/ — the SPL skill: mint and manage scoped expert keys, scope presets from the agreed catalog, usage.
• skills/mercor-mcp-proxy-expert/ — the expert skill: make Mercor requests with a scoped access key.
• tests/ — the full suite (~1,500 unit tests, plus 5 Postgres-backed integration tests for the migrations; those need pgserver or a MERCOR_PROXY_PG_DSN server and skip otherwise). CI runs everything on Python 3.12, where pgserver gives the integration tests a real Postgres.
• scripts/setup_mercor_api_proxy_supabase.py — provisions the Supabase tables and the Modal secret. Re-runs preserve every key names.py reads.

Develop

pip install -r requirements-dev.txt
pytest tests

The two skill packages share their scripts/ files byte for byte; tests/unit/test_mercor_proxy_package_split.py enforces it. Every hand-authored file stays under 600 lines.

Deploy

cd server && modal deploy modal_app.py

Deploys to https://mercor-rl--mercor-api-proxy-api.modal.run (MCP at /mcp).

Install a skill

Copy a skill folder into ~/.claude/skills/ (or symlink it to this clone). One key pasted into the .env the skill opens; nothing else. No secrets live in this repo.