MCP tools reference

Every jobbydev_* MCP tool with its REST equivalent and required scope. Each tool is a thin wrapper over a v1 REST endpoint — the API reference carries full request / response shapes; this page is the conversational mirror.

Discovery (public)

Tool	REST	Scope	Summary
`jobbydev_live_now`	`GET /api/v1/live-events`	`—`	Currently-live events with attached roles.
`jobbydev_jobs_search`	`GET /api/v1/jobs`	`—`	Search jobs at currently-live events by skills, location, role.
`jobbydev_event_get`	`GET /api/v1/events/{slug}`	`—`	Single event detail with roles + recruiter info.

Profile + queue (seeker)

Tool	REST	Scope	Summary
`jobbydev_profile_get`	`GET /api/v1/profile`	`profile:read`	Read the seeker's profile.
`jobbydev_profile_set`	`PATCH /api/v1/profile`	`profile:write`	Update profile fields.
`jobbydev_queue_join`	`POST /api/v1/queue/join`	`queue:write`	Enter the queue for a live event.
`jobbydev_queue_status`	`GET /api/v1/queue/status`	`queue:read`	Read the seeker's queue position + estimated wait.
`jobbydev_queue_leave`	`POST /api/v1/queue/leave`	`queue:write`	Leave the current queue.
`jobbydev_resume_parse`	`POST /api/v1/profile/resume-parse`	`profile:write`	Parse a resume PDF into structured fields.

Matches + interview (seeker)

Tool	REST	Scope	Summary
`jobbydev_matches_list`	`GET /api/v1/matches`	`matches:read`	List recent matches (pending + decided).
`jobbydev_match_decline`	`POST /api/v1/matches/{id}/decline`	`matches:write`	Decline a pending match with a reason.
`jobbydev_interview_room_url`	`GET /api/v1/matches/{id}/interview-room-url`	`matches:read`	Fetch a one-time room URL for an accepted match.
`jobbydev_interview_summary`	`GET /api/v1/matches/{id}/summary`	`matches:read`	Read the post-interview report card structured fields.

Billing

Tool	REST	Scope	Summary
`jobbydev_billing_status`	`GET /api/v1/billing/status`	`billing:read`	Current plan + minutes balance.
`jobbydev_billing_invoices_list`	`GET /api/v1/billing/invoices`	`billing:read`	Invoice history.
`jobbydev_billing_portal_url`	`GET /api/v1/billing/portal-url`	`billing:write`	One-shot Stripe billing portal URL.
`jobbydev_create_upgrade_checkout`	`POST /api/v1/billing/checkout`	`billing:write`	Hosted or embedded Stripe Checkout for a plan upgrade.
`jobbydev_create_upgrade_charge_offsession`	`POST /api/v1/billing/charge-offsession`	`billing:write`	Silent off-session upgrade (requires consent).

Recruiter — events + jobs

Tool	REST	Scope	Summary
`jobbydev_create_event`	`POST /api/v1/live-events`	`events:write`	Create a scheduled live event.
`jobbydev_event_list`	`GET /api/v1/live-events`	`events:read`	List the recruiter's events.
`jobbydev_event_go_live`	`POST /api/v1/live-events/{id}/go-live`	`events:write`	Flip a scheduled event to live.
`jobbydev_event_end`	`POST /api/v1/live-events/{id}/end`	`events:write`	End a live event.
`jobbydev_job_create`	`POST /api/v1/jobs`	`jobs:write`	Create a role.
`jobbydev_job_get`	`GET /api/v1/jobs/{id}`	`jobs:read`	Read a role.
`jobbydev_job_update`	`PATCH /api/v1/jobs/{id}`	`jobs:write`	Update role fields.

Recruiter — matches + candidates

Tool	REST	Scope	Summary
`jobbydev_match_accept`	`POST /api/v1/matches/{id}/accept`	`session-only`	Accept a pending match. Browser-only — see the humans-only rule.
`jobbydev_candidates_saved_list`	`GET /api/v1/candidates/saved`	`candidates:read`	List saved candidates.
`jobbydev_candidates_save`	`POST /api/v1/candidates/saved`	`candidates:write`	Save a candidate without advancing.
`jobbydev_candidates_reinvite`	`POST /api/v1/candidates/{id}/reinvite`	`candidates:write`	Re-invite a saved candidate to a future event.
`jobbydev_candidates_compare_ai`	`POST /api/v1/candidates/compare-ai`	`candidates:read (Power Play)`	Anthropic-powered candidate comparison.
`jobbydev_team_invite`	`POST /api/v1/team/invite`	`team:write`	Mint a single-use team-invite link.

Settings + webhooks

Tool	REST	Scope	Summary
`jobbydev_settings_schema_get`	`GET /api/v1/settings/schema`	`settings:read`	Discoverable settings paths.
`jobbydev_settings_get`	`GET /api/v1/settings`	`settings:read`	Read a settings value.
`jobbydev_settings_set`	`POST /api/v1/settings`	`settings:write`	Write a settings value.
`jobbydev_webhook_create`	`POST /api/v1/webhooks`	`webhooks:write`	Subscribe to event webhooks.
`jobbydev_webhook_list`	`GET /api/v1/webhooks`	`webhooks:read`	List the user's webhook subscriptions.
`jobbydev_webhook_test`	`POST /api/v1/webhooks/{id}/test`	`webhooks:write`	Fire a synthetic test event.
`jobbydev_webhook_delete`	`DELETE /api/v1/webhooks/{id}`	`webhooks:write`	Delete a subscription.

Tool naming convention

Every tool is namespaced jobbydev_ so the agent can disambiguate from other connected MCP servers. Names are stable — we add new tools rather than renaming existing ones.