Skip to content

Use Resumly from MCP clients

Resumly ships a remote MCP server for Cursor, Claude Code, VS Code, and other clients that can attach a custom HTTP authorization header. Connect it once and drive your job search in plain English: refresh searches, browse matched jobs, tailor resumes, apply, track applications, and prep for interviews.
Endpoint https://mcp.resumly.ai/mcp (Streamable HTTP)
Auth (v1) Header Authorization: Bearer rly_... (or X-API-Key: rly_...)
Get a key app.resumly.ai → Settings → API — your first key includes a $5 trial credit

Connect your client

Hosted clients use a different authentication contract:

What a session looks like

The server exposes 21 tools that cover the full daily loop. A typical conversation:

You: What's new in my Resumly job searches?

Assistant: (calls list_saved_searches — free) Your "Data Eng — remote" search was last refreshed 2 days ago. Want me to refresh it? That costs $0.05.

You: Yes, refresh it and show anything above 80% match.

Assistant: (calls refresh_job_search, then list_matched_jobs) 12 new jobs. Top matches: 91% Senior Data Engineer @ Acme ($160–190k, remote, auto-apply eligible), 84% Platform Engineer @ Globex...

You: Tailor my resume for the Acme one.

Assistant: (calls tailor_resume — $0.25, takes 1–2 minutes) Done — your tailored resume is ready, DOCX link included.

You: Apply to it.

Assistant: (calls apply_to_job — free quote step) This will submit a real application to Senior Data Engineer @ Acme for $0.50, billed only if the submission is confirmed. Shall I proceed?

You: Go ahead.

Assistant: (calls confirm_apply) Queued. Track it any time with your application tracker — and when a reply lands, I can research the company and prep interview questions.

Later: "Any employer replies?" → get_employer_replies (free), then research_company ($0.25) and interview_prep ($0.10) before the interview.

How billing works

  • Reads are free. Browsing searches, jobs, application status, employer replies, resume status, and your balance never costs anything.
  • Metered operations state their price in the tool description and on the rate card, so the assistant can quote costs before acting.
  • Failures are never billed — any failed metered operation refunds automatically.
  • Applications bill only on confirmed submission. confirm_apply reserves $0.50; it's charged only once the submission is confirmed, and refunded on failure or cancellation.
  • Applying is two-step by design. apply_to_job is a free quote that returns the price and a confirmation token; nothing is submitted until the user approves and the assistant calls confirm_apply.
  • Your prepaid balance is a hard spend cap. At $0.00, metered tools stop working until you top up — the assistant can never overspend your wallet. Top up from the dashboard, or ask for a top-up link (buy_resumly_credit returns a Stripe checkout URL for you to open).

Pages in this section

Prefer code? The Python SDK drives the same pay-per-use API.