StoryLenses — AI Cover Letter Engine for Agents
RemoteAbout StoryLenses — AI Cover Letter Engine for Agents
StoryLenses is an MCP server for agents that supports job applications by analyzing postings, matching candidate CVs, and generating and evaluating narrative cover letters. It offers 15+ narrative archetypes and supports English, German, Spanish, and Portuguese.
Key features
- 01Extracts structured job-posting details
- 02Matches candidate CVs to jobs
- 03Generates narrative cover letters
- 04Scores and evaluates letters
- 05Lists narrative archetypes and tones
Use cases
- 01Turn a job posting into structured data
- 02Compare a candidate CV with a role
- 03Draft a tailored cover letter
- 04Review a letter's quality
MCP support
Exposes five tools to MCP clients for job-posting analysis, profile matching, cover-letter generation and evaluation, and archetype listing.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://www.storylenses.app/api/mcp/endpointclaude mcp add --transport http storylenses https://www.storylenses.app/api/mcp/endpoint{"mcpServers":{"storylenses":{"type":"http","url":"https://www.storylenses.app/api/mcp/endpoint"}}}Open in Cursor{"servers":{"storylenses":{"type":"http","url":"https://www.storylenses.app/api/mcp/endpoint"}}}Open in VS Code{"mcpServers":{"storylenses":{"type":"http","url":"https://www.storylenses.app/api/mcp/endpoint"}}}{"mcpServers":{"storylenses":{"serverUrl":"https://www.storylenses.app/api/mcp/endpoint"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://www.storylenses.app/api/mcp/endpointAuth requiredTools
5| Parameter | Type | Required | Description |
|---|---|---|---|
| job_url | string | No | URL of the job posting to analyze |
| job_text | string | No | Raw text of the job posting (use if no URL) |
| locale | enum | No | Response languageen | de | es | pt |
Details
From the project READMEStoryLenses MCP Server
AI-powered cover letter generation for MCP-compatible agents. The first production MCP server for job applications.
Tools
| Tool | Description |
|---|---|
storylenses_analyze_job | Extract 15+ structured fields from a job posting |
storylenses_match_profile | Match a candidate CV against job data |
storylenses_generate_letter | Generate a story-driven cover letter |
storylenses_quality_check | Score and evaluate a cover letter |
storylenses_list_archetypes | List 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:
{
"mcp": {
"servers": {
"storylenses": {
"command": "npx",
"args": ["-y", "@storylenses/mcp-server"],
"env": {
"STORYLENSES_API_KEY": "your-api-key"
}
}
}
}
}
Docker
docker run -e STORYLENSES_API_KEY=your-key ghcr.io/benediktgirz/storylenses-mcp-server
Environment Variables
| Variable | Required | Description |
|---|---|---|
STORYLENSES_API_KEY | Yes | Your API key from storylenses.app/mcp |
STORYLENSES_API_URL | No | API base URL (default: https://www.storylenses.app) |
Example Workflow
// 1. Analyze job posting
const job = await callTool("storylenses_analyze_job", {
job_url: "https://linkedin.com/jobs/view/12345"
});
// 2. Match candidate profile
const match = await callTool("storylenses_match_profile", {
job_analysis: job,
candidate_cv: "Senior engineer with 7 years React experience..."
});
// 3. Generate cover letter
const letter = await callTool("storylenses_generate_letter", {
job_analysis: job,
match_data: match,
candidate_name: "Alex Chen",
archetype: match.suggestedArchetype
});
// 4. Quality check
const score = await callTool("storylenses_quality_check", {
letter_text: letter.letter_text,
job_analysis: job
});
Testing
npm install
STORYLENSES_API_KEY=your-key npm test
Get an API Key
Visit storylenses.app/mcp to get your API key.
- Free: 10 generations/month
- Developer ($29/mo): 200 generations
- Scale ($99/mo): 1,000 generations
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.