cs-upgrade-mcp

MCP server for CloudSense managed package upgrade assessments. Provides tools for package registry queries, breaking changes analysis, effort estimation, upgrade path recommendation, claim validation, and document generation — all accessible from Cursor IDE via the Model Context Protocol.

Quick Install

npm install -g cs-upgrade-mcp

Or run directly with npx (no install required):

npx -y cs-upgrade-mcp

Cursor IDE Configuration

Add to your Cursor MCP settings (~/.cursor/mcp.json or project .cursor/mcp.json):

{
  "mcpServers": {
    "cs-upgrade-mcp": {
      "command": "npx",
      "args": ["-y", "cs-upgrade-mcp"]
    }
  }
}

Tools

| Tool | Description | |------|-------------| | cs_package_registry | Query CloudSense package metadata, versions, and release mappings (R31-R38) | | cs_breaking_changes_db | Query the curated breaking changes database (23 validated + 18 debunked entries) | | cs_estimate_effort | Calculate stage-by-stage upgrade effort based on org metrics, calibrated against real engagements | | cs_validate_genie_claim | Validate claims from Genie MCP against the known debunked/validated database | | cs_recommend_upgrade_path | Recommend optimal upgrade milestones based on version gap and org characteristics | | cs_generate_assessment | Generate a complete Package Upgrade Assessment document | | cs_generate_sow | Generate a Professional Services Addendum / Scope of Work | | cs_generate_slides | Generate a 3-slide executive summary |

Bundled Data

• 30 CloudSense packages with version mappings across R31-R38
• 41 breaking change entries (23 validated, 18 debunked) across R33-R37
• 3 client benchmarks for estimation calibration
• 3 Handlebars templates for document generation (Assessment, SOW, Executive Slides)

Cursor Skill

A companion Cursor Skill is included in skills/cloudsense-upgrade-assessment/ that orchestrates the full end-to-end assessment workflow:

1. Client setup and org discovery
2. Package analysis and version mapping
3. Upgrade path recommendation
4. Impact assessment with triple-validation
5. Effort estimation
6. Document generation (Assessment, SOW, Slides)

See USERGUIDE.md for installation instructions.

Documentation

• USERGUIDE.md — Step-by-step setup and workflow walkthrough
• ARCHITECTURE.md — System architecture, tool details, data model, extension guide

Supported Releases

R31 through R38. R31-R32 have limited release note coverage. R33+ have validated breaking change data.

Requirements

• Node.js >= 18
• Cursor IDE with MCP support
• Recommended: Genie MCP (user-lf-genie_mcp) for release note queries
• Recommended: Salesforce CLI (sf) for org metadata queries

License

MIT