MCP Tools Reference — 22 AI Screening Tools for Claude

Connect Claude to our MCP server and these 22 tools become available in any Claude conversation. Free tier: 3 tool calls per day per IP. Use api_key parameter for paid access.

Connect Claude to this server — 3 ways

Direct URL (always works)

claude mcp add ai-screening https://api.jobasean.com/mcp

From the Official MCP Registry (Anthropic-backed, namespace io.github.vaughnyb/ai-screening)

claude mcp add ai-screening --registry io.github.vaughnyb/ai-screening

From Smithery

npx @smithery/cli install aiscreeningtool/ai-screening --client claude

Find us: GitHub — vaughnyb/chatgpthai · Smithery · Official MCP Registry: io.github.vaughnyb/ai-screening v1.0.1
MCP server source: src/chatgpthai/maya-api-v3/routers/mcp.py in the GitHub repo.

All 22 Tools at a Glance

#	Tool	Category	Auth	Type
01	screen_candidate	CV Screening	Public	Write
02	batch_screen	CV Screening	Public	Write
03	social_profile_scan	Social Check	Public	Write
04	set_social_keywords	Social Check	JWT	Write
05	search_jobs	Job Search	Public	Read
06	get_job	Job Search	Public	Read
07	create_invite	CONNECT Video	JWT	Write
08	list_videos	CONNECT Video	JWT	Read
09	ask_maya	Maya AI Chat	Public	Write
10	evaluate_text	Maya AI Chat	Public	Write
11	search_docs	Document Search	Public	Read
12	search_knowledge	Document Search	Public	Read
13	request_info	Contact	Public	Write
14	get_profile	Account	JWT	Read
15	list_jobs	Account	JWT	Read
16	get_aiva_status	Account	Public	Read
17	get_funnel_stats	Analytics	JWT	Read
18	get_video_stats	Analytics	JWT	Read
19	subscribe_newsletter	Newsletter	Public	Write
20	get_server_info	Discovery	Public	Read
21	get_categories	Discovery	Public	Read
22	get_countries	Discovery	Public	Read

Read = retrieves data, no side effects. Write = triggers an action (screening, scan, invite, subscribe). JWT = requires employer login token. Public = no auth, IP rate-limited (3/day free).

Layer 1 — Screening & Assessment

01screen_candidate Free tier

Screen a single candidate CV against a job role. Returns a 0–100 score, HIRE / INTERVIEW / HOLD / REJECT decision, rationale, strengths, and improvement tips. Free tier: 3 calls per day per IP (counted against your IP).

Parameter	Type	Required	Notes
job_title	string	Yes	Role you are hiring for
job_description	string	Yes	Full requirements
cv_text	string	Yes	Extracted plain text from CV
api_key	string	No	Leave blank for free tier

Example Claude prompt

"Screen this candidate for a Customer Service Representative role at a BPO in Cebu. CV: Maria Santos, 3 years call center experience at Teleperformance, handled inbound billing calls..."

02batch_screen Free tier

Screen multiple candidates at once. Pass an array of candidate objects. Returns ranked results sorted by score (highest first). Each candidate uses one free call from your daily limit.

Parameter	Type	Required	Notes
job_title	string	Yes	Same role applied to all candidates
job_description	string	Yes	Full requirements
candidates	array	Yes	Each item: `{name, cv_text}`
api_key	string	No	Leave blank for free tier

Example Claude prompt

"I have 5 CVs for a Collections Agent role. Screen all of them and rank them from best to worst fit. [paste CVs]"

Layer 1 — Social Profile Check

03social_profile_scan Free tier

Scan a candidate's social media profiles across up to 5 platforms. Returns 6 behavioral dimension scores (1–10) plus Part A text flag analysis (profanity, employer complaints, threats, drug references). IP-based rate limit — 3 scans per day.

Parameter	Type	Required	Notes
candidate_name	string	Yes	Candidate's full name
facebook_url	string	No	Full profile URL
tiktok_url	string	No	Full profile URL
instagram_url	string	No	Full profile URL
linkedin_url	string	No	Full profile URL
twitter_url	string	No	Full profile URL
api_key	string	No	Leave blank for free tier

Example Claude prompt

"Check the social media profile for candidate John Reyes before I move him to final round. His Facebook is facebook.com/john.reyes.xyz"

04set_social_keywords Auth required

Set custom keywords, competitor names, or BPO group names to flag during social scans. Useful for monitoring mentions of competitor companies or specific industry groups. Requires a JWT token from your employer account.

