# Gapup Candidate Screening & Ranking

> Gapup Candidate Screening & Ranking is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Screens and ranks a batch of candidates against a job description using weighted criteria including skills, experience, education, role progression, and culture fit

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/candidate_screening_ranking
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-candidate-screening-ranking-ff38043c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_emzqittBc8Jy5c0d9tv7k

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gapup-candidate-screening-ranking-ff38043c -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "candidate_screening_ranking",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-candidate-screening-ranking-ff38043c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)