# Payload MCP Server - Quick Reference

## 📦 Package Info
- **Name:** `@xeniac/payload-mcp`
- **Version:** `1.0.0`
- **Location:** `/home/xen/docker/apps/blogcraft-mcp/servers/payload-mcp`
- **Status:** ✅ Built, tested, ready for registry

## 🚀 Publish Command
```bash
cd /home/xen/docker/apps/blogcraft-mcp/servers/payload-mcp
export NPM_TOKEN="your-token"
npm publish --registry=https://mcpreg.xencolabs.com
```

## 📝 User Configuration
```json
{
  "mcpServers": {
    "payload": {
      "command": "npx",
      "args": ["-y", "--registry=https://mcpreg.xencolabs.com", "@xeniac/payload-mcp"],
      "env": {
        "PAYLOAD_API_URL": "https://cms.xencolabs.com",
        "PAYLOAD_API_TOKEN": "user-jwt-token"
      }
    }
  }
}
```

## ✅ Test Results
```
✅ Health Check: 1354ms
✅ Articles List: 1556ms
✅ Sites List: 1531ms
✅ MCP Protocol: Working
✅ Stays Alive: Yes (no timeout)
```

## 🛠️ Available Tools (13)
1. articles_list / get / create / update / delete
2. sites_list / get / create
3. media_list / upload / get
4. search
5. server_info (diagnostics)

## 📚 Documentation
- **README.md** - User guide with examples
- **ADMIN_GUIDE.md** - Admin/maintenance guide
- **DEPLOYMENT_SUMMARY.md** - Detailed deployment info
- **QUICK_REFERENCE.md** - This file

## 🔧 Test Script
```bash
PAYLOAD_API_TOKEN="token" npm run test
```

## 🏗️ Architecture
- **Protocol:** stdio (MCP standard)
- **Framework:** @modelcontextprotocol/sdk
- **Language:** TypeScript → JavaScript
- **Size:** 17.2 KB tarball
- **Dependencies:** 3 (sdk, zod, payload-api)

## 🎯 Next Steps
1. Publish to registry (needs NPM_TOKEN)
2. Test install: `npx -y --registry=https://mcpreg.xencolabs.com @xeniac/payload-mcp`
3. Announce to users
4. Monitor for feedback

---
**Built:** 2025-10-30 by Cluster Maestro Orchestrator
**Ready for production** 🚀