io.github.benediktgirz/storylenses
AI cover letter generation for agents. Job analysis, profile matching, narrative letters.
Open source Repository Open in the app JSON README (API)
About
AI cover letter generation for agents. Job analysis, profile matching, narrative letters.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- benediktgirz
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.3
- Last push
- 2026-04-08T09:51:55Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:30
- Updated
- 2026-08-29 03:02:30
- Origin id
io.github.benediktgirz/storylenses
README
# StoryLenses 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`:
```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:
```json
{
"mcp": {
"servers": {
"storylenses": {
"command": "npx",
"args": ["-y", "@storylenses/mcp-server"],
"env": {
"STORYLENSES_API_KEY": "your-api-key"
}
}
}
}
}
```
### Docker
```bash
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
```typescript
// 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
```bash
npm install
STORYLENSES_API_KEY=your-key npm test
```
## Get an API Key
Visit [storylenses.app/mcp](https://www.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