@jsonresume/mcp

Validates incoming resume data against the JSON Resume schema specification and transforms unstructured or partially-structured resume input into compliant JSON Resume format. Implements schema-based validation using JSON Schema validators, enabling detection of missing required fields, type mismatches, and structural violations before downstream processing. Provides structured error reporting with field-level granularity to guide users toward schema compliance.

Extracts and normalizes individual resume fields (names, dates, locations, job titles, skills) from structured resume objects, applying consistent formatting rules and data type coercion. Uses field-level parsers for domain-specific normalization: date parsing (handles multiple formats), location standardization (city/country normalization), skill deduplication and categorization. Exposes extracted fields as structured outputs suitable for downstream processing, search indexing, or display.

Generates or enhances resume content (job descriptions, skill summaries, professional statements) using Claude's language capabilities, exposed through MCP tools. Accepts partial or template resume sections and produces polished, ATS-friendly text that maintains consistency with JSON Resume formatting. Implements prompt templates for different resume sections (summary, experience, skills) and applies style guidelines (tone, length, keyword optimization) to generated content.

Converts validated JSON Resume objects into multiple output formats (PDF, HTML, Markdown, DOCX) using template-based rendering. Implements format-specific exporters that apply styling, layout rules, and field mappings appropriate to each output type. Supports custom templates for branded resume designs and integrates with external rendering engines (e.g., Puppeteer for PDF generation) through abstracted interfaces.

Extracts and computes metadata from resume objects: experience duration, skill frequency, education timeline, employment gaps, and career progression metrics. Implements analytical functions that traverse resume structure to compute derived metrics (total years of experience, skill proficiency levels inferred from frequency, career trajectory analysis). Exposes these metrics as structured data for analytics dashboards, job matching algorithms, or resume quality scoring.

Compares two resume objects or a resume against a job description to identify skill gaps, experience mismatches, and improvement opportunities. Implements comparison algorithms that align resume sections with job requirements, compute similarity scores for skills and experience, and generate gap reports highlighting missing qualifications. Uses semantic matching (keyword-based or embedding-based if available) to identify related but differently-named skills.

Manages multiple resume versions and variants (e.g., tailored for different industries, experience levels, or roles) within a single JSON Resume source. Implements version control logic that tracks changes, maintains variant metadata, and enables switching between versions. Supports conditional field inclusion based on variant parameters, allowing a single resume source to generate multiple tailored outputs without duplication.

Validates resume content for accessibility standards (WCAG compliance for HTML exports, semantic structure for screen readers) and compliance requirements (GDPR data minimization, no discriminatory language). Implements checks for readability metrics, language clarity, and potential bias in phrasing. Provides actionable recommendations for improving accessibility and compliance without compromising resume quality.