{"uid":"cap_emzqittBc8Jy5c0d9tv7k","slug":"gapup-candidate-screening-ranking-ff38043c","name":"Gapup Candidate Screening & Ranking","description":"REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.","url":"https://mcp.gapup.io/api/v1/call/candidate_screening_ranking","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"async":{"type":"boolean","description":"If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."},"candidates":{"type":"array","items":{"type":"object","required":["id","resume_text"],"properties":{"id":{"type":"string","description":"Unique identifier for this candidate."},"name":{"type":"string","description":"Optional full name (used for diversity signals)."},"resume_text":{"type":"string","minLength":10,"description":"Raw resume or CV text."},"linkedin_url":{"type":"string","description":"Optional LinkedIn URL (informational, not fetched)."},"years_experience":{"type":"number","minimum":0,"description":"Optional self-reported years of total experience."}}},"maxItems":50,"minItems":1,"description":"Array of candidate objects. Maximum 50."},"role_country":{"type":"string","description":"Optional ISO 2-letter country code for regional context (informational)."},"job_description":{"type":"string","minLength":20,"description":"Full text or summary of the job description and role requirements."},"criteria_weights":{"type":"object","properties":{"culture_fit":{"type":"number","maximum":1,"minimum":0},"skills_match":{"type":"number","maximum":1,"minimum":0},"education_match":{"type":"number","maximum":1,"minimum":0},"experience_match":{"type":"number","maximum":1,"minimum":0},"role_progression":{"type":"number","maximum":1,"minimum":0}},"description":"Optional weighting per criterion. Default: skills=0.4, experience=0.2, education=0.1, progression=0.15, culture=0.15."}}},"responseSchema":{"type":"json","example":{"tool":"candidate_screening_ranking","result":{},"source":"rest-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZBQqQ_RrOWcnfogBU5fBX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens and ranks a batch of candidates against a job description using weighted criteria including skills, experience, education, role progression, and culture fit","exampleAgentPrompt":"I have 5 candidates applying for a Senior Backend Engineer role — can you screen and rank them based on their resumes against this job description, weighting skills at 50% and experience at 30%, with culture fit and progression splitting the rest?","exampleUseCases":null,"resultDescription":"Returns a ranked list of candidates with scores per criterion (skills match, experience match, education match, role progression, culture fit) and an overall composite score based on the provided or default weights, enabling the hiring team to prioritize interviews.","failureModes":["Fewer than 1 or more than 50 candidates provided — returns validation error","Job description shorter than 20 characters — returns schema validation error","Resume text shorter than 10 characters — returns per-candidate validation error","Criteria weights do not sum correctly or contain values outside 0-1 — may return error or be ignored","Async mode not used for large batches, causing client timeout on slow processing","Invalid Bearer token — returns 401 Unauthorized","Payment not processed (x402 protocol) — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to evaluate and rank multiple candidates (up to 50) against a structured job description with customizable weighting across key hiring criteria. Prefer over manual review pipelines when you need consistent, explainable scoring across skills, experience, education, progression, and culture fit. Use async mode for large batches to avoid timeouts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:17.829Z","isFirstParty":false}