Civify

Tailor Resume to Job Description

civify_tailor_cv

Tailor a CV to a job and return tailoredCv, ATS feedback, and a finished PDF by default. Prefer resume_data if you already extracted the CV; otherwise send one original document/text input. May consume AI credits. Do not call parse first or automatically repeat tailoring. PDF failure preserves tailoredCv for export-only retry.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`file`	No	A user-selected chat attachment supplied by the client. Never invent a download URL or file ID.
`color`	No	PDF accent color in six-digit hex.	#000000
`file_url`	No	Actual HTTPS download URL supplied by the client or user. Never use a sandbox path, file ID alone or an invented URL.
`filename`	No	Original filename for base64 data, including extension (PDF, DOCX, PNG or JPG). Inferred from bytes when omitted.
`language`	No	Language code (e.g., 'en', 'ar').
`template`	No	PDF layout.	modern
`job_title`	No	Target job title.
`resume_id`	No	Existing Civify resume ID, if known, to apply its export entitlement. Never invent an ID. Account policy applies when omitted.
`export_pdf`	No	Return the finished PDF with tailoring (default true). Set false for analysis only. If export fails, retry civify_generate_pdf with the returned tailoredCv; never repeat tailoring just to obtain a PDF.
`file_base64`	No	Base64 encoded resume file content (PDF, DOCX). Recommended for remote/cloud MCP servers.
`resume_data`	No	Civify ResumeData extracted by you or returned by Civify. Preserve all real details; never invent achievements. Use personalInfo for contact/summary and sections[].items for experience, education and skills. No parse call is required when you have this data.
`resume_text`	No	Complete resume text read from the attachment. Preferred fallback when the client cannot forward bytes. Do not summarize or invent missing content.
`company_name`	No	Target company name.
`include_roadmap`	No	Whether to generate a preparation roadmap.
`job_description`	Yes	Complete target job description.
`generate_cover_letter`	No	Whether to generate a matching tailored cover letter.
`include_interview_questions`	No	Whether to generate matching interview prep questions.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 25, 2026

removedInput schema / properties / api_key

Removed value: -{
-  "description": "Optional API key override.",
-  "type": "string"
-}

Changed11 schema fields changedSep 24, 2026

changedInput schema / anyOf

Previous value: -[
-  {
-    "required": [
-      "resume_text"
-    ]
-  },
-  {
-    "required": [
-      "file_base64"
-    ]
-  },
-  {
-    "required": [
-      "file"
-    ]
-  },
-  {
-    "required": [
-      "file_url"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "resume_text"
+    ]
+  },
+  {
+    "required": [
+      "file_base64"
+    ]
+  },
+  {
+    "required": [
+      "resume_data"
+    ]
+  },
+  {
+    "required": [
+      "file"
+    ]
+  },
+  {
+    "required": [
+      "file_url"
+    ]
+  }
+]

addedInput schema / properties / color

Added value: +{
+  "default": "#000000",
+  "description": "PDF accent color in six-digit hex.",
+  "pattern": "^#[0-9a-fA-F]{6}$",
+  "type": "string"
+}

addedInput schema / properties / export_pdf

Added value: +{
+  "default": true,
+  "description": "Return the finished PDF with tailoring (default true). Set false for analysis only. If export fails, retry civify_generate_pdf with the returned tailoredCv; never repeat tailoring just to obtain a PDF.",
+  "type": "boolean"
+}

changedInput schema / properties / job_description / description

Previous value: -"The full text of the job description to tailor against."New value: +"Complete target job description."

addedInput schema / properties / job_description / minLength
```
Added value: +1
```
addedInput schema / properties / job_description / pattern
```
Added value: +"\\S"
```

addedInput schema / properties / resume_data

