Skip to main content

Available MCP Tools

The Flowxtra MCP server provides 31 tools organized into 5 categories.


Jobs (9 tools)​

list-jobs​

List all jobs for your company with optional filters.

ParameterTypeRequiredDescription
statusstringNoFilter: Live, Draft, Archived, Expired, Closed
departmentstringNoFilter by department/category ID
limitintegerNoMax results (default: 20)

Example prompt: "List my live job postings"


get-job​

Get detailed information about a specific job.

ParameterTypeRequiredDescription
idstringYesJob hash_id

get-job-details​

Get full job details including application questions, skills, benefits, pipeline stages, and candidate count.

ParameterTypeRequiredDescription
idintegerYesJob ID

get-job-candidates​

Get all candidates for a specific job with their stage, status, and contact info.

ParameterTypeRequiredDescription
job_idintegerYesJob ID

create-job​

Create a new job posting.

ParameterTypeRequiredDescription
titlestringYesJob title
descriptionstringNoJob description (HTML supported)
requirementsstringNoJob requirements
statusstringNoLive or Draft (default: Draft)
workplacestringNoOn-site, Remote, Hybrid

Example prompt: "Create a draft job posting for a Senior React Developer, remote, full-time"


update-job​

Update an existing job.

ParameterTypeRequiredDescription
idintegerYesJob ID
titlestringNoNew title
descriptionstringNoNew description
statusstringNoLive, Draft, Archived
workplacestringNoNew workplace type

delete-job​

Delete (archive) a job posting.

ParameterTypeRequiredDescription
idintegerYesJob ID

publish-job​

Publish a draft job or change its status.

ParameterTypeRequiredDescription
idintegerYesJob ID
actionstringYespublish, unpublish, archive, close

Example prompt: "Publish the Flutter Developer job"


manage-application-form​

Manage a job's application form: set CV/cover letter requirements and add screening questions.

ParameterTypeRequiredDescription
job_idintegerYesJob ID
actionstringYesview, update-documents, add-question, remove-question
cv_requiredstringNotrue/false (for update-documents)
cover_letter_requiredstringNotrue/false (for update-documents)
questionstringNoQuestion text (for add-question)
question_typestringNotext, yes_no, select, multi_select
is_requiredstringYes*true/false — required when adding a question
question_idintegerNoQuestion ID (for remove-question)

Example prompt: "Add a required question 'What is your salary expectation?' to the Senior Developer job"


Candidates (9 tools)​

list-candidates​

List candidates with optional filters.

ParameterTypeRequiredDescription
job_idintegerNoFilter by job
statusstringNoFilter by status
stagestringNoFilter by pipeline stage
limitintegerNoMax results (default: 20)

get-candidate​

Get detailed candidate information including profile, applied job, and current stage.

ParameterTypeRequiredDescription
idintegerYesCandidate job ID

move-candidate-stage​

Move a candidate to a different pipeline stage. Optionally send the stage's email template.

ParameterTypeRequiredDescription
idintegerYesCandidate job ID
stage_idintegerYesTarget stage ID (get from list-pipelines)
send_emailstringNotrue/false — send stage email template (default: false)

Example prompt: "Move candidate #5 to the Interview stage and send them the email"


reject-candidate​

Reject a candidate or undo a rejection.

ParameterTypeRequiredDescription
idintegerYesCandidate job ID
actionstringYesreject or undo

list-rating-sheets​

List rating sheet templates or candidate ratings.

ParameterTypeRequiredDescription
typestringNotemplates or candidate
candidate_idintegerNoCandidate job ID (for type=candidate)

submit-rating-sheet​

Submit a rating for a candidate — fill in answers, rate attributes (1-5), and add recommendations.

ParameterTypeRequiredDescription
candidate_idintegerYesCandidate job ID
template_idintegerYesRating sheet template ID
recommendationstringNoe.g., "Definitely Yes", "Yes", "Maybe", "No"
conclusionsstringNoOverall conclusions
answersstringNoPipe-separated answers: `"Good
scoresstringNoPipe-separated scores 1-5: `"4

create-rating-sheet-template​

Create a new rating sheet template with interview questions and evaluation attributes.

ParameterTypeRequiredDescription
namestringYesTemplate name (e.g., "Technical Interview")
questionsstringYesPipe-separated questions: `"Experience?
attributesstringYesPipe-separated attributes: `"Communication

