stresszero-mcp

StressZero MCP Server

MCP server for the StressZero Intelligence API — burnout prevention self-assessment for AI agents, across 3 dimensions (physical, emotional, effectiveness).

Enable Claude, Cursor, Windsurf, n8n, and any MCP-compatible client to help users self-assess their workload signals in real-time conversations.

⚠️ Not a medical device. All scores are indicative, based on self-reported answers. This server provides no diagnosis, no screening, and no clinical triage. Persistent exhaustion warrants a doctor — the tools say so in their outputs.

Tools

Tool	Description
analyze_burnout	Self-assessed burnout signals across physical, emotional, and effectiveness dimensions. Returns an indicative score, level, contributing factors, and prevention recommendations.
generate_burnout_report	Generate a detailed self-assessment report with action plans. Requires Starter+ tier.
quick_burnout_check	Simplified 3-score self-check for chatbots and quick conversations.
get_stresszero_api_key	Create a free API key (500 calls/month) for a user.

Resources

Resource	Description
stresszero://openapi	Complete OpenAPI 3.1 specification

Prompts

Prompt	Description
burnout_assessment	Guided burnout assessment questionnaire template (FR/EN)

Quick Start

1. Get your free API key

Visit stresszeroentrepreneur.fr/intelligence-api and sign up. Free tier: 500 calls/month, no credit card required.

2. Configure your MCP client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "stresszero": {
      "command": "npx",
      "args": ["-y", "stresszero-mcp"],
      "env": {
        "STRESSZERO_API_KEY": "sz_live_your_key_here"
      }
    }
  }
}

Claude Code

Add to .mcp.json at your project root or ~/.claude/mcp.json:

{
  "mcpServers": {
    "stresszero": {
      "command": "npx",
      "args": ["-y", "stresszero-mcp"],
      "env": {
        "STRESSZERO_API_KEY": "sz_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "stresszero": {
      "command": "npx",
      "args": ["-y", "stresszero-mcp"],
      "env": {
        "STRESSZERO_API_KEY": "sz_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "stresszero": {
      "command": "npx",
      "args": ["-y", "stresszero-mcp"],
      "env": {
        "STRESSZERO_API_KEY": "sz_live_your_key_here"
      }
    }
  }
}

3. Use it

Ask Claude: "Check my burnout risk. My sleep quality is 40/100, motivation is 55/100, and productivity is 35/100. I work 60 hours/week as an entrepreneur."

Claude will automatically call quick_burnout_check and return your score with recommendations.

Use Cases

• AI coaching assistant — Help users self-assess their workload in real-time during conversations
• HR AI agent — Aggregated, anonymized team load signals only (individual scores are never exposed to employers)
• Wellness chatbot — Suggest next steps based on self-reported load, including seeing a doctor when signals persist
• n8n automation — Trigger prevention workflows when a self-assessed score crosses a threshold
• Productivity tool — Monitor self-reported wellbeing and suggest breaks

API Tiers

Free tier: 500 calls/month, no credit card. Current paid tiers and pricing: stresszeroentrepreneur.fr/intelligence-api

Environment Variables

Variable	Required	Description
STRESSZERO_API_KEY	Yes	Your API key (starts with sz_live_)
STRESSZERO_API_URL	No	Custom API base URL (default: https://stresszeroentrepreneur.fr)

Development

git clone https://github.com/stresszero/stresszero-mcp.git
cd stresszero-mcp
npm install
npm run build
STRESSZERO_API_KEY=sz_live_xxx node build/index.js

Debug with the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

License

MIT — Emmanuel Gomes Soares, StressZero Entrepreneur