Skip to main content
Glama

@laddro/career-mcp

MCP server for the Laddro Career API. Gives AI agents access to resume tailoring, cover letter generation, PDF export, and template browsing.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "laddro-career": {
      "command": "npx",
      "args": ["@laddro/career-mcp"],
      "env": {
        "LADDRO_API_KEY": "laddro_live_..."
      }
    }
  }
}

Claude Code

claude mcp add laddro-career -- npx @laddro/career-mcp

Set the environment variable LADDRO_API_KEY before running.

Remote HTTP

Use the hosted Streamable HTTP endpoint:

https://mcp.laddro.com/mcp

Send your Laddro API key on the MCP initialize request:

Authorization: Bearer laddro_live_...

or:

x-api-key: laddro_live_...

Related MCP server: StoryLenses MCP Server

Available tools

Tool

Description

laddro.templates.list

Browse all 22 resume templates

laddro.templates.get

Get template colors and fonts

laddro.fonts.list

All available font families

laddro.languages.list

All 14 supported locales

laddro.resumes.list

User's resumes

laddro.resumes.get

Resume metadata

laddro.resumes.render

Re-render with new template settings

laddro.resumes.tailor

AI-tailor resume for a job

laddro.resumes.export

Export as PDF

laddro.coverLetters.list

User's cover letters

laddro.coverLetters.get

Cover letter metadata

laddro.coverLetters.create

Create manually

laddro.coverLetters.generate

AI-generate from resume + job

laddro.coverLetters.render

Render with template settings

Connector (OAuth) mode

Behind the MCP_CONNECTOR_ENABLED flag (default off). When enabled and a request carries Authorization: Bearer lad_at_* (a Laddro OAuth access token), the server runs an OAuth connector session that forwards the token to laddro-backend (service.laddro.com) instead of career-api. It also serves GET /.well-known/oauth-protected-resource (RFC 9728) and answers unauthenticated /mcp calls with 401 + WWW-Authenticate: Bearer resource_metadata=... so OAuth clients can discover the authorization server. With the flag off, behaviour is unchanged (no discovery route, no 401 enforcement, all 18 tools via career-api).

Connector tools (OAuth sessions only): "You write the content. Laddro stores it and renders the PDF."

Tool

Scope

Description

laddro.resume.schema

—

JSON Schema for resume content

laddro.resume.create

resumes:write

Create a resume, returns { resumeId }

laddro.resume.update

resumes:write

Full-replace a resume, returns { resumeId, updatedAt }

laddro.coverLetter.schema

—

JSON Schema for cover-letter content

Environment variables

Variable

Required

Description

LADDRO_API_KEY

Yes for stdio; optional fallback for HTTP

Your Laddro API key

LADDRO_BASE_URL

No

