# StoryLenses MCP Server

AI cover letter generation for agents. 5 composable tools that analyze job postings (15+ structured fields), match candidate profiles,

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add benedikt-mh4x/storylenses

# Browse available tools
npx -y @smithery/cli@latest tool list benedikt-mh4x/storylenses

# Get full schema for a tool
npx -y @smithery/cli@latest tool get benedikt-mh4x/storylenses storylenses_analyze_job

# Call a tool
npx -y @smithery/cli@latest tool call benedikt-mh4x/storylenses storylenses_analyze_job '{}'
```

## Direct MCP Connection

Endpoint: `https://storylenses--benedikt-mh4x.run.tools`

**Required config:**
- `STORYLENSES_API_KEY` (header) — Your StoryLenses API key (get one free at storylenses.app/developers)

## Tools (5)

- `storylenses_analyze_job` — Extract 15+ structured fields from a job posting — role requirements, company challenges, culture signals, recruiter pr…
- `storylenses_match_profile` — Match a candidate profile/CV against job data — identifies fit score, matching skills, career gaps, and strongest narra…
- `storylenses_generate_letter` — Generate a story-driven cover letter using matched data and a narrative archetype. Supports en/de/es/pt.
- `storylenses_quality_check` — Score and evaluate a cover letter for relevance, narrative strength, and completeness. Returns score 0-100 with actiona…
- `storylenses_list_archetypes` — Return available narrative archetypes with descriptions so the agent or user can select a style

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get benedikt-mh4x/storylenses <tool-name>
```