Metadata-Version: 2.4
Name: forceweaver-mcp-server
Version: 1.1.0
Summary: Professional Salesforce Revenue Cloud health checking for AI agents
Author-email: ForceWeaver Team <support@forceweaver.com>
License: MIT
Project-URL: Homepage, https://mcp.forceweaver.com
Project-URL: Documentation, https://github.com/forceweaver/forceweaver-mcp-server
Project-URL: Repository, https://github.com/forceweaver/forceweaver-mcp-server.git
Project-URL: Bug Tracker, https://github.com/forceweaver/forceweaver-mcp-server/issues
Project-URL: Changelog, https://github.com/forceweaver/forceweaver-mcp-server/blob/main/CHANGELOG.md
Keywords: salesforce,mcp,ai,health-check,revenue-cloud,model-context-protocol
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Communications
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.12.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: requests>=2.28.0
Requires-Dist: certifi>=2022.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: aioresponses>=0.7.4; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Dynamic: license-file

# 🚀 **ForceWeaver MCP Client**

**Professional Salesforce Revenue Cloud health checking for AI agents**

[![Claude](https://img.shields.io/badge/Works_with-Claude-orange)](https://claude.ai) [![Cursor](https://img.shields.io/badge/Works_with-Cursor-white)](https://cursor.so) [![Cline](https://img.shields.io/badge/Works_with-Cline-purple)](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*