Parameter	Type	Required	Notes
keywords	array of strings	Yes	e.g. ["Concentrix", "resign", "toxic employer"]
auth_token	string	Yes	JWT from POST /api/login

Example Claude prompt

"Add 'Teleperformance', 'burned out', and 'looking for new job' to our social scan keyword list. Token: [paste token]"

Layer 1 — Job Search

05search_jobs Free tier

Search the job listings database using natural language. Returns matching jobs with titles, companies, locations, and summaries. Searches across all 13 countries unless a country_code is specified.

Parameter	Type	Required	Notes
query	string	Yes	Natural language search query
country_code	string	No	e.g. "ph", "in", "th" — leave blank for all
limit	integer	No	Max results (default 10, max 30)

Example Claude prompt

"Find customer service jobs in Cebu, Philippines with English requirements"

06get_job Free tier

Retrieve full details for a specific job listing by ID. Returns the complete job description, requirements, company name, location, and application details.

Parameter	Type	Required	Notes
job_id	string	Yes	ID from search_jobs results

Example Claude prompt

"Get the full details for job ID abc123 from the results you just showed me"

Layer 2 — CONNECT Video Profiles

07create_invite Auth required

Create a CONNECT screening invite link for a candidate. The link opens the video recording widget with your custom job role and questions pre-loaded. Valid for 7 days. Recorded video appears in your employer inbox after the candidate verifies their email.

Parameter	Type	Required	Notes
job_role	string	Yes	Shown to candidate in widget
questions	array	Yes	Up to 10 questions for the candidate
candidate_email	string	No	Pre-fills candidate's email
auth_token	string	Yes	JWT from POST /api/login

Example Claude prompt

"Create a video invite for a Collections Agent role. Ask them: 'Describe your collections experience' and 'How do you handle a customer who refuses to pay?' Send it to candidate@example.com. Token: [paste token]"

08list_videos Auth required

List all video submissions in your employer inbox. Returns candidate names, job roles, submission times, and Bunny CDN embed URLs for playback. Only returns fully verified and moderated videos.

Parameter	Type	Required	Notes
auth_token	string	Yes	JWT from POST /api/login
limit	integer	No	Max results (default 20)

Example Claude prompt

"Show me all the video submissions in my inbox from the past week. Token: [paste token]"

Layer 2 — Maya AI Chat

09ask_maya Free tier

Ask Maya a question about AI Screening Tools products, pricing, BPO workflows, or call center hiring. Maya has access to the full product knowledge base including deployment guides, pricing, and competitor comparisons.

Parameter	Type	Required	Notes
question	string	Yes	Any product or BPO question
country_code	string	No	e.g. "ph", "in" — for locale context

Example Claude prompt

"Ask Maya: what's the difference between the CONNECT Engage and Integrate tiers for a 300-agent BPO?"

10evaluate_text Free tier

Send any text to Maya for evaluation or analysis. More flexible than screen_candidate — use for evaluating cover letters, interview notes, chat transcripts, or any free-form candidate text that doesn't fit the CV format.

Parameter	Type	Required	Notes
text	string	Yes	The content to evaluate
instruction	string	Yes	What Maya should assess or look for
country_code	string	No	For locale context

Example Claude prompt

"Evaluate this interview note for English fluency signals and professionalism. Note: 'candidate was very like you know, not clear on the questions...'"

Layer 2 — Document Search (RAG)

11search_docs Free tier

Search the AI Screening Tools knowledge base using natural language. Returns relevant passages from product documentation, deployment guides, BPO licensing plans, and competitive analysis. This is a RAG search — returns the closest matching document chunks.

Parameter	Type	Required	Notes
query	string	Yes	Natural language query
top_k	integer	No	Number of chunks to return (default 5)

Example Claude prompt

"Search the AI Screening Tools docs for information about the deployment partner program and how commissions work"

12search_knowledge Free tier

Alias for search_docs with a broader scope. Also searches job category metadata, BPO role descriptions, and product comparison data. Use when search_docs returns insufficient results.

Parameter	Type	Required	Notes
query	string	Yes	Natural language query

Example Claude prompt

"What BPO roles can Maya Voice automate and what are the typical savings per role?"

Layer 2 — Contact & Leads

13request_info Free tier

Submit a contact or demo request on behalf of a prospect. Use when a Claude conversation surfaces genuine buying intent and the prospect wants to be contacted. Saves name, email, business type, and query to the leads database. Response within 24 hours committed.

