api_key parameter for paid access.
claude mcp add ai-screening https://api.jobasean.com/mcp
claude mcp add ai-screening --registry io.github.vaughnyb/ai-screening
npx @smithery/cli install aiscreeningtool/ai-screening --client claude
io.github.vaughnyb/ai-screening v1.0.1src/chatgpthai/maya-api-v3/routers/mcp.py in the GitHub repo.
Screen a single candidate CV against a job role. Returns a 0-100 score, HIRE / INTERVIEW / HOLD / REJECT decision, strengths, gaps, and improvement tips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| resume_text | string | Yes | Full CV/resume text |
| job_title | string | Yes | Role being hired for |
| job_requirements | string | No | Key skills and requirements |
| api_key | string | No | Leave blank for free tier |
Screen multiple CVs at once and return them ranked highest-to-lowest score. More efficient than calling screen_candidate in a loop.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| resumes | array | Yes | Array of candidate objects: {name, resume_text} |
| job_title | string | Yes | Same role applied to all candidates |
| job_requirements | string | No | Key requirements |
| api_key | string | No | Leave blank for free tier |
Scan a person's social media profiles for behavioral signals. Returns 6 dimension scores (1-10): Online Professionalism, Written Communication, Interpersonal Disposition, Resilience, Community Engagement, Overall Impression. Also flags: profanity, employer complaints, threats, drug references.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| candidate_name | string | Yes | Person's full name |
| platforms | object | Yes | Platform-to-URL mapping: {"facebook":"...", "tiktok":"...", "instagram":"...", "twitter":"..."} |
| api_key | string | No | Leave blank for free tier |
Write a complete job description for a role. Returns structured JD with responsibilities, requirements, and benefits.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The role title |
| company_context | string | No | Industry, company size, location, key requirements, tone |
| api_key | string | No | Leave blank for free tier |
Generate screening interview questions for a job role. Returns a numbered list of questions.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The role |
| num_questions | integer | No | Number of questions (default 5, max 10) |
| api_key | string | No | Leave blank for free tier |
Create a CONNECT screening invite link. Employer shares the link with a candidate. When opened, the candidate sees the job role and questions, then records a video profile. Returns the invite URL.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_role | string | Yes | Shown to candidate |
| questions | array | No | Up to 10 screening questions |
| candidate_email | string | No | Pre-fills candidate email |
| api_key | string | No | Leave blank for free tier |
Submit a contact or demo request. Use only when the visitor has expressed genuine intent to buy, try, or be contacted.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| string | Yes | Contact email | |
| question | string | Yes | What they want — their words |
| name | string | No | Prospect's name |
| company | string | No | Company name |
| api_key | string | No | Leave blank for free tier |
Get current pricing for a specific product.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| product | string | Yes | One of: connect, aiva, maya_voice, maya_chat, rag_search, social_check, website, agent_packs, maya_api |
| api_key | string | No | Leave blank for free tier |
Search internal product documentation, deployment partner guides, and competitive analysis. Use when you need specific facts about products, pricing, or competitive positioning.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | Yes | Natural language query |
| api_key | string | No | Leave blank for free tier |
Search the live internet for current information. Use when the answer requires up-to-date data: salary benchmarks, company news, market rates, competitor activity, industry regulations.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | Yes | Search query — be specific |
| max_results | integer | No | Number of results (default 5, max 10) |
| api_key | string | No | Leave blank for free tier |
Submit a full interest/contact form on behalf of the visitor. Use after collecting name, email, and context-specific questions conversationally.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_name | string | Yes | Visitor's full name |
| string | Yes | Email address | |
| context | string | Yes | Form context slug: pricing-connect, connect, deployment-partner, about, etc. |
| company_name | string | No | Company or organisation |
| phone | string | No | Phone number |
| country | string | No | Country |
| industry | string | No | Their industry |
| team_size | string | No | Team or company size |
| timeline | string | No | When they want to start |
| page_extras | object | No | Context-specific answers |
| api_key | string | No | Leave blank for free tier |
Compare 2-5 AIVA-scored candidates head to head for a specific role. Ranks them and provides one-sentence reasoning per candidate.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| candidates | string | Yes | Candidate data: name, cv_score (0-100), and decision for each |
| job_title | string | Yes | The role they are being compared for |
| api_key | string | No | Leave blank for free tier |
From batch screening results, extract the top N candidates above a minimum score threshold. Returns a ranked shortlist.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| batch_results | string | Yes | Paste or describe the batch screening results |
| top_n | integer | No | How many to include (default 5) |
| min_score | integer | No | Minimum score to include (default 60) |
| api_key | string | No | Leave blank for free tier |
Review a candidate CV against a job title and flag missing or weak sections: missing skills, experience gaps, unquantified achievements, or formatting issues.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| cv_text | string | Yes | Full text of the CV |
| job_title | string | Yes | Role being assessed for |
| job_requirements | string | No | Key requirements or job description |
| api_key | string | No | Leave blank for free tier |
Generate STAR-format behavioural interview questions tailored to a specific role and industry. Different from generate_interview_questions which produces general questions.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The role |
| industry | string | No | Industry context (real estate, healthcare, legal, insurance) |
| competencies | string | No | Specific competencies to probe |
| num_questions | integer | No | Number of questions (default 5, max 10) |
| api_key | string | No | Leave blank for free tier |
Draft a pre-assessment brief to send a candidate — what the assessment covers, how long it takes, and what to expect.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The role |
| assessment_type | string | No | Type: Core Skills, Language, Behavioral, Custom (default: Core Skills) |
| duration_minutes | integer | No | Duration in minutes (default 20) |
| api_key | string | No | Leave blank for free tier |
Translate a numerical assessment score (0-100) into a plain-English hiring recommendation — what it signals and what to consider.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| score | integer | Yes | Assessment score (0-100) |
| job_title | string | Yes | The role assessed for |
| assessment_type | string | No | Type of assessment (Core Skills, Behavioral, etc.) |
| api_key | string | No | Leave blank for free tier |
Generate a behavioral assessment — empathy, task focus, service behavior, and stress response questions with a scoring rubric.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The role being assessed |
| industry | string | No | Industry context (real estate, healthcare, legal, insurance, schools) |
| candidate_name | string | No | Personalises the output |
| api_key | string | No | Leave blank for free tier |
Generate a core skills assessment covering typing, email writing, grammar, attention to detail, chat simulation, reading comprehension, and tone recognition.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The role being assessed |
| sections | string | No | Specific sections to include (default: all 7) |
| api_key | string | No | Leave blank for free tier |
Generate a language proficiency assessment in any of the 30 supported languages. Returns conversational prompts and a scoring guide.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| language | string | Yes | Target language (e.g. English, Thai, Tagalog) |
| job_title | string | Yes | Role for question context |
| proficiency_level | string | No | basic / intermediate / advanced (default: intermediate) |
| api_key | string | No | Leave blank for free tier |
Generate a domain knowledge assessment — property law, clinical protocols, insurance products, financial regulations, curriculum standards, etc.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | Yes | Knowledge domain (e.g. property law, clinical protocols) |
| job_title | string | Yes | The role |
| num_questions | integer | No | Number of questions (default 8, max 15) |
| api_key | string | No | Leave blank for free tier |
Generate a fully custom assessment. Define the subject, format, difficulty, and grading rubric. Any industry, any topic.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| subject | string | Yes | What the assessment tests |
| format | string | No | multiple-choice / open-ended / scenario-based / mixed (default: mixed) |
| difficulty | string | No | basic / intermediate / advanced (default: intermediate) |
| grading_rubric | string | No | What correct answers look like |
| num_questions | integer | No | Number of questions (default 8, max 15) |
| api_key | string | No | Leave blank for free tier |
Given completed social media scan data, produce a plain-English narrative recommendation — what the data signals, the risk level, and what to consider.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| scan_data | string | Yes | Social scan results — scores, flags, and notes |
| job_title | string | Yes | The role being considered |
| api_key | string | No | Leave blank for free tier |
Draft a professional message requesting consent before a social media profile scan. Clear, respectful, and explains what will be checked.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| candidate_name | string | Yes | Candidate's name |
| company_name | string | Yes | Your company name |
| job_title | string | Yes | The role they applied for |
| platforms | string | No | Platforms to be scanned (e.g. Facebook, LinkedIn) |
| api_key | string | No | Leave blank for free tier |
Draft a complete employment offer letter based on role, compensation, start date, and terms. Ready to review and send.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| candidate_name | string | Yes | Full name |
| job_title | string | Yes | Job title offered |
| company_name | string | Yes | Hiring company |
| salary | string | Yes | e.g. $45,000/year or 35,000 THB/month |
| start_date | string | Yes | Proposed start date |
| additional_terms | string | No | Benefits, conditions, or extras |
| api_key | string | No | Leave blank for free tier |
Write a short, marketing-focused job advertisement for LinkedIn, Facebook, or job boards. Built to attract applicants.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | The job title |
| company_name | string | Yes | Company or team name |
| key_benefits | string | No | Top 2-3 reasons to apply |
| platform | string | No | LinkedIn / Facebook / job board / all (default: all) |
| api_key | string | No | Leave blank for free tier |
Generate a tailored reference check questionnaire — the right questions to ask a referee to validate what matters most for the hire.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| job_title | string | Yes | Role being considered |
| candidate_name | string | No | Candidate's name |
| focus_areas | string | No | Areas to probe (reliability, leadership, technical skills) |
| num_questions | integer | No | Number of questions (default 8) |
| api_key | string | No | Leave blank for free tier |
Draft a 90-day probation check-in report template for a new hire — structured, consistent, and ready for the manager to complete.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| employee_name | string | Yes | Employee's name |
| job_title | string | Yes | Their job title |
| company_name | string | No | Company name |
| review_date | string | No | Scheduled review date |
| key_objectives | string | No | Objectives set at start of probation |
| api_key | string | No | Leave blank for free tier |
Run a structured B2B lead qualification. Returns a Hot/Warm/Cold scorecard, recommended product, and suggested next step.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| company_name | string | Yes | Prospect company |
| industry | string | Yes | Their industry |
| pain_point | string | Yes | Main problem they described |
| team_size | string | No | Employee count or hiring volume |
| budget | string | No | Budget range |
| timeline | string | No | How soon they want to start |
| api_key | string | No | Leave blank for free tier |
Format everything collected in a conversation into a clean intake summary — ready to hand to the lawyer, doctor, financial advisor, or case manager.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| conversation_notes | string | Yes | Key information from the conversation |
| industry | string | Yes | legal / healthcare / financial / insurance / real estate / schools / other |
| recipient_role | string | No | Who the summary is for (solicitor, GP, financial adviser) |
| api_key | string | No | Leave blank for free tier |
Generate industry-specific intake questions to ask a new client before they speak to a human. Legal, healthcare, financial, insurance, real estate, and school flows each have their own structure.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| industry | string | Yes | legal / healthcare / financial / insurance / real estate / schools |
| purpose | string | No | Purpose (new client onboarding, injury claim, property purchase enquiry) |
| num_questions | integer | No | Number of questions (default 10, max 20) |
| api_key | string | No | Leave blank for free tier |
Summarise a document in plain language — what it covers, the key points, and what someone reading it needs to know.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| document_text | string | Yes | Full text of the document |
| summary_length | string | No | brief (3-5 sentences) / standard (1 paragraph) / detailed (3-4 paragraphs) |
| audience | string | No | Who will read it (hiring manager, client, student, patient) |
| api_key | string | No | Leave blank for free tier |
Pull specific requirements, obligations, or conditions from a document — a job specification, insurance policy, legal contract, or regulatory guide.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| document_text | string | Yes | Full text of the document |
| requirement_type | string | No | all / eligibility / obligations / deadlines / qualifications / conditions (default: all) |
| api_key | string | No | Leave blank for free tier |
Evaluate a student or teacher application — qualifications, experience, fit for the role or programme, and any gaps.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| application_text | string | Yes | Application text or summary |
| role_or_programme | string | Yes | Teaching role or academic programme |
| institution_type | string | No | primary school, university, language school, vocational college |
| api_key | string | No | Leave blank for free tier |
Draft the enrollment information package to send a prospective student — programme details, requirements, dates, and next steps.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| programme_name | string | Yes | Programme or course name |
| institution_name | string | Yes | School or institution |
| start_date | string | No | Programme start date |
| requirements | string | No | Entry requirements |
| next_steps | string | No | What the student should do next |
| api_key | string | No | Leave blank for free tier |
Draft performance feedback for a student based on assessment results and notes. Structured, professional, and consistent.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| student_name | string | Yes | Student's name |
| subject_or_course | string | Yes | Subject or course |
| performance_notes | string | Yes | Assessment results or performance notes |
| tone | string | No | encouraging / neutral / constructive (default: constructive) |
| api_key | string | No | Leave blank for free tier |
Check passport validity against destination entry requirements. Flags 6-month rule violations and name mismatches between passport and booking.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| holder_name | string | Yes | Name as shown on passport |
| nationality | string | Yes | Passport holder's nationality |
| passport_expiry | string | Yes | Expiry date (YYYY-MM-DD) |
| destination | string | Yes | Destination country |
| travel_date | string | Yes | Travel date (YYYY-MM-DD) |
| booking_name | string | No | Name on booking (to check mismatches) |
| api_key | string | No | Leave blank for free tier |
Screen visa eligibility for a given nationality, destination, purpose, and duration. Returns visa-free / eVisa / embassy visit required plus a document checklist.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| nationality | string | Yes | Passport country |
| destination | string | Yes | Destination country |
| purpose | string | Yes | tourism, business, work, study, transit |
| duration_days | integer | Yes | Planned stay in days |
| api_key | string | No | Leave blank for free tier |
Audit all submitted travel documents against destination requirements. Flags missing, expired, or mismatched documents that would cause denied boarding.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| traveler_name | string | Yes | Traveler's full name |
| destination | string | Yes | Destination country |
| travel_date | string | No | Travel date (YYYY-MM-DD) |
| documents_submitted | string | Yes | List of submitted documents and details |
| api_key | string | No | Leave blank for free tier |
Track document compliance across a group of travelers. Generates a chase list showing who submitted what, who is missing documents, and who has expiring passports.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| destination | string | Yes | Group destination country |
| travel_date | string | No | Group travel date (YYYY-MM-DD) |
| roster | string | Yes | List of travelers: name, passport expiry, visa status, insurance status (one per line) |
| api_key | string | No | Leave blank for free tier |
Build a day-by-day travel itinerary. Organizes flights, hotels, attractions, restaurants, and local transport into a structured trip plan.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| destination | string | Yes | Destination city or country |
| start_date | string | Yes | Trip start (YYYY-MM-DD) |
| end_date | string | Yes | Trip end (YYYY-MM-DD) |
| travelers | integer | No | Number of travelers (default 1) |
| budget | string | No | budget / mid-range / luxury or amount |
| preferences | string | No | Interests, dietary needs, pace |
| api_key | string | No | Leave blank for free tier |
Generate a document collection request. Lists required files, validates arrivals, tracks missing items, and drafts chase reminders. Works across: travel, HR onboarding, legal, real estate, schools.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| person_name | string | Yes | Name of the person |
| context | string | Yes | Why documents are needed (new hire onboarding, group travel, legal case, etc.) |
| required_documents | string | Yes | List of documents to collect |
| deadline | string | No | Submission deadline |
| documents_received | string | No | Already received (for chase reminders) |
| api_key | string | No | Leave blank for free tier |
Generate a service agreement, employment contract, lease agreement, or NDA from structured intake data. Template-driven with industry-specific clause libraries.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contract_type | string | Yes | service agreement, employment contract, lease agreement, NDA, advisory agreement, etc. |
| party_a | string | Yes | First party name and role |
| party_b | string | Yes | Second party name and role |
| terms | string | Yes | Key terms: scope, duration, pricing, payment, special clauses |
| industry | string | No | Industry context for clause selection |
| effective_date | string | No | Contract start date |
| api_key | string | No | Leave blank for free tier |
Generate a payment invoice, balance statement, payment schedule, or account summary. Includes line items, tax, and payment methods.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| document_type | string | Yes | invoice, balance statement, payment schedule, or account summary |
| from_party | string | Yes | Issuer name and details |
| to_party | string | Yes | Recipient name and details |
| line_items | string | Yes | Line items with descriptions and amounts |
| due_date | string | No | Payment due date |
| payment_methods | string | No | Accepted payment methods |
| notes | string | No | Additional notes or tax details |
| api_key | string | No | Leave blank for free tier |
Generate a signature request to attach to any document. Produces the request message, tracks signing status, and drafts reminders.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| document_name | string | Yes | Document requiring signature |
| signer_name | string | Yes | Who needs to sign |
| sender_name | string | Yes | Who is requesting the signature |
| signer_email | string | No | Signer's email |
| deadline | string | No | Signing deadline |
| signing_status | string | No | pending / reminded / overdue (for follow-up) |
| api_key | string | No | Leave blank for free tier |
Design a timed document delivery sequence triggered by an event. Produces a schedule with documents, delivery dates, and content briefs.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trigger_event | string | Yes | Event that starts the sequence (new hire start date, enrollment confirmed, etc.) |
| industry | string | Yes | HR, schools, healthcare, insurance, real estate |
| recipient_name | string | No | Recipient's name |
| sequence_length_days | integer | No | Total length in days (default 30) |
| specific_documents | string | No | Documents to include (Maya suggests if not provided) |
| api_key | string | No | Leave blank for free tier |
Track document expiry dates across people and organisations. Generates a compliance report: current, expiring soon, and expired items with renewal actions.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| context | string | Yes | What is tracked (employee certifications, passport/visa expiry, medical licenses, etc.) |
| records | string | Yes | People/items with document names and expiry dates (one per line) |
| alert_window_days | integer | No | Days before expiry to flag (default 30) |
| api_key | string | No | Leave blank for free tier |
Generate an escalating payment reminder or demand letter. Level 1: friendly reminder. Level 2: formal notice. Level 3: final demand with legal action warning.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| notice_level | integer | Yes | 1 (friendly), 2 (formal), or 3 (final demand) |
| creditor_name | string | Yes | Party owed money |
| debtor_name | string | Yes | Party who owes |
| amount_owed | string | Yes | Amount with currency |
| original_due_date | string | No | Original payment due date |
| new_deadline | string | No | New deadline for payment |
| payment_methods | string | No | Accepted payment methods |
| invoice_reference | string | No | Invoice or account reference |
| api_key | string | No | Leave blank for free tier |
Compile collected data from any workflow into a structured, shareable slide deck outline with content for each slide.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| deck_type | string | Yes | property listing package, travel itinerary booklet, candidate profile deck, project proposal, etc. |
| audience | string | Yes | Who receives the deck (hiring committee, property buyer, prospective students) |
| data | string | Yes | Raw data, notes, or content to compile |
| branding | string | No | Company name and branding notes |
| slide_count | integer | No | Target number of slides (default 8-12) |
| api_key | string | No | Leave blank for free tier |
This page documents all 49 MCP tools available when you connect Claude to the AI Screening Tools MCP server at api.jobasean.com/mcp. MCP (Model Context Protocol) lets Claude call our AI agent tools directly — screen a candidate CV, run a behavioural assessment, scan a social profile, generate an offer letter, check passport validity, build a travel itinerary, or draft a demand letter — without any custom code or API wrappers. Tools span 10 categories: Core Tools, Candidate Scoring, Interview, Assessments, Social Intelligence, Document Generation, Client and Patient Intake, Knowledge and Extraction, Education, Travel, and File Utilities. Built for any organisation that screens, qualifies, or intakes a second party before committing human time — across real estate, legal, healthcare, financial advisory, insurance, schools, HR, logistics, and more. Free tier: 3 tool calls per day per IP. Get a reset token at aiscreeningtools.com/mcp-access for 3 more free daily calls.