# DigitalCore MCP Free

**Free service management toolkit for MCP-enabled AI assistants.**

Get instant access to 29 expert playbooks, KPI metrics, and service health scoring - all through the Model Context Protocol (MCP).

[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-blue)](https://modelcontextprotocol.io)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

## 🚀 Quick Start

Add DigitalCore to your MCP client with a single config line:

### Windsurf

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

```json
{
  "mcpServers": {
    "digitalcore": {
      "serverUrl": "https://mcpfree.digitalcore.app/mcp"
    }
  }
}
```

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "digitalcore": {
      "url": "https://mcpfree.digitalcore.app/mcp",
      "transport": "streamable-http"
    }
  }
}
```

### VS Code GitHub Copilot

Add to your MCP settings:

```json
{
  "servers": {
    "digitalcore": {
      "type": "http",
      "url": "https://mcpfree.digitalcore.app/mcp"
    }
  }
}
```

### Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "digitalcore": {
      "url": "https://mcpfree.digitalcore.app/mcp",
      "transport": "http"
    }
  }
}
```

## 🛠️ Available Tools

### 1. `list_playbooks`
List all 29 service management playbooks covering margin protection, renewal risk, capacity planning, and more.

```
User: "What playbooks do you have?"
AI: [calls list_playbooks] → Returns categorized list of all playbooks
```

### 2. `get_playbook`
Get detailed content for any playbook including problem statement, key takeaways, and KPIs.

```
User: "Tell me about margin protection"
AI: [calls get_playbook(name="engagement-margin-protection")] → Returns playbook details
```

### 3. `explain_metric`
Understand KPI metrics with formulas, benchmarks, and improvement tips.

```
User: "How do I calculate gross margin?"
AI: [calls explain_metric(metric_name="gross_margin")] → Returns formula and tips
```

### 4. `run_service_reality_check`
**⭐ Flagship Tool** - Get instant health scoring for any service.

```
User: "Check my service health: €500K revenue, €400K costs, 5 FTEs, 95% SLA"
AI: [calls run_service_reality_check(...)] → Returns comprehensive health score with insights
```

**Example Output:**
```json
{
  "overall_score": 72,
  "dimensions": {
    "economics": {"score": 65, "status": "Attention Needed"},
    "delivery": {"score": 92, "status": "Healthy"},
    "efficiency": {"score": 58, "status": "Attention Needed"}
  },
  "insights": [
    {"type": "warning", "message": "Margin of 20% is below the 35% healthy threshold..."},
    {"type": "positive", "message": "Strong SLA achievement of 95%..."}
  ]
}
```

### 5. `submit_email`
Get access to the comprehensive Service Economics Guide.

### 6. `submit_feedback`
Help improve the service by rating tool responses.

## 📊 Playbook Categories

| Category | Examples |
|----------|----------|
| **Margin & Profitability** | Engagement Margin Protection, Cost Optimization |
| **Renewal & Retention** | Renewal Risk Assessment, Churn Prevention |
| **Capacity & Resources** | Capacity Planning, Utilization Optimization |
| **SLA & Performance** | SLA Management, Performance Monitoring |
| **Growth & Expansion** | Upsell Identification, Service Expansion |

## 🔗 API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/mcp` | POST | MCP JSON-RPC endpoint |
| `/health` | GET | Service health check |
| `/tools` | GET | List available tools |
| `/metadata` | GET | Server metadata |
| `/configs` | GET | Client configuration snippets |

## 🌐 Direct API Access

For non-MCP clients, REST endpoints are available:

```bash
# List playbooks
curl https://mcpfree.digitalcore.app/list_playbooks

# Get specific playbook
curl "https://mcpfree.digitalcore.app/get_playbook?name=engagement-margin-protection"

# Run service reality check
curl -X POST https://mcpfree.digitalcore.app/run_service_reality_check \
  -H "Content-Type: application/json" \
  -d '{"revenue": 500000, "costs": 400000, "ftes": 5, "sla_achievement": 95}'
```

## 📖 About DigitalCore

DigitalCore is a strategic service management platform for MSPs, MSSPs, and IT service providers. Our platform helps you:

- **Optimize margins** with real-time financial insights
- **Predict renewals** with AI-powered risk scoring  
- **Plan capacity** with demand forecasting
- **Track SLAs** with automated breach detection

**Learn more:** [digitalcore.app](https://www.digitalcore.app)

## 🔒 Privacy & Security

- No API key required for free tier
- Session data retained for 90 days
- Email addresses retained until unsubscribe
- No PII logged except voluntarily submitted email
- See our [Privacy Policy](https://www.digitalcore.app/privacy)

## 📜 License

MIT License - see [LICENSE](LICENSE) for details.

## 🤝 Support

- **Documentation:** [digitalcore.app/mcp](https://www.digitalcore.app/mcp)
- **Email:** support@digitalcore.app
- **Issues:** [GitHub Issues](https://github.com/DigitalCoreApp/digitalcore-mcp-free/issues)

---

**Made with ❤️ by [DigitalCore](https://www.digitalcore.app)**