# BlitzApply

> BlitzApply is an AI agent that applies to jobs for you. Share a job-posting URL and it reads the description, picks (and optionally tailors) one of your resumes, applies via a cloud stealth browser — including ATS account creation via emailed one-time codes/links — and tracks the outcome from your connected inbox. You can drive all of it programmatically over REST, the Python/TypeScript SDKs, or MCP (so your own AI agent can run it).

Base URL: https://blitzapply.com
Authentication: API key prefixed `ba_`, created in the dashboard (Settings → API Keys), sent as the `X-API-Key` HTTP header. All usage (AI tokens + cloud-browser cost) is metered per account and billed to your balance.

## Start here
- [Developer docs](https://blitzapply.com/docs): API keys, REST endpoints, SDK quickstarts, and MCP setup.
- [SDKs & source (GitHub)](https://github.com/yogen-ghodke-113/blitzapply-sdk): Python (`pip install blitzapply`), TypeScript (`npm install @blitzapply/sdk`), and MCP docs.

## MCP server (connect a Claude/Cursor/agent)
- Endpoint: https://blitzapply.com/mcp  (Model Context Protocol over Streamable HTTP)
- Auth: `X-API-Key` header, or OAuth via the standard `/.well-known/oauth-*` discovery routes.
- Tools: submit_job_application, list_applications, get_application, list_resumes, get_usage, get_stats, search_inbox, get_inbox_connect_url

## Key REST endpoints
- POST /api/applications — apply to a job. Body: {"url": "<job posting URL>", "resumeId"?: "<id>", "tailor"?: true}
- GET  /api/applications — list your applications (newest first)
- GET  /api/applications/{id} — one application: status, cost, live view, outcome
- PATCH /api/applications/{id} — update (approve submit / cancel)
- GET  /api/users/{uid}/resumes — list your resumes
- POST /api/resume/extract — parse a resume PDF/image into structured data
- POST /api/agent/run — run the AI resume orchestrator (tailor/optimize)
- GET  /api/billing/summary — your usage + cost (what you will be billed)
- POST /api/keys — create an API key (GET list, DELETE /api/keys/{id} revoke)

## Legal & contact
- Privacy: https://blitzapply.com/privacy
- Terms: https://blitzapply.com/terms
- Security contact: https://blitzapply.com/.well-known/security.txt