Override API URL (default: https://api.laddro.com)

MCP_CONNECTOR_ENABLED

No

true enables OAuth connector mode (default off)

LADDRO_BACKEND_URL

No

Backend base URL for connector tools (default: https://service.laddro.com)

MCP_PUBLIC_URL

No

This server's public URL for OAuth metadata (else derived from forwarded headers)

Development

npm ci
npm test

npm test builds the TypeScript package and runs MCP contract tests for auth handling, tool metadata, and handler routing.

Releases

This package uses Changesets and SemVer.

  • Patch: bug fixes, docs, tests, internal hardening.

  • Minor: new backwards-compatible MCP tools or capabilities.

  • Major: breaking tool names, schemas, auth, or transport behavior.

Every PR that changes the published package should include a changeset:

npm run changeset

After the PR merges to main, GitHub Actions opens a release PR with the version bump and changelog. Merging that release PR publishes the package to npm and creates the GitHub release. The Cloud Run deploy workflow also runs on main, so hosted MCP updates automatically after release merges.

MCP registry

This server is listed in the official MCP registry as com.laddro/career. server.json is the registry manifest; scripts/sync-version-metadata.mjs keeps its version in sync with the npm package on every release.

Publishing is automated: .github/workflows/publish-registry.yml runs whenever a release changes server.json on main and pushes the new version to the registry. Auth is DNS-based — the Ed25519 public key lives in the laddro.com TXT record, and the matching private key (hex) is stored as the MCP_PUBLISHER_ED25519_KEY repo secret.

To publish (or catch up) manually:

MCP_PUBLISHER_ED25519_KEY=<hex-private-key> ./scripts/publish-registry.sh

License

MIT

Available Tools

18 tools
laddro.coverLetters.createAInspect

Create a new cover letter manually with provided contact details and letter content

Inputs: fullName (required), letterContent (required), email, phone, +5 more. Returns: id, title, createdAt, updatedAt

laddro.coverLetters.generateAInspect

AI-generate a personalized cover letter based on a resume and job description. Returns a PDF.

Inputs: positionName (required), font, jobUrl, colorId, +4 more. Returns: content, mimeType

laddro.coverLetters.getA
Read-only
Inspect

Get metadata and content for a specific cover letter by its ID

Inputs: coverLetterId (required). Returns: id, title, createdAt, updatedAt

laddro.coverLetters.listA
Read-only
Inspect

List the authenticated user's cover letters with pagination support

Inputs: limit, offset. Returns: total, coverLetters

laddro.coverLetters.renderA
Read-only
Inspect

Render a saved cover letter as PDF with template and styling settings. Costs 1 API credit.

Inputs: templateId (required), coverLetterId (required), font, locale, +5 more. Returns: content, mimeType

laddro.fonts.listA
Read-only
Inspect

List all available font families for resume and cover letter rendering

Inputs: no named parameters. Returns: fonts

laddro.languages.listA
Read-only
Inspect

List all 14 supported languages and locales for resume content

Inputs: no named parameters. Returns: languages

laddro.models.listA
Read-only
Inspect

List all supported AI providers and models for Bring Your Own Key (BYOK)

Inputs: no named parameters. Returns: providers

laddro.resumes.exportA
Read-only
Inspect

Export a resume as a downloadable PDF file with optional template and styling settings. Costs 1 API credit.

Inputs: resumeId (required), font, locale, margin, +5 more. Returns: content, mimeType

laddro.resumes.getA
Read-only
Inspect

Get metadata and content for a specific resume by its ID

Inputs: resumeId (required). Returns: id, title, createdAt, updatedAt

laddro.resumes.listA
Read-only
Inspect

List the authenticated user's resumes with pagination support

Inputs: limit, offset. Returns: total, resumes

laddro.resumes.renderA
Read-only
Inspect

Render a resume as PDF with specific template and styling settings. Costs 1 API credit.

Inputs: resumeId (required), templateId (required), font, locale, +5 more. Returns: content, mimeType

laddro.resumes.tailorAInspect

AI-tailor a resume for a specific job posting. Rewrites content to match the job description and returns a PDF. Provide either jobDescription or jobUrl.

Inputs: positionName (required), font, mode, jobUrl, +6 more. Returns: content, mimeType

laddro.settings.deleteModelA
Destructive
Inspect

Remove the saved AI provider configuration, reverting to Laddro's default AI model

Inputs: no named parameters. Returns: message

laddro.settings.getA
Read-only
Inspect

Get the current AI provider and model configuration for the authenticated user

Inputs: no named parameters. Returns: model, hasKey, provider

laddro.settings.updateModelAInspect

Configure the AI provider and model for BYOK (Bring Your Own Key). Saves an encrypted API key for the chosen provider.

Inputs: apiKey (required), provider (required), model. Returns: message

laddro.templates.getA
Read-only
Inspect

Get full details for a template including color schemes, fonts, and preview images

Inputs: templateId (required). Returns: id, name, layout, atsScore

laddro.templates.listA
Read-only
Inspect

List all available resume templates with ATS scores and layout types

Inputs: no named parameters. Returns: templates

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 18 tools

    Disambiguation5/5

    Each tool has a distinct purpose, clearly separated by resource type (coverLetters, resumes, settings, etc.) and action (create, list, generate, etc.). No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent pattern: laddro.<resource>.<action> in snake_case. The naming is uniform and predictable, aiding tool selection.

    Tool Count5/5

    18 tools cover the core functionality of a career MCP server (resumes, cover letters, templates, settings). The number is well-balanced—not too few to be incomplete, not too many to be overwhelming.

    Completeness3/5

    The tool surface covers creation, reading, listing, generation, rendering, and exporting for resumes and cover letters, but lacks update and delete operations. These are notable gaps for typical CRUD workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables users to search for jobs, prefill applications using AI, and automate submissions across major platforms like Lever and Ashby directly from Claude or Cursor. It provides a full suite of tools for managing job queues, profile data, and resumes within a chat interface.
      37
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      AI cover letter generation for agents. 5 composable tools that analyze job postings (15+ structured fields), match candidate profiles against roles, generate story-driven cover letters using narrative archetypes, and quality-score the results. Supports English, German, Spanish, and Portuguese. The first production MCP server for job applications.
      59 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Free MCP and skills for remote and overseas job search across Himalayas, Jobicy, Arbeitnow and company ATS boards, with source links and eligibility checks. Optional local drafts, authorized email sending and reply tracking. Hosted MCP: https://mcp.worldrole.work/mcp — free anonymous access to 20 distinct jobs per network per UTC day, or 50 per free account; other request limits apply.
      9
      14
      MIT