benediktgirz avatar

Storylenses

benediktgirz/storylenses-mcp-server

Connects Claude to the StoryLenses API for programmatic cover letter generation. Exposes five tools: analyze job postings to extract structured fields like requirements and culture signals, match candidate CVs against those fields, generate narrative-driven letters using selectable archetypes, run quality checks with scoring, and list available writing styles. The workflow is sequential: parse a job URL, feed the analysis plus a resume into the matcher, then generate a letter based on the match data and chosen narrative tone. Requires an API key from storylenses.app with tiered limits starting at 10 free generations monthly. Useful if you're building job application automation or want structured job data extraction beyond basic scraping.

tools
5
auth
Secret needed
transport
STDIO, HTTP
last updated
Apr 7, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

storylenses_analyze_jobExtract 15+ structured fields from a job posting — role requirements, company challenges, culture signals, recruiter priorities3 params

Extract 15+ structured fields from a job posting — role requirements, company challenges, culture signals, recruiter priorities

Parameters* required
job_textstring
Raw text of the job posting (use if no URL)
job_urlstring
URL of the job posting to analyze
localestring
Response language (en, de, es, or pt)one of en · de · es · ptdefault: en
storylenses_match_profileMatch a candidate profile/CV against job data — identifies fit score, matching skills, career gaps, and strongest narrative angle3 params

Match a candidate profile/CV against job data — identifies fit score, matching skills, career gaps, and strongest narrative angle

Parameters* required
candidate_cvstring
Candidate's CV or resume as plain text
job_analysisobject
Job analysis output from storylenses_analyze_job
localestring
Response language (en, de, es, or pt)one of en · de · es · ptdefault: en
storylenses_generate_letterGenerate a story-driven cover letter using matched data and a narrative archetype. Supports en/de/es/pt.7 params

Generate a story-driven cover letter using matched data and a narrative archetype. Supports en/de/es/pt.

Parameters* required
archetypestring
Narrative archetype ID (use storylenses_list_archetypes to see options)default: golden-fleece
candidate_namestring
Candidate's full name for the letter greeting
job_analysisobject
Job analysis from storylenses_analyze_job
lengthstring
Letter length — short (150-200 words), medium (250-350), or full (400-500)one of short · medium · fulldefault: medium
localestring
Output language (en, de, es, or pt)one of en · de · es · ptdefault: en
match_dataobject
Match data from storylenses_match_profile
tonestring
Writing tone — professional, conversational, confident, etc.one of professional · conversational · formal · confident · analytical · storytellingdefault: professional
storylenses_quality_checkScore and evaluate a cover letter for relevance, narrative strength, and completeness. Returns score 0-100 with actionable feedback.3 params

Score and evaluate a cover letter for relevance, narrative strength, and completeness. Returns score 0-100 with actionable feedback.

Parameters* required
job_analysisobject
Job analysis from storylenses_analyze_job for context
letter_textstring
The cover letter text to evaluate (minimum 200 characters)
localestring
Feedback language (en, de, es, or pt)one of en · de · es · ptdefault: en
storylenses_list_archetypesReturn available narrative archetypes with descriptions so the agent or user can select a style1 params

Return available narrative archetypes with descriptions so the agent or user can select a style

Parameters* required
localestring
Description language (en, de, es, or pt)one of en · de · es · ptdefault: en

Sponsors

Readme

StoryLenses MCP Server

AI-powered cover letter generation for MCP-compatible agents. The first production MCP server for job applications.

Tools

ToolDescription
storylenses_analyze_jobExtract 15+ structured fields from a job posting
storylenses_match_profileMatch a candidate CV against job data
storylenses_generate_letterGenerate a story-driven cover letter
storylenses_quality_checkScore and evaluate a cover letter
storylenses_list_archetypesList available narrative archetypes and tones

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "storylenses": {
      "command": "npx",
      "args": ["-y", "@storylenses/mcp-server"],
      "env": {
        "STORYLENSES_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / VS Code

Add to .cursor/mcp.json or VS Code MCP settings:


View the full README on GitHub

Details

Repository
github.com/benediktgirz/storylenses-mcp-server
Package
@storylenses/mcp-server
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active