MCP tool reference

Get your ranked Upwork job feed from Vibeworker. Returns jobs scored and ranked by match to your profile. Use this to find the best opportunities to apply to.

Search your Upwork job database by keyword. Searches job titles and descriptions from the last 48 hours.

Get full details for a specific Upwork job including description, client info, all scores, and direct Upwork URL. Use before drafting a proposal.

Record what happened with a job. Stages (saved, applied, interviewing, won, lost) are stamped with the current time on the job's Activity row; pass undo:true to clear one. skipped hides the job from the feed. rejected logs that you passed on it. Notes are appended to the Activity row. Every stage that changes the dashboard card changes it here too.

The freelancer's Activity tab: every job they saved, drafted a proposal for, applied to, or recorded an outcome on, newest activity first, with the date each stage was reached and their notes. Rows outlive the job feed, so this is the place to answer "what happened with the jobs I applied to". Use update_job_status to move a job along; get_proposal to read a draft.

Get everything needed to draft a proposal for a specific job: full job details, the client's screening questions, the freelancer's persona (projects, past jobs with client quotes, rate), their style notes, and the writing rules to follow. Call this before drafting a proposal yourself; subscribers can call generate_proposal instead.

Generate a proposal with Vibeworker's own writer: a cover letter, one answer per screening question, and which persona items it drew on. Uses the persona and style notes. Saved to the job so it appears in the dashboard. Subscribers only; free accounts should call get_proposal_context and draft it themselves.

Save a proposal you wrote or edited for a job, so it sits on the job's Activity row next to the freelancer's notes and stages. Call get_proposal_context first for the job, screening questions, persona and writing rules. Calling again for the same job replaces the draft, so this is also how you revise one (including one from generate_proposal). Free on every plan. Does not submit anything to Upwork.

List proposals generated for this account, newest first, with the job each belongs to.

Get the freelancer persona used to write proposals: name, title, rate, overview, skills, proof points, portfolio projects, past jobs with client quotes, employment, and the style notes proposals must follow. Separate from get_profile, which is the text the job feed is ranked against.

No parameters.

Update the freelancer persona used for proposals. Pass only the fields to change. Scalar fields replace, list fields (skills, projects, workHistory, employment) replace the whole list when given, so read with get_persona first and send the full list back. proposalNotes are free-text style instructions every proposal follows.

Parse the text of an Upwork profile page (select-all, copy) into the structured persona: name, title, rate, overview, skills, portfolio, work history with client feedback, employment. Saves it when the persona is empty; otherwise returns the parsed result for review unless overwrite is true. Limited to a few imports per day.

Get your Vibeworker freelancer profile — skills, niche, scoring mode, and subscribed categories. Useful context before evaluating jobs.

No parameters.

Update the freelancer profile Vibeworker uses to score and rank jobs, and/or the scoring mode. Updating profileText re-embeds your profile and re-matches your recent job history, so this can take a few seconds.

List all of your filter presets, including which one is active for the dashboard and which for notifications.

No parameters.

Create a new filter preset (a saved set of job-matching rules — budget, keywords, categories, etc). This is how you set up Vibeworker's feed and notifications for a user from scratch.

Update an existing filter preset. Only the fields you pass are changed — everything else on the filter is left as-is.

Tighten or loosen a filter's client-quality bar until it lands near a target number of jobs per day, using the last 7 days of jobs in its categories. Same ratchet onboarding uses. Returns the resulting filters; pass apply: true to save them onto the filter.

Make a filter the active one for either the dashboard feed or notifications.

Reorder your filter presets (affects dashboard tab order).

Permanently delete a filter preset. This cannot be undone.

Configure which notification channels fire for a filter, and the score threshold that triggers them.

Connect Telegram for job alerts. Returns a one-time link the freelancer opens in Telegram to link their account; it expires in 15 minutes. After linking, turn Telegram on for a filter with update_filter_notifications.

No parameters.

Turn on the private RSS feed for a filter and return its URL, for feed readers, Zapier, Make, or n8n. Returns the existing URL if the feed is already on. Subscribers only.