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