CareerGenius
Fact-checked resume tailoring, cover letters, interview prep and keyword gaps for a job posting.
Should I use this
Quality & Safety
A
Findings (3)
- HIGHTool poisoning patterns detected
- LOWTool 'careergenius_render_resume_docx' name length outside 3-30 rangein careergenius_render_resume_docx
- LOWTool description contains role marker that could confuse chat modelsin careergenius_render_resume_pdf
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~5,746Tokens (tool definitions)
~8.4 KBTypical response size
Significant attention impact (4.49% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"careergenius": {
"url": "https://api.careergenius.org/mcp"
}
}
}Remote endpoints
https://api.careergenius.org/mcpstreamable-httpWhat it can do
Tool inventory
Tools (7)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢careergenius_keyword_gap(on_behalf_of, resume, resume_text, posting_text, job_url, ...)
Lists the keywords a job posting asks for (named tools, products, credentials, plus any you supply) and which of them the resume shows or does not show. Deterministic, no AI. Not a score and not a prediction of screening or interview outcomes. Without a key: one of the conversation's 10 free keyword/PDF calls. job_url needs a key.
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"description": "Structured resume. Only what the person really has done: every output is checked against it.",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 120
},
"summary": {
"type": "string",
"maxLength": 3000
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"employer": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
}
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"degree": {
"type": "string"
},
"field": {
"type": "string"
},
"school": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"sections": {
"type": "array",
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"resume_text": {
"type": "string",
"maxLength": 30000
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"keywords": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 60
}
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
},
"required": [
"on_behalf_of"
]
}🟢careergenius_tailor_resume(on_behalf_of, resume, posting_text, job_url, idempotency_key)
Rewords the resume summary and job bullets for one posting. Every rewrite is checked against the resume; rewrites with unsupported claims (added tools, numbers, seniority, results or employers) are removed and listed in held_back by reason code. Every result has "outcome": which lines were reworded, kept or held back, reason codes (such as NO_CHANGES, AI_KEPT_WORDING, ALL_HELD_BACK, MISSING_KEYWORDS_NOT_ADDABLE), the posting keywords the resume does not show (rewording cannot add them), a plain explanation and next steps. Review before use. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key).
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"description": "Structured resume. Only what the person really has done: every output is checked against it.",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 120
},
"summary": {
"type": "string",
"maxLength": 3000
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"employer": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
}
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"degree": {
"type": "string"
},
"field": {
"type": "string"
},
"school": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"sections": {
"type": "array",
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
},
"required": [
"on_behalf_of",
"resume"
]
}🟢careergenius_cover_letter(on_behalf_of, resume, resume_text, posting_text, job_url, ...)
Writes a cover letter (or a short hiring-manager letter) from the resume for one posting. Every sentence is checked against the resume; unsupported sentences are removed and counted by reason. Returns only a letter, never other text. Review before use. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key).
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"description": "Structured resume. Only what the person really has done: every output is checked against it.",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 120
},
"summary": {
"type": "string",
"maxLength": 3000
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"employer": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
}
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"degree": {
"type": "string"
},
"field": {
"type": "string"
},
"school": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"sections": {
"type": "array",
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"resume_text": {
"type": "string",
"maxLength": 30000
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"kind": {
"enum": [
"cover-letter",
"hiring-manager-letter"
]
},
"applicant_name": {
"type": "string",
"maxLength": 120
},
"job_title": {
"type": "string",
"maxLength": 120
},
"company_name": {
"type": "string",
"maxLength": 120
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
},
"required": [
"on_behalf_of"
]
}🟢careergenius_render_resume_pdf(on_behalf_of, resume, template, page_size)
Lays out a structured resume as a clean, single-column, ATS-readable PDF (real selectable text, embedded fonts, no images, no tables, no clickable links), letter or A4, at most 3 pages. Returns the file as an embedded resource (base64); nothing is stored. No AI: the text is printed exactly as sent. Counts one call of the monthly allowance. Without a key: one of the conversation's 10 free keyword/PDF calls.
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"additionalProperties": false,
"properties": {
"contact": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 160
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"location": {
"type": "string",
"maxLength": 120
}
},
"required": [
"name"
]
},
"links": {
"type": "array",
"maxItems": 5,
"description": "http(s) only; printed as text, never as clickable links.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"maxLength": 40
},
"url": {
"type": "string",
"maxLength": 300
}
},
"required": [
"url"
]
}
},
"summary": {
"type": "string",
"maxLength": 3000,
"description": "Line breaks start new paragraphs."
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"maxLength": 160
},
"employer": {
"type": "string",
"maxLength": 160
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
},
"end_date": {
"type": "string",
"maxLength": 25
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
},
"required": [
"title"
]
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"school": {
"type": "string",
"maxLength": 160
},
"degree": {
"type": "string",
"maxLength": 160
},
"field": {
"type": "string",
"maxLength": 160
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
},
"end_date": {
"type": "string",
"maxLength": 25
},
"details": {
"type": "array",
"maxItems": 6,
"items": {
"type": "string",
"maxLength": 300
}
}
},
"required": [
"school"
]
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"certifications": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"issuer": {
"type": "string",
"maxLength": 160
},
"date": {
"type": "string",
"maxLength": 25
}
},
"required": [
"name"
]
}
},
"sections": {
"type": "array",
"maxItems": 6,
"description": "Other sections (projects, volunteering, awards ...), printed as titled bullet lists.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"items": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
},
"required": [
"title"
]
}
}
},
"required": [
"contact"
],
"description": "The resume content, exactly as it should appear. Nothing is added, reworded or checked: this tool only lays it out. At most 45,000 characters of JSON."
},
"template": {
"enum": [
"classic",
"modern"
],
"description": "classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic."
},
"page_size": {
"enum": [
"letter",
"a4"
],
"description": "Default letter."
}
},
"required": [
"on_behalf_of",
"resume"
],
"additionalProperties": false
}🟢careergenius_render_resume_docx(on_behalf_of, resume, template, page_size)
The same resume layout as an editable Word (.docx) file, for a person who wants to change it before sending. Returns the file as an embedded resource (base64); nothing is stored. No AI. Counts one call of the monthly allowance. Without a key: one of the conversation's 10 free keyword/PDF calls.
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"additionalProperties": false,
"properties": {
"contact": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 160
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"location": {
"type": "string",
"maxLength": 120
}
},
"required": [
"name"
]
},
"links": {
"type": "array",
"maxItems": 5,
"description": "http(s) only; printed as text, never as clickable links.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"maxLength": 40
},
"url": {
"type": "string",
"maxLength": 300
}
},
"required": [
"url"
]
}
},
"summary": {
"type": "string",
"maxLength": 3000,
"description": "Line breaks start new paragraphs."
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"maxLength": 160
},
"employer": {
"type": "string",
"maxLength": 160
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
},
"end_date": {
"type": "string",
"maxLength": 25
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
},
"required": [
"title"
]
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"school": {
"type": "string",
"maxLength": 160
},
"degree": {
"type": "string",
"maxLength": 160
},
"field": {
"type": "string",
"maxLength": 160
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
},
"end_date": {
"type": "string",
"maxLength": 25
},
"details": {
"type": "array",
"maxItems": 6,
"items": {
"type": "string",
"maxLength": 300
}
}
},
"required": [
"school"
]
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"certifications": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"issuer": {
"type": "string",
"maxLength": 160
},
"date": {
"type": "string",
"maxLength": 25
}
},
"required": [
"name"
]
}
},
"sections": {
"type": "array",
"maxItems": 6,
"description": "Other sections (projects, volunteering, awards ...), printed as titled bullet lists.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"items": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
},
"required": [
"title"
]
}
}
},
"required": [
"contact"
],
"description": "The resume content, exactly as it should appear. Nothing is added, reworded or checked: this tool only lays it out. At most 45,000 characters of JSON."
},
"template": {
"enum": [
"classic",
"modern"
],
"description": "classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic."
},
"page_size": {
"enum": [
"letter",
"a4"
],
"description": "Default letter."
}
},
"required": [
"on_behalf_of",
"resume"
],
"additionalProperties": false
}🟢careergenius_tailor_resume_pdf(on_behalf_of, resume, resume_text, resume_file, contact, ...)
One call: give a job posting (text or a public link) and the person's resume (plain text, a PDF or DOCX file in base64, or structured JSON). CareerGenius reads the posting, lists the keywords it asks for and which the resume shows, rewords the summary and bullets for this job, keeps ONLY the rewordings that pass its fact check (no added tools, numbers, titles, results or employers), and returns a clean single-column ATS-readable PDF plus a summary of what changed, what was held back and why. "outcome" explains the result in reason codes and plain words, also when nothing changed: lines reworded / kept / held back, posting keywords the resume does not show, and next steps. Counts one call and uses the AI cap. Review before sending. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key). Without a key the whole request is limited to 96 KB.
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"description": "Structured resume. Only what the person really has done: every output is checked against it.",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 120
},
"summary": {
"type": "string",
"maxLength": 3000
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"employer": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
}
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"degree": {
"type": "string"
},
"field": {
"type": "string"
},
"school": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"sections": {
"type": "array",
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"resume_text": {
"type": "string",
"maxLength": 30000,
"description": "A pasted plain-text resume. Read by a fixed layout parser (no AI, nothing added); section headings (Summary, Experience, Education, Skills) help."
},
"resume_file": {
"type": "object",
"additionalProperties": false,
"properties": {
"format": {
"enum": [
"pdf",
"docx"
]
},
"content_base64": {
"type": "string",
"description": "The file, base64 (at most 1.5 MB decoded with a key; without a key the whole request is limited to 96 KB). PDFs need a text layer (not a scan)."
},
"filename": {
"type": "string",
"maxLength": 200
}
},
"required": [
"format",
"content_base64"
]
},
"contact": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"location": {
"type": "string",
"maxLength": 120
}
}
},
"links": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"maxLength": 40
},
"url": {
"type": "string",
"maxLength": 300
}
},
"required": [
"url"
]
}
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"template": {
"enum": [
"classic",
"modern"
],
"description": "classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic."
},
"page_size": {
"enum": [
"letter",
"a4"
],
"description": "Default letter."
}
},
"required": [
"on_behalf_of"
],
"additionalProperties": false
}🟢careergenius_interview_prep(on_behalf_of, resume, resume_text, resume_file, contact, ...)
Likely interview questions for one job posting, each with an answer outline built ONLY from the resume: every point cites the resume line it comes from and passed the CareerGenius fact check (no invented experience; failing points are removed and listed by reason). Resume as plain text, a PDF/DOCX file (base64) or structured JSON. Counts one call and uses the AI cap. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key). Without a key the whole request is limited to 96 KB.
Input Schema
{
"type": "object",
"properties": {
"on_behalf_of": {
"type": "object",
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).",
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"required": [
"human_requested",
"resume_is_theirs"
]
},
"resume": {
"type": "object",
"description": "Structured resume. Only what the person really has done: every output is checked against it.",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"headline": {
"type": "string",
"maxLength": 120
},
"summary": {
"type": "string",
"maxLength": 3000
},
"experience": {
"type": "array",
"maxItems": 15,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"employer": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"current": {
"type": "boolean"
},
"bullets": {
"type": "array",
"maxItems": 15,
"items": {
"type": "string",
"maxLength": 600
}
}
}
}
},
"education": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"degree": {
"type": "string"
},
"field": {
"type": "string"
},
"school": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"skills": {
"type": "array",
"maxItems": 80,
"items": {
"type": "string",
"maxLength": 80
}
},
"sections": {
"type": "array",
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"resume_text": {
"type": "string",
"maxLength": 30000,
"description": "A pasted plain-text resume. Read by a fixed layout parser (no AI, nothing added); section headings (Summary, Experience, Education, Skills) help."
},
"resume_file": {
"type": "object",
"additionalProperties": false,
"properties": {
"format": {
"enum": [
"pdf",
"docx"
]
},
"content_base64": {
"type": "string",
"description": "The file, base64 (at most 1.5 MB decoded with a key; without a key the whole request is limited to 96 KB). PDFs need a text layer (not a scan)."
},
"filename": {
"type": "string",
"maxLength": 200
}
},
"required": [
"format",
"content_base64"
]
},
"contact": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"location": {
"type": "string",
"maxLength": 120
}
}
},
"links": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"maxLength": 40
},
"url": {
"type": "string",
"maxLength": 300
}
},
"required": [
"url"
]
}
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
},
"required": [
"on_behalf_of"
],
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded7 tools