curl https://cv-matching-api.fly.dev/api/match \
  -H "X-API-Key: sk_live_your_key_here" \
  -F "cvs=@resume.pdf" \
  -F "jd_text=Registered Nurse — ICU Department..."

# With a text JD
curl -X POST https://cv-matching-api.fly.dev/api/match \
  -H "X-API-Key: sk_live_your_key_here" \
  -F "cvs=@resume1.pdf" \
  -F "cvs=@resume2.pdf" \
  -F "jd_text=Warehouse Associate — Day shift, forklift certification preferred..."

# With a file JD
curl -X POST https://cv-matching-api.fly.dev/api/match \
  -H "X-API-Key: sk_live_your_key_here" \
  -F "cvs=@resume.pdf" \
  -F "jd_file=@job_description.pdf"

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "cv_count": 3,
  "message": "Job created. Poll /api/match/{job_id} for results.",
  "skipped_cvs": []
}

curl https://cv-matching-api.fly.dev/api/match/550e8400-e29b-41d4-a716-446655440000/progress \
  -H "X-API-Key: sk_live_your_key_here"

{
  "status": "processing",
  "total": 3,
  "completed": 1,
  "pending": 1,
  "processing": 1
}

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "results": [
    {
      "cv_filename": "alice_chen_resume.pdf",
      "match_score": 82,
      "executive_summary": "Strong backend engineer with 6 years of Python and FastAPI experience. Excellent systems design skills with minor gaps in frontend technologies.",
      "strengths": [
        "6 years of Python development including FastAPI and Django",
        "Strong systems design and distributed systems experience",
        "AWS and Docker deployment experience"
      ],
      "gaps": [
        "No React or frontend framework experience listed",
        "Limited experience with the specific industry domain"
      ],
      "recommendation": "Interview",
      "verdict": "STRONG_MATCH"
    },
    {
      "cv_filename": "bob_smith_resume.pdf",
      "match_score": 31,
      "executive_summary": "Junior developer with limited experience in the required tech stack. Shows potential but lacks seniority for the role.",
      "strengths": [
        "Computer Science degree from reputable university",
        "Some exposure to Python through coursework"
      ],
      "gaps": [
        "Only 1 year of professional experience vs 5+ required",
        "No production API development experience",
        "Missing cloud infrastructure skills"
      ],
      "recommendation": "Not recommended",
      "verdict": "WEAK_MATCH"
    }
  ]
}

import time
import requests

API_KEY = "sk_live_your_key_here"
BASE = "https://cv-matching-api.fly.dev"
headers = {"X-API-Key": API_KEY}

# 1. Submit match job
with open("alice.pdf", "rb") as f1, open("bob.pdf", "rb") as f2:
    resp = requests.post(
        f"{BASE}/api/match",
        headers=headers,
        files=[
            ("cvs", ("alice.pdf", f1, "application/pdf")),
            ("cvs", ("bob.pdf", f2, "application/pdf")),
        ],
        data={"jd_text": "Construction Project Manager — 5+ years commercial builds..."},
    )
job = resp.json()
job_id = job["job_id"]
print(f"Job created: {job_id}")

# 2. Poll until complete (timeout after ~4 min)
for _ in range(120):
    progress = requests.get(
        f"{BASE}/api/match/{job_id}/progress", headers=headers
    ).json()
    print(f"  {progress['completed']}/{progress['total']} done")
    if progress["status"] == "completed":
        break
    if progress["status"] == "failed":
        raise RuntimeError("Job failed")
    time.sleep(2)

# 3. Get results
results = requests.get(
    f"{BASE}/api/match/{job_id}", headers=headers
).json()

for r in results["results"]:
    print(f"{r['cv_filename']}: {r['match_score']}/100 — {r['verdict']}")

{
  "detail": "Invalid or missing API key"
}

{
  "mcpServers": {
    "cv-matching": {
      "command": "python",
      "args": ["~/mcp_server.py"],
      "env": {
        "CV_MATCH_API_URL": "https://cv-matching-api.fly.dev",
        "CV_MATCH_API_KEY": "your-api-key-here"
      }
    }
  }
}

# In Claude Desktop, just ask:
"Match these CVs against the Senior Engineer JD"

# Claude will use the MCP tools to:
# 1. Call match_cvs with your file paths
# 2. Poll get_match_progress until complete
# 3. Retrieve results with get_match_results
# 4. Present the ranked candidates