# AI Resume Tailor

[![ai-resume-tailor MCP server](https://glama.ai/mcp/servers/workopia/ai-resume-tailor/badges/score.svg)](https://glama.ai/mcp/servers/workopia/ai-resume-tailor)

**Free, open-source AI resume tailor.** Automatically rewrite your resume to match any job description — ATS keyword optimization, skill matching, and bullet rewriting powered by GPT.

> **Don't want to self-host?** Use [workopia.io](https://workopia.io/pricing) for instant access — no setup, no API key needed. Premium includes unlimited auto resume tailoring, cover letter generation, and ATS scoring.

---

## What it does

1. **Paste** your resume (JSON or plain text) and a job description
2. **AI rewrites** your experience bullets to match the JD's keywords
3. **Skills merged** — JD-required skills added, ordered by relevance
4. **Summary updated** — highlights the strengths most relevant to the role
5. **Copy the result** and use it for your application

**Before:** Generic resume bullets that don't mention the JD's tech stack

**After:** Tailored bullets with exact ATS keywords woven in, matching the employer's language

---

## Quick Start (Hosted — Easiest)

No setup needed. Use [workopia.io](https://workopia.io):

- Free: 5 resume generations/day
- Premium ($9.9/mo): Unlimited tailoring + cover letters + ATS scoring
- Works with Claude Desktop, ChatGPT, Cursor via MCP

MCP endpoint: `https://workopia.io/api/mcp-gpt` (no API key for base features)

---

## Self-Host (Requires OpenAI API Key)

```bash
git clone https://github.com/workopia/ai-resume-tailor.git
cd ai-resume-tailor
npm install
```

Create `.env.local`:

```
OPENAI_API_KEY=sk-your-key-here
OPENAI_MODEL=gpt-4o-mini    # or gpt-4o for best quality
```

```bash
npm run dev
# Open http://localhost:3000
```

**Cost:** ~$0.01–0.03 per tailor (GPT-4o-mini). You pay OpenAI directly.

---

## How It Works

The tailoring prompt:

1. Preserves all factual data (companies, dates, education, titles)
2. Rewrites experience bullets to incorporate JD keywords
3. Uses **exact terminology** from the JD for ATS matching
4. Merges skills from resume + JD, ordered by relevance
5. Never fabricates technologies or years of experience

The prompt is identical to the one used in production at [workopia.io](https://workopia.io).

---

## API

```bash
curl -X POST http://localhost:3000/api/tailor \
  -H "Content-Type: application/json" \
  -d '{
    "resumeJson": {
      "summary": "Software engineer with 5 years experience...",
      "experience": [
        {
          "title": "Software Engineer",
          "company": "Acme Corp",
          "startDate": "2020",
          "endDate": "Present",
          "bullets": ["Built web applications", "Led team of 3"]
        }
      ],
      "skills": ["JavaScript", "React", "Node.js"]
    },
    "jobDescription": "We are looking for a Senior Frontend Engineer with experience in React, TypeScript, and AWS..."
  }'
```

Returns the tailored resume JSON with rewritten bullets and merged skills.

---

## Tech Stack

- **Next.js 15** — React framework
- **OpenAI GPT** — Resume rewriting (you provide your own API key)
- **Tailwind CSS** — Styling
- **TypeScript** — Type safety

---

## Workopia Ecosystem

| Product | What | Price |
|---------|------|-------|
| **ai-resume-tailor** (this repo) | Self-hosted auto resume tailoring | Free (MIT) + your OpenAI costs |
| **[Workopia Base](https://workopia.io)** | Job search + career advice via MCP | Free |
| **[Workopia Premium](https://workopia.io/pricing)** | Unlimited tailor + cover letters + ATS scoring | $9.9/mo |
| **Workopia Max** | Enterprise: batch tailor, ATS source data, auto-apply | Custom |

---

## License

MIT — use it however you want.

---

Built by [Workopia](https://workopia.io) — AI job search, resume builder, and career advice.