Parameter	Type	Required	Notes
name	string	Yes	Prospect's name
email	string	Yes	Contact email
business_type	string	No	e.g. "BPO", "HR department", "staffing agency"
query	string	No	What they want to know or discuss

Example Claude prompt

"Submit a contact request for Carlos Mendez at a 200-agent BPO in Davao — he wants a demo of CONNECT. Email: carlos@dabaobpo.com"

Layer 2 — Account Management

14get_profile Auth required

Retrieve the profile for the authenticated employer account. Returns account name, email, user type, tier, and account status.

Parameter	Type	Required	Notes
auth_token	string	Yes	JWT from POST /api/login

Example Claude prompt

"Show me the account details for token [paste token]"

15list_jobs Auth required

List all job postings for the authenticated employer account. Returns job titles, status, posting dates, and application counts.

Parameter	Type	Required	Notes
auth_token	string	Yes	JWT from POST /api/login

Example Claude prompt

"Show all active job postings for my account. Token: [paste token]"

16get_aiva_status Free tier

Check the current AIVA usage status for a given API key. Returns calls used today, calls remaining, and key type (free tier / batch / monthly).

Parameter	Type	Required	Notes
api_key	string	No	Leave blank to check free tier for your IP

Example Claude prompt

"How many AIVA screenings do I have left today?"

Layer 3 — Analytics & Reporting

17get_funnel_stats Auth required

Get AIVA screening funnel statistics for your employer account. Returns total screenings, decision breakdown (HIRE/INTERVIEW/HOLD/REJECT counts), average score, and top-scoring roles.

Parameter	Type	Required	Notes
auth_token	string	Yes	JWT from POST /api/login
days	integer	No	Lookback period in days (default 30)

Example Claude prompt

"Give me my screening funnel stats for the last 7 days. Token: [paste token]"

18get_video_stats Auth required

Get CONNECT video submission statistics for your employer account. Returns total submissions, pending moderation count, approved count, and breakdown by job role.

Parameter	Type	Required	Notes
auth_token	string	Yes	JWT from POST /api/login

Example Claude prompt

"How many video profiles have been submitted to my account and how many are approved? Token: [paste token]"

Layer 3 — Newsletter

19subscribe_newsletter Free tier

Subscribe an email address to the BPO insights newsletter. Silent duplicate handling — no error on existing subscribers. New subscribers receive a welcome email and are added to the monthly drip sequence.

Parameter	Type	Required	Notes
email	string	Yes	Subscriber email address
language	string	No	2-letter language code (default "en")

Example Claude prompt

"Subscribe carlos@dabaobpo.com to the AI Screening Tools newsletter"

Layer 3 — Utility

20get_server_info Free tier

Returns MCP server metadata: tool count, server version, free tier limits, base URL, and links to documentation. Useful for agents discovering the server capabilities for the first time.

Parameter	Type	Required	Notes
No parameters

Example Claude prompt

"What tools are available on this MCP server and what are the rate limits?"

21get_categories Free tier

Returns the full list of 11 job categories and 76 subcategories used across the platform. Includes BPO subcategories (18 items: voice/non-voice/supervisory). Use when building screening prompts that need accurate industry classification.

Parameter	Type	Required	Notes
country_code	string	No	Filter to country-specific categories

Example Claude prompt

"List all BPO subcategories available on the AI Screening Tools platform"

22get_countries Free tier

Returns the 13 target countries supported by the platform with country codes, currency, and GDP context. Use when building region-specific screening prompts or filtering job searches by country.

Parameter	Type	Required	Notes
No parameters

Example Claude prompt

"Which countries does AI Screening Tools support and what are their country codes?"

Rate Limits Summary

Free tier (all tools)
3 calls / day per IP

Email reset token
+3 calls (resets daily)

Max calls per minute
10 / min (MCP endpoint)

Get reset token
aiscreeningtools.com/mcp-access

This page documents all 22 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, scan a social profile, search your document corpus, or look up job listings — without any custom code or API wrappers. Tools include screen_candidate, batch_screen, social_profile_scan, set_social_keywords, search_jobs, get_job, request_info, and 15 more covering the full hiring workflow. Free tier: 3 tool calls per day per IP. Get a reset token at aiscreeningtools.com/mcp-access for 3 more free daily calls. Used by deployment partners running AI workflow automation for BPO companies, HR departments, and staffing agencies across Southeast Asia.

← API Documentation REST API Reference →