🚀 ForceWeaver MCP Client

Professional Salesforce Revenue Cloud health checking for AI agents

The ForceWeaver MCP Client provides seamless integration between AI agents and Salesforce Revenue Cloud health checking services. Built following MCP Security Best Practices, it offers enterprise-grade reliability and security.

---

✨ Features

• 🔍 Comprehensive Health Checks - Advanced Salesforce Revenue Cloud analysis
• 🛡️ Enterprise Security - MCP Security Best Practices compliance
• 🔄 Dual Transport - STDIO (local) and HTTP (remote) support
• 🎯 AI Agent Ready - Works with VS Code, Claude Desktop, and more
• 📊 Detailed Analytics - Bundle analysis, sharing model validation, data integrity checks
• 🚀 Easy Integration - Simple installation and configuration

---

🚀 Quick Start

Installation

pip install forceweaver-mcp-server

Get Your API Key

1. Visit ForceWeaver Dashboard
2. Sign up or log in
3. Navigate to API Keys section
4. Generate a new API key
5. Connect your Salesforce org

---

🔧 Configuration

VS Code + GitHub Copilot

Create or update .vscode/mcp.json:

{
  "servers": {
    "forceweaver": {
      "type": "stdio",
      "command": "python3",
      "args": ["-m", "src"],
      "env": {
        "FORCEWEAVER_API_URL": "https://mcp.forceweaver.com",
        "FORCEWEAVER_API_KEY": "YOUR_API_KEY_HERE",
        "SALESFORCE_ORG_ID": "ORG_ID_HERE"
      }
    }
  }
}

Important:

• Make sure the server is running.
• Ensure GitHub Copilot Chat is in Agent mode
• API keys and org IDs are passed as parameters to individual MCP tools

Claude Desktop

Update ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "forceweaver": {
      "command": "python3",
      "args": ["-m", "src"],
      "env": {
        "FORCEWEAVER_API_URL": "https://mcp.forceweaver.com"
      }
    }
  }
}

Note: API keys and org IDs are passed as parameters to individual MCP tools, not as environment variables.

Environment Variables

export FORCEWEAVER_API_KEY="fk_your_api_key_here"
export SALESFORCE_ORG_ID="your_org_id"
export FORCEWEAVER_API_URL="https://mcp.forceweaver.com"  # Optional

---

🎯 Usage

With AI Agents

Once configured, you can ask your AI agent:

• "Check the health of my Salesforce org"
• "Analyze my Revenue Cloud bundle structure"
• "Show me detailed bundle analysis statistics"
• "List my connected Salesforce organizations"
• "What's my current ForceWeaver usage?"

Available Tools

revenue_cloud_health_check

Comprehensive Salesforce org health analysis including:

• Organization setup validation
• Sharing model analysis
• Bundle hierarchy analysis
• Attribute picklist integrity

get_detailed_bundle_analysis

In-depth bundle analysis with:

• Component count statistics
• Hierarchy depth analysis
• Circular dependency detection
• Performance impact metrics

list_available_orgs

Lists all connected Salesforce organizations in your ForceWeaver account.

get_usage_summary

Current usage statistics and subscription status.

---

🔒 Security

ForceWeaver MCP Client implements comprehensive security measures:

• ✅ MCP Security Best Practices - Full compliance with official guidelines
• ✅ Token Validation - Ensures tokens are issued to the MCP server
• ✅ Input Sanitization - Comprehensive parameter validation
• ✅ SSL/TLS Security - Proper certificate validation
• ✅ Session Security - Secure session management
• ✅ Error Handling - User-friendly error messages

---

📊 Supported Platforms

Platform	Status	Transport	Notes
VS Code + GitHub Copilot	✅ Supported	STDIO	Requires Agent mode
Claude Desktop	✅ Supported	STDIO	Full integration
Claude Web	✅ Supported	HTTP	Via Custom Connectors
Other MCP Clients	✅ Supported	STDIO/HTTP	Standard MCP protocol

---

🔍 Health Check Types

Check Type	Description	Cost
basic_org_info	Organization details and setup validation	1¢
sharing_model	Organization-Wide Default sharing settings	1¢
bundle_analysis	Bundle hierarchy and dependency analysis	1¢
attribute_picklist_integrity	Attribute integrity and orphaned records	1¢

---

🚨 Troubleshooting

Common Issues

"Server as stopped" in VS Code

• Ensure you're using Agent mode in GitHub Copilot Chat
• Check that your API key is valid
• Verify the MCP server configuration in .vscode/mcp.json

"Authentication Failed"

• Verify your API key at ForceWeaver Dashboard
• Ensure your Salesforce org is connected
• Check that your org ID is correct

"Connection Error"

• Verify internet connectivity
• Check ForceWeaver service status
• Ensure firewall allows HTTPS connections

Debug Mode

Enable debug logging:

export MCP_LOG_LEVEL=DEBUG
python -m src

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Run quality checks
6. Submit a pull request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🆘 Support

• Documentation: GitHub Repository
• Issues: GitHub Issues
• Support: ForceWeaver Support
• Dashboard: ForceWeaver Dashboard

---

🎉 About ForceWeaver

ForceWeaver is the leading platform for Salesforce Revenue Cloud health checking and optimization. Our AI-powered analysis helps organizations maintain peak performance and identify potential issues before they impact business operations.

Get Started Today →

---

Made with ❤️ by the ForceWeaver team