MCP Tools Reference
MCP Tools Reference
Connected with an API key, the MCP server exposes 14 tools, one for each Career API endpoint it calls.
The hosted connector at mcp.laddro.com is a different surface with different tool names. See the bottom of this page.
Reference tools
These read public reference data and need no account.
| Tool | What it does | API endpoint |
|---|---|---|
laddro.templates.list | List every resume template, with its ATS score and layout type | GET /v1/templates |
laddro.templates.get | One template in full: colour schemes, fonts and preview images | GET /v1/templates/{templateId} |
laddro.fonts.list | The font families available for rendering | GET /v1/fonts |
laddro.languages.list | The document languages and locales that are supported | GET /v1/languages |
Resume tools
| Tool | What it does | API endpoint |
|---|---|---|
laddro.resumes.list | List the signed-in user's resumes, with pagination | GET /v1/resumes |
laddro.resumes.get | Metadata and content for one resume | GET /v1/resumes/{resumeId} |
laddro.resumes.render | Render a resume to PDF with a chosen template and styling | PUT /v1/resumes/{resumeId}/render |
laddro.resumes.tailor | Rewrite a resume for one job posting and return a PDF | POST /v1/tailor |
laddro.resumes.export | Export a resume as a downloadable PDF | POST /v1/export |
Cover letter tools
| Tool | What it does | API endpoint |
|---|---|---|
laddro.coverLetters.list | List the signed-in user's cover letters, with pagination | GET /v1/cover-letters |
laddro.coverLetters.get | Metadata and content for one cover letter | GET /v1/cover-letters/{coverLetterId} |
laddro.coverLetters.create | Save a cover letter you wrote yourself | POST /v1/cover-letters |
laddro.coverLetters.generate | Generate a cover letter from a resume and a job description | POST /v1/cover-letters/generate |
laddro.coverLetters.render | Render a saved cover letter to PDF | PUT /v1/cover-letters/{coverLetterId}/render |
Tool input
Each tool takes the parameters of the endpoint it calls. The three with the most options:
laddro.resumes.tailor
{
"positionName": "Senior Frontend Engineer",
"resumeId": "res_abc123",
"jobDescription": "We are looking for a Senior Engineer...",
"language": "en",
"includeCoverLetter": false
}positionName is the only required field. Pass either jobDescription or
jobUrl, and optionally mode, templateId, colorId and font.
laddro.resumes.render
{
"resumeId": "res_abc123",
"templateId": "graphite",
"locale": "en",
"fontSize": 10
}resumeId and templateId are required. locale, colorId, font,
spacing, margin, fontSize and pageNumbering are optional.
laddro.coverLetters.generate
{
"positionName": "Senior Frontend Engineer",
"resumeId": "res_abc123",
"jobDescription": "We are looking for a Senior Engineer..."
}positionName is the only required field.
Every tool returns JSON. The rendering and export tools return the PDF itself.
The hosted connector (OAuth)
Signing in at mcp.laddro.com with OAuth, rather than running the npm package with an API key, gives you a different set of 17 tools. They are named in the singular and they write through Laddro rather than straight to the Career API:
laddro.resume.schemaladdro.resume.listladdro.resume.getladdro.resume.createladdro.resume.updateladdro.resume.deleteladdro.resume.setDefaultladdro.resume.changeTemplateladdro.resume.exportPdfladdro.coverLetter.schemaladdro.coverLetter.listladdro.coverLetter.getladdro.coverLetter.createladdro.coverLetter.renderPdfladdro.templates.listladdro.fonts.listladdro.languages.list
A tool from one surface does not exist on the other: laddro.resumes.list is the API-key name, laddro.resume.list the connector one.