Skip to content

Tool reference & rate card

The Resumly MCP server exposes 21 tools. Reads are FREE; metered tools state their price in their own description, so your assistant can quote costs before acting. Failures are never billed, and applications bill only on confirmed submission.

Account

Tool What it does Price
get_wallet_balance Your API credit balance and the full price card. The balance is a hard spend cap. FREE
buy_resumly_credit Returns a secure Stripe checkout URL to top up credit ($10 / $25 / $50 / $100) — you open it in your browser. FREE

Searches & the jobs board

Tool What it does Price
list_saved_searches Your saved job searches with refresh metadata (last_refreshed_at, new_jobs_last_run) — used to decide whether a refresh is worth it. FREE
refresh_job_search Fetch fresh jobs for one saved search; new jobs land already match-scored. If a run is already in progress you're not charged. $0.05
list_matched_jobs Your matched-jobs board — match scores, salary, work arrangement, auto-apply eligibility. Paginated summaries. FREE
get_job_details Full detail for one job: description, URL, score insight. FREE
import_job Bring any outside job posting into your board — parsed, match-scored, and flagged for auto-apply eligibility. Duplicates are not charged. $0.05

Documents

Tool What it does Price
tailor_resume Create an AI-tailored resume for a board job, a posting URL, or raw text. Takes 1–2 minutes; returns an operation_id to track with check_operation. DOCX included. Failures auto-refund. $0.25
get_resume_status Status + download link for a tailored resume. FREE
generate_cover_letter Write a cover letter for a completed tailored resume. $0.10

Tracking long-running work

Tailoring, applying and refreshing a search cannot finish inside one request, so they return an operation_id. These track all of them.

Tool What it does Price
check_operation Progress of any long-running operation. Stop when terminal is true. FREE
list_operations Your recent operations, newest first — for finding a lost operation_id or reconciling a batch. FREE

status is one of:

Status Meaning
queued Accepted, not started yet.
running In progress.
succeeded Finished — read result.
failed Finished — read error. Never billed.
needs_attention An application a human must finish. Not a failure — the reservation stays open until it resolves.

Applying — two-step by design

Tool What it does Price
apply_to_job Step 1 of 2: quote an application. Returns the job summary, the price, and a confirmation token — nothing is submitted yet. FREE
confirm_apply Step 2 of 2: submit the application you approved, via Resumly's auto-apply infrastructure. Returns an operation_id — track it with check_operation (minutes, not seconds). $0.50 — reserved at queue time, billed only on confirmed submission; failures and cancellations refund
get_application_tracker Your application pipeline (open / applied / interview / accepted / rejected / closed). FREE
get_employer_replies Employer emails from your managed Resumly inbox, auto-classified (interview invitation, offer, rejection, assessment, ...). FREE

Interview stage

Tool What it does Price
research_company Researched company brief for a job (live web research). Re-reading a finished brief is free. $0.25
interview_prep Job-specific interview questions generated from the job's requirements and your tailored resume. $0.10
grade_interview_answer Grade your practice answer to an interview question. $0.05

Search / fetch (deep-research compatibility)

Tool What it does Price
search Search your matched jobs by keyword; returns results with ids for fetch. FREE
fetch Fetch one job document by id. FREE

Billing rules, in short

  • Reads are always free.
  • Metered operations deduct from your prepaid wallet; the balance is a hard spend cap — at $0.00 metered tools stop until you top up.
  • Failed operations refund automatically; retries are idempotency-protected.
  • Applications reserve $0.50 and bill only on confirmed submission.

See How billing works for the full model.