Save a new job application to track. Use this when the user wants to save or add a job they're interested in or have applied to.

Get the user's saved jobs with their current status. Use this to check job application status, list all jobs, or find specific jobs.

Get full details of a specific job by ID, including description, skills, notes, and evaluation data.

Update the status of a job application. Use this when the user's application progresses (got an interview, received offer, was rejected, etc.)

Delete a saved job. Use this when the user wants to remove a job from their list.

Star or unstar a job to mark it as important.

Add a note to a job application. Use this when the user wants to record information about a job (e.g., interviewer name, follow-up date, salary info).

Update an existing note on a job application.

Delete a note from a job application.

Get the saved CV/resume evaluation for a specific job.

Get the saved cover letter for a specific job.

Perform bulk operations on multiple jobs at once: delete, reject, or advance to next stage.

Get an overview of the user's job search progress including job counts by status, scraping metrics, document counts, and feature usage. Great for answering 'how is my job search going?'

Use AI to evaluate how well the user's profile/resume matches a specific job. Returns a fit score and detailed analysis.

Use AI to generate a tailored cover letter for a specific job based on the user's profile/resume.

Use AI to generate practice interview questions for a specific job. Choose between technical or behavioral questions.

Conduct an AI-powered mock interview for a specific job. Simulates a real interview experience.

Get the mock interview report for a specific job.

Use AI to generate personalized coffee chat introduction messages based on a person's profile.

Find people available for coffee chats / networking. Use this when the user wants to connect with professionals, find mentors, or network in a specific industry.

Send a coffee chat request to a user. Use this after finding contacts with find_coffee_contacts.

Get the user's coffee chat requests - either sent or received.

Get the user's own coffee chat profile.

Create or update the user's coffee chat profile to make themselves available for networking.

Delete the user's coffee chat profile, removing them from the networking pool.

Accept or decline a received coffee chat request.

Get messages in a coffee chat conversation.

Send a message in a coffee chat conversation.

Get coffee chat statistics (requests sent, received, accepted, etc.).

Get the user's notifications. Use this when the user asks about updates, alerts, or what's new.

Mark all notifications as read.

Get the count of unread notifications.

Mark a single notification as read.

Delete a notification.

Get the user's profile information including skills, experience, education, and projects.

Update basic profile information (name, headline, bio, location).

Update the user's skills list.

Update the user's employment history.

Update the user's education history.

Update the user's projects.

Update the user's references.

Update the entire user profile at once (all sections).

View someone's public portfolio by their identifier (username or slug).

List all user documents (CVs and cover letters).

Get details of a specific document by ID.

Delete a document (CV or cover letter).

Rename a document.

Check the user's current subscription status and plan details.

View available subscription plans and pricing.

Check if the user has access to a specific AI feature based on their subscription.

View the user's payment history.

Browse community posts and comments.

View a comment and its replies.

Post a new comment in the community.

Edit an existing comment.

Delete a comment.

Generate a CV/resume as PDF using AI based on the user's profile.

Generate a CV and save it to the user's documents.

Send a message to the JobJourney AI chatbot for career advice, job search tips, or general help.

View job scraping statistics from the browser extension.

View aggregated scraping statistics with breakdowns by website and time period.

Get the user's portfolio visit count.

Get detailed analytics for a portfolio page.

Check whether a newer published version of the local JobJourney plugin is available and show the update command.

Prepare the local scraping environment. Initializes local SQLite, checks Playwright/browser readiness, starts the background agent if needed, reports login status for supported sites, and returns the next recommended commands.

Find jobs for the user by scraping live listings from job sites (LinkedIn, SEEK, Jora, etc.). This is the primary tool for job searching — always use this when the user wants to find, search, or look for jobs. Enriches results with ATS detection, expands career pages, stores results locally, then opens the web app for visualization.

Schedule recurring job discovery. The jobjourney-agent will run the discovery engine daily at the requested time across all specified sources and store results locally.

List all scheduled job discovery cron jobs, including disabled ones. Shows schedule ID, keyword, location, sources, cron expression, enabled status, and last run time.

Enable or disable a scheduled job discovery cron job by its ID. The agent will pick up changes on its next reconcile cycle (within 60 seconds).

Permanently delete a scheduled job discovery cron job by its ID. Use list_schedules to see available IDs.

Permanently delete ALL scheduled job discovery cron jobs. Use with caution.

Show a summary of the most recent discovery run, including sources, job count, and the top stored jobs for that run.

Open a browser window for the user to log in to a job site (SEEK or LinkedIn). Saves cookies so future scrapes can access full job details including descriptions, salary, and applied status. Run this once per site before scraping.

Check if cookies exist for job sites. Shows which sites have saved login sessions.

Open a job application page in the browser. Detects aggregator sites (LinkedIn/Seek/Indeed) and resolves to the real application URL. Keeps the browser open for subsequent form-filling tool calls.

Extract all visible form fields from the current page. Returns structured data for each field including label, type, options, and a CSS selector for filling. Call open_application_page first.

Fill a single text input or textarea field on the current page. Use the selector from extract_form_fields.

Select an option in a dropdown, radio group, or checkbox. Tries matching by label text first, then by value.

Upload a CV/resume file to a file input on the current page. Uses the primary CV by default, or specify a document ID.

Click a button or link on the current page (e.g., Next, Submit, Continue). Returns whether the page URL changed or new content appeared.

Set a CV as the default/primary document for auto-apply resume uploads.

Take a screenshot of the current page for visual inspection. Useful for verifying form state, handling CAPTCHAs, or debugging unusual layouts.

Close the browser session and clean up resources.