Example prompt: "Create a rating sheet called 'Screening Call' with questions about motivation and experience"


search-skill-reservoir​

Search the talent pool by name, email, skills, job title, city, or country.

ParameterTypeRequiredDescription
actionstringNosearch or list (default: search)
searchstringNoSearch term (for action=search)

Example prompt: "Search my talent pool for candidates with Python skills in Germany"


invite-to-job​

Invite a person from the talent pool to apply for a job.

ParameterTypeRequiredDescription
skill_reservoir_idintegerYesTalent pool entry ID (from search-skill-reservoir)
job_idintegerYesJob ID to invite them to
send_emailstringNotrue/false — send invitation email
email_subjectstringNoCustom email subject
email_messagestringNoCustom email body

Example prompt: "Invite the React developer from my talent pool to the Frontend Engineer job and send them an email"


Company (8 tools)​

get-company​

Get your company profile information.

No parameters required.


list-offices​

List all company offices/locations.

No parameters required.


get-office​

Get details for a specific office.

ParameterTypeRequiredDescription
idintegerYesOffice ID

list-pipelines​

List all hiring pipelines with their stages.

No parameters required.

Example prompt: "Show me my hiring pipelines and their stages"


list-team-members​

List all team members (non-candidate users).

No parameters required.


list-workspaces​

List all workspaces the user has access to.

No parameters required.


manage-company-customization​

Manage departments, job categories, benefits, and company values.

ParameterTypeRequiredDescription
sectionstringYesdepartments, job_categories, benefits, values
actionstringYeslist, add, remove
namestringNoName of item to add
descriptionstringNoDescription (for values)
item_idintegerNoID of item to remove

Example prompt: "Add 'Engineering' as a new department"


manage-contracted-companies​

Manage contracted companies (clients).

ParameterTypeRequiredDescription
actionstringYeslist, get, create, update, delete
company_idintegerNoCompany ID (for get, update, delete)
searchstringNoSearch by name, phone, or address
namestringNoCompany name (for create/update)
emailstringNoCompany email
phonestringNoPhone number
websitestringNoWebsite URL
addressstringNoStreet address
country_idintegerNoCountry ID

Social Media (3 tools)​

list-social-accounts​

List all connected social media accounts (LinkedIn, Facebook, Instagram, Twitter).

No parameters required.


create-social-post​

Create a social media post.

ParameterTypeRequiredDescription
contentstringYesPost content/text
schedule_atstringNoSchedule date/time (ISO 8601). Leave empty for draft.

Example prompt: "Create a LinkedIn post announcing our new Senior Developer position"


list-social-posts​

List social media posts with optional status filter.

ParameterTypeRequiredDescription
statusstringNodraft, scheduled, published, failed
limitintegerNoMax results (default: 10)

Meetings (2 tools)​

create-meeting​

Schedule a meeting (Google Meet or Zoom).

ParameterTypeRequiredDescription
titlestringYesMeeting title
start_timestringYesStart date/time (ISO 8601, e.g., 2026-04-10T14:00:00)
durationintegerNoDuration in minutes (default: 30)
typestringNogoogle_meet or zoom (default: google_meet)
candidate_idintegerNoCandidate to invite
descriptionstringNoMeeting notes

Example prompt: "Schedule a 45-minute interview via Google Meet with the top candidate for next Monday at 2pm"


list-meetings​

List scheduled meetings.

ParameterTypeRequiredDescription
statusstringNoscheduled, in_progress, completed, canceled
limitintegerNoMax results (default: 10)

Example Workflows​

Hiring Pipeline​

"List candidates for the Flutter Developer job" → "Move candidate #12 to the Interview stage and send the email" → "Create a meeting for the interview next Wednesday at 10am"

Talent Sourcing​

"Search my talent pool for React developers in Berlin" → "Invite the best match to the Frontend Engineer job with a personalized email"

Job Publishing​

"Create a new job for a Senior Backend Developer, remote, with a description about microservices" → "Add screening questions about experience and salary expectations" → "Publish the job"

Candidate Evaluation​

"List the rating sheet templates" → "Submit a rating for candidate #5 using the Technical Interview template — strong on problem solving, good communication"

info

Note: The AI does not make matching or ranking decisions. All candidate evaluation and selection decisions are made by the hiring manager. The AI helps with listing, summarizing, creating, and automating recruitment tasks faster.