Workopia

ai-resume-tailor MCP server

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 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:

• 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)

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

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.

---

API

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	Job search + career advice via MCP	Free
Workopia Premium	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 — AI job search, resume builder, and career advice.