Added value: +{
+  "description": "Civify ResumeData extracted by you or returned by Civify. Preserve all real details; never invent achievements. Use personalInfo for contact/summary and sections[].items for experience, education and skills. No parse call is required when you have this data.",
+  "properties": {
+    "metadata": {
+      "description": "Optional renderer settings, such as templateId and primaryColor.",
+      "type": "object"
+    },
+    "personalInfo": {
+      "properties": {
+        "address": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "city": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "country": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "email": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "fullName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "github": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "jobTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "linkedin": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "phone": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "summary": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "website": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "sections": {
+      "items": {
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "items": {
+            "items": {
+              "properties": {
+                "date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "location": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "subtitle": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "tags": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "title": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "visible": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "order": {
+            "type": "integer"
+          },
+          "title": {
+            "type": "string"
+          },
+          "type": {
+            "description": "experience, education, skills, or custom",
+            "type": "string"
+          },
+          "visible": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "type",
+          "items"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "personalInfo",
+    "sections"
+  ],
+  "type": "object"
+}

addedInput schema / properties / resume_id

Added value: +{
+  "description": "Existing Civify resume ID, if known, to apply its export entitlement. Never invent an ID. Account policy applies when omitted.",
+  "maxLength": 128,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / template

Added value: +{
+  "default": "modern",
+  "description": "PDF layout.",
+  "enum": [
+    "modern",
+    "classic",
+    "creative",
+    "executive",
+    "minimal",
+    "ats"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / data / properties

Added value: +{
+  "document": {
+    "properties": {
+      "download_url": {
+        "description": "Return this clickable PDF URL promptly.",
+        "type": "string"
+      },
+      "expires_at": {
+        "type": "string"
+      },
+      "path": {
+        "type": "string"
+      },
+      "pdf_base64": {
+        "type": "string"
+      },
+      "retry_tool": {
+        "type": "string"
+      },
+      "status": {
+        "enum": [
+          "SUCCESS",
+          "EXPORT_FAILED",
+          "NOT_REQUESTED"
+        ],
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "error": {
+    "type": "object"
+  },
+  "request_id": {
+    "description": "Correlation ID for support; not an idempotency key.",
+    "type": "string"
+  },
+  "tailoredCv": {
+    "description": "Completed canonical resume data. Preserve for editing and export retries.",
+    "type": "object"
+  }
+}

addedOutput schema / properties / data / type
```
Added value: +"object"
```

Changed20 schema fields changedSep 24, 2026

changedInput schema / anyOf

Previous value: -[
-  {
-    "required": [
-      "resume_text"
-    ]
-  },
-  {
-    "required": [
-      "file_base64"
-    ]
-  },
-  {
-    "required": [
-      "server_file_path"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "resume_text"
+    ]
+  },
+  {
+    "required": [
+      "file_base64"
+    ]
+  },
+  {
+    "required": [
+      "file"
+    ]
+  },
+  {
+    "required": [
+      "file_url"
+    ]
+  }
+]

addedInput schema / properties / file

Added value: +{
+  "additionalProperties": false,
+  "description": "A user-selected chat attachment supplied by the client. Never invent a download URL or file ID.",
+  "properties": {
+    "download_url": {
+      "type": "string"
+    },
+    "file_id": {
+      "type": "string"
+    },
+    "file_name": {
+      "type": "string"
+    },
+    "mime_type": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "download_url",
+    "file_id"
+  ],
+  "type": "object"
+}

addedInput schema / properties / file_url

Added value: +{
+  "description": "Actual HTTPS download URL supplied by the client or user. Never use a sandbox path, file ID alone or an invented URL.",
+  "type": "string"
+}

removedInput schema / properties / filename / default
```
Removed value: -"resume.pdf"
```

changedInput schema / properties / filename / description

Previous value: -"Filename when providing base64 content (e.g. 'resume.pdf')."New value: +"Original filename for base64 data, including extension (PDF, DOCX, PNG or JPG). Inferred from bytes when omitted."

changedInput schema / properties / resume_text / description

Previous value: -"Plain text or markdown content of the candidate's resume. Easiest option when chatting with an AI agent."New value: +"Complete resume text read from the attachment. Preferred fallback when the client cannot forward bytes. Do not summarize or invent missing content."

addedInput schema / properties / resume_text / minLength
```
Added value: +1
```

removedInput schema / properties / server_file_path

Removed value: -{
-  "description": "Local file path on the MCP server machine. For local CLI/stdio usage only. In ChatGPT or Claude, pass 'resume_text' or 'file_base64' instead.",
-  "type": "string"
-}

removedOutput schema / properties / atsScore

Removed value: -{
-  "description": "Audit score for tailored version",
-  "properties": {
-    "keywordMatch": {
-      "description": "Keyword match score 0-100",
-      "type": "number"
-    },
-    "missingKeywords": {
-      "description": "Keywords still missing",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "overall": {
-      "description": "Overall score 0-100",
-      "type": "number"
-    },
-    "skillsMatch": {
-      "description": "Skills match score 0-100",
-      "type": "number"
-    }
-  },
-  "type": "object"
-}

removedOutput schema / properties / changes

Removed value: -{
-  "description": "Summary list of bullet points and sections tailored",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / properties / coverLetter

Removed value: -{
-  "description": "Matching personalized cover letter text if requested",
-  "type": "string"
-}

addedOutput schema / properties / data
```
Added value: +{}
```

removedOutput schema / properties / interviewPrep

Removed value: -{
-  "description": "Targeted interview preparation questions and talking points",
-  "type": "object"
-}

removedOutput schema / properties / originalAtsScore

Removed value: -{
-  "description": "Original ATS score before tailoring for comparison",
-  "type": "object"
-}

removedOutput schema / properties / roadmap

Removed value: -{
-  "description": "Targeted skill acquisition roadmap",
-  "type": "object"
-}

removedOutput schema / properties / status

Removed value: -{
-  "description": "Execution status",
-  "type": "string"
-}

removedOutput schema / properties / tailoredCv

Removed value: -{
-  "description": "Optimized resume document structure",
-  "type": "object"
-}

removedOutput schema / properties / tailoredResume

Removed value: -{
-  "description": "Optimized resume document structure",
-  "type": "object"
-}

removedOutput schema / properties / validationWarnings

Removed value: -{
-  "description": "Validation warnings or alignment notes",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

addedOutput schema / required
```
Added value: +[
+  "data"
+]
```

Changed3 schema fields changedSep 15, 2026

changedInput schema / anyOf

Previous value: -[
-  {
-    "required": [
-      "resume_text"
-    ]
-  },
-  {
-    "required": [
-      "file_base64"
-    ]
-  },
-  {
-    "required": [
-      "file_path"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "resume_text"
+    ]
+  },
+  {
+    "required": [
+      "file_base64"
+    ]
+  },
+  {
+    "required": [
+      "server_file_path"
+    ]
+  }
+]

removedInput schema / properties / file_path

Removed value: -{
-  "description": "Local file path on the MCP server machine. Do NOT use for remote cloud servers; use 'resume_text' or 'file_base64' instead.",
-  "type": "string"
-}

addedInput schema / properties / server_file_path

Added value: +{
+  "description": "Local file path on the MCP server machine. For local CLI/stdio usage only. In ChatGPT or Claude, pass 'resume_text' or 'file_base64' instead.",
+  "type": "string"
+}

First observedSep 15, 2026

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, the description discloses that the operation may consume AI credits and warns against repeating tailoring, which implies a costly or side-effecting operation. It also reveals the failure behavior: if PDF generation fails, tailoredCv is preserved for export-only retry. No contradiction with annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loaded: it leads with the core purpose and outputs, then offers actionable usage rules. Every sentence adds critical guidance without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex 17-parameter tool with nested objects and an output schema, the description covers the essential workflow, cost implications, retry behavior, and relationship to parsing. The schema property descriptions further fill in parameter-level details, so nothing critical is missing for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds value by specifying a preference order among the input alternatives (resume_data first, then original document/text), which the anyOf schema alone does not convey. It also clarifies that repeated tailoring is not the remedy for PDF issues, reinforcing the export_pdf parameter semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific action ('Tailor a CV to a job') and names the concrete deliverables: tailoredCv, ATS feedback, and a finished PDF by default. This distinguishes it from siblings like civify_parse_cv, civify_generate_pdf, and civify_score_ats by clarifying that this tool combines tailoring with ATS feedback and PDF output.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit selection guidance: prefer resume_data if already extracted, otherwise send one original document or text input. It also gives clear exclusions and fallbacks: 'Do not call parse first', 'Do not automatically repeat tailoring', and retry PDF export via generate_pdf on failure. These instructions directly help an agent decide when and how to use this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Civify tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?