# 🚀 **ForceWeaver MCP Client**
**Professional Salesforce Revenue Cloud health checking for AI agents**
[](https://claude.ai) [](https://cursor.so) [](https://github.com/ClineLabs/cline)
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**
```bash
pip install forceweaver-mcp-server
```
### **Get Your API Key**
1. Visit [ForceWeaver Dashboard](https://mcp.forceweaver.com/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`:
```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`:
```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**
```bash
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](https://mcp.forceweaver.com/dashboard/keys)
- 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:
```bash
export MCP_LOG_LEVEL=DEBUG
python -m src
```
---
## 🤝 **Contributing**
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) 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](LICENSE) file for details.
---
## 🆘 **Support**
- **Documentation**: [GitHub Repository](https://github.com/forceweaver/forceweaver-mcp-server)
- **Issues**: [GitHub Issues](https://github.com/forceweaver/forceweaver-mcp-server/issues)
- **Support**: [ForceWeaver Support](https://mcp.forceweaver.com/support)
- **Dashboard**: [ForceWeaver Dashboard](https://mcp.forceweaver.com/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 →](https://mcp.forceweaver.com)**
---
*Made with ❤️ by the ForceWeaver team*
Raw data
{
"_id": null,
"home_page": null,
"name": "forceweaver-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "salesforce, mcp, ai, health-check, revenue-cloud, model-context-protocol",
"author": null,
"author_email": "ForceWeaver Team <support@forceweaver.com>",
"download_url": "https://files.pythonhosted.org/packages/c8/d9/0e725585aa121d6000a0524729cb9dc4cec27b0619a7d2f99ce808d77e1c/forceweaver_mcp_server-1.1.0.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 **ForceWeaver MCP Client**\n\n**Professional Salesforce Revenue Cloud health checking for AI agents**\n\n[](https://claude.ai) [](https://cursor.so) [](https://github.com/ClineLabs/cline)\n\nThe 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.\n\n---\n\n## \u2728 **Features**\n\n- **\ud83d\udd0d Comprehensive Health Checks** - Advanced Salesforce Revenue Cloud analysis\n- **\ud83d\udee1\ufe0f Enterprise Security** - MCP Security Best Practices compliance\n- **\ud83d\udd04 Dual Transport** - STDIO (local) and HTTP (remote) support\n- **\ud83c\udfaf AI Agent Ready** - Works with VS Code, Claude Desktop, and more\n- **\ud83d\udcca Detailed Analytics** - Bundle analysis, sharing model validation, data integrity checks\n- **\ud83d\ude80 Easy Integration** - Simple installation and configuration\n\n---\n\n## \ud83d\ude80 **Quick Start**\n\n### **Installation**\n\n```bash\npip install forceweaver-mcp-server\n```\n\n### **Get Your API Key**\n\n1. Visit [ForceWeaver Dashboard](https://mcp.forceweaver.com/dashboard)\n2. Sign up or log in\n3. Navigate to **API Keys** section\n4. Generate a new API key\n5. Connect your Salesforce org\n\n---\n\n## \ud83d\udd27 **Configuration**\n\n### **VS Code + GitHub Copilot**\n\nCreate or update `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"forceweaver\": {\n \"type\": \"stdio\",\n \"command\": \"python3\",\n \"args\": [\"-m\", \"src\"],\n \"env\": {\n \"FORCEWEAVER_API_URL\": \"https://mcp.forceweaver.com\",\n \"FORCEWEAVER_API_KEY\": \"YOUR_API_KEY_HERE\",\n \"SALESFORCE_ORG_ID\": \"ORG_ID_HERE\"\n }\n }\n }\n}\n```\n\n**Important**: \n- Make sure the server is running.\n- Ensure GitHub Copilot Chat is in **Agent mode**\n- API keys and org IDs are passed as parameters to individual MCP tools\n\n### **Claude Desktop**\n\nUpdate `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"forceweaver\": {\n \"command\": \"python3\",\n \"args\": [\"-m\", \"src\"],\n \"env\": {\n \"FORCEWEAVER_API_URL\": \"https://mcp.forceweaver.com\"\n }\n }\n }\n}\n```\n\n**Note**: API keys and org IDs are passed as parameters to individual MCP tools, not as environment variables.\n\n### **Environment Variables**\n\n```bash\nexport FORCEWEAVER_API_KEY=\"fk_your_api_key_here\"\nexport SALESFORCE_ORG_ID=\"your_org_id\"\nexport FORCEWEAVER_API_URL=\"https://mcp.forceweaver.com\" # Optional\n```\n\n---\n\n## \ud83c\udfaf **Usage**\n\n### **With AI Agents**\n\nOnce configured, you can ask your AI agent:\n\n- *\"Check the health of my Salesforce org\"*\n- *\"Analyze my Revenue Cloud bundle structure\"*\n- *\"Show me detailed bundle analysis statistics\"*\n- *\"List my connected Salesforce organizations\"*\n- *\"What's my current ForceWeaver usage?\"*\n\n### **Available Tools**\n\n#### **`revenue_cloud_health_check`**\nComprehensive Salesforce org health analysis including:\n- Organization setup validation\n- Sharing model analysis\n- Bundle hierarchy analysis\n- Attribute picklist integrity\n\n#### **`get_detailed_bundle_analysis`**\nIn-depth bundle analysis with:\n- Component count statistics\n- Hierarchy depth analysis\n- Circular dependency detection\n- Performance impact metrics\n\n#### **`list_available_orgs`**\nLists all connected Salesforce organizations in your ForceWeaver account.\n\n#### **`get_usage_summary`**\nCurrent usage statistics and subscription status.\n\n---\n\n## \ud83d\udd12 **Security**\n\nForceWeaver MCP Client implements comprehensive security measures:\n\n- **\u2705 MCP Security Best Practices** - Full compliance with official guidelines\n- **\u2705 Token Validation** - Ensures tokens are issued to the MCP server\n- **\u2705 Input Sanitization** - Comprehensive parameter validation\n- **\u2705 SSL/TLS Security** - Proper certificate validation\n- **\u2705 Session Security** - Secure session management\n- **\u2705 Error Handling** - User-friendly error messages\n\n---\n\n## \ud83d\udcca **Supported Platforms**\n\n| Platform | Status | Transport | Notes |\n|----------|--------|-----------|-------|\n| **VS Code + GitHub Copilot** | \u2705 Supported | STDIO | Requires Agent mode |\n| **Claude Desktop** | \u2705 Supported | STDIO | Full integration |\n| **Claude Web** | \u2705 Supported | HTTP | Via Custom Connectors |\n| **Other MCP Clients** | \u2705 Supported | STDIO/HTTP | Standard MCP protocol |\n\n---\n\n## \ud83d\udd0d **Health Check Types**\n\n| Check Type | Description | Cost |\n|------------|-------------|------|\n| **basic_org_info** | Organization details and setup validation | 1\u00a2 |\n| **sharing_model** | Organization-Wide Default sharing settings | 1\u00a2 |\n| **bundle_analysis** | Bundle hierarchy and dependency analysis | 1\u00a2 |\n| **attribute_picklist_integrity** | Attribute integrity and orphaned records | 1\u00a2 |\n\n---\n\n## \ud83d\udea8 **Troubleshooting**\n\n### **Common Issues**\n\n#### **\"Server as stopped\" in VS Code**\n- Ensure you're using **Agent mode** in GitHub Copilot Chat\n- Check that your API key is valid\n- Verify the MCP server configuration in `.vscode/mcp.json`\n\n#### **\"Authentication Failed\"**\n- Verify your API key at [ForceWeaver Dashboard](https://mcp.forceweaver.com/dashboard/keys)\n- Ensure your Salesforce org is connected\n- Check that your org ID is correct\n\n#### **\"Connection Error\"**\n- Verify internet connectivity\n- Check ForceWeaver service status\n- Ensure firewall allows HTTPS connections\n\n### **Debug Mode**\n\nEnable debug logging:\n\n```bash\nexport MCP_LOG_LEVEL=DEBUG\npython -m src\n```\n\n---\n\n## \ud83e\udd1d **Contributing**\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### **Quick Contribution Steps**\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests\n5. Run quality checks\n6. Submit a pull request\n\n---\n\n## \ud83d\udcc4 **License**\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## \ud83c\udd98 **Support**\n\n- **Documentation**: [GitHub Repository](https://github.com/forceweaver/forceweaver-mcp-server)\n- **Issues**: [GitHub Issues](https://github.com/forceweaver/forceweaver-mcp-server/issues)\n- **Support**: [ForceWeaver Support](https://mcp.forceweaver.com/support)\n- **Dashboard**: [ForceWeaver Dashboard](https://mcp.forceweaver.com/dashboard)\n\n---\n\n## \ud83c\udf89 **About ForceWeaver**\n\nForceWeaver 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.\n\n**[Get Started Today \u2192](https://mcp.forceweaver.com)**\n\n---\n\n*Made with \u2764\ufe0f by the ForceWeaver team*\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Professional Salesforce Revenue Cloud health checking for AI agents",
"version": "1.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/forceweaver/forceweaver-mcp-server/issues",
"Changelog": "https://github.com/forceweaver/forceweaver-mcp-server/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/forceweaver/forceweaver-mcp-server",
"Homepage": "https://mcp.forceweaver.com",
"Repository": "https://github.com/forceweaver/forceweaver-mcp-server.git"
},
"split_keywords": [
"salesforce",
" mcp",
" ai",
" health-check",
" revenue-cloud",
" model-context-protocol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0f944f362d85cdfed2cfa0a907222db8561d4c6577b045799a9a110a7683b59c",
"md5": "cec32d492c81b322152a6369728c1b64",
"sha256": "2aa56cdc3a86d9aa5d1eb4a32e1e17e503bd5bee35ecc81a298c3c530dae234c"
},
"downloads": -1,
"filename": "forceweaver_mcp_server-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cec32d492c81b322152a6369728c1b64",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 11757,
"upload_time": "2025-08-10T13:58:31",
"upload_time_iso_8601": "2025-08-10T13:58:31.425712Z",
"url": "https://files.pythonhosted.org/packages/0f/94/4f362d85cdfed2cfa0a907222db8561d4c6577b045799a9a110a7683b59c/forceweaver_mcp_server-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c8d90e725585aa121d6000a0524729cb9dc4cec27b0619a7d2f99ce808d77e1c",
"md5": "ed269c6f87a48533a33d767a65cd2beb",
"sha256": "fb485f0c1d55a0451f3558abe15bcd3eb5aa1f99e2e33437b0adaec803924a1f"
},
"downloads": -1,
"filename": "forceweaver_mcp_server-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "ed269c6f87a48533a33d767a65cd2beb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 19592,
"upload_time": "2025-08-10T13:58:32",
"upload_time_iso_8601": "2025-08-10T13:58:32.720297Z",
"url": "https://files.pythonhosted.org/packages/c8/d9/0e725585aa121d6000a0524729cb9dc4cec27b0619a7d2f99ce808d77e1c/forceweaver_mcp_server-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-10 13:58:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "forceweaver",
"github_project": "forceweaver-mcp-server",
"github_not_found": true,
"lcname": "forceweaver-mcp-server"
}
JSON
