Benefits Agent MCP Server
Healthcare Benefits Agent MCP Server for IBM Cloud deployment.
Description
This MCP server provides healthcare coverage information including:
Member eligibility verification
Coverage details (medical, dental, vision, pharmacy)
Service coverage verification
Coverage summaries
Available Tools
get_member_eligibility - Check member eligibility status
get_member_coverage_details - Get detailed coverage information
verify_service_coverage - Verify specific service coverage
get_coverage_summary - Get high-level coverage summary
Test Members
MEM001 - John Doe (PPO Gold, Active)
MEM002 - Jane Smith (HMO Silver, Active)
MEM003 - Robert Johnson (EPO Platinum, Inactive)
Deployment
Deployed on IBM Cloud Code Engine with SSE transport.
---
## Phase 2: Create GitHub Repository
1. **Go to GitHub** (https://github.com)
2. **Create New Repository**
- Click "+" → "New repository"
- **Name**: `mcp-benefits-agent`
- **Visibility**: Public
- **DO NOT** check "Add a README file"
- Click "Create repository"
3. **Upload All 4 Files**
- Click "uploading an existing file"
- Upload:
- `ben_agent_mcp_server.py`
- `requirements.txt`
- `Dockerfile`
- `README.md`
- Click "Commit changes"
4. **Verify**
- Check all 4 files are visible
- Note your repo URL: `https://github.com/unnimk75-web/mcp-benefits-agent`
---
## Phase 3: Use Existing Container Registry
✅ **Good news**: You can reuse your existing namespace!
- **Registry**: `au.icr.io`
- **Namespace**: `coverage-agent-ns` (reuse the same one)
- **No action needed** - skip to Phase 4
---
## Phase 4: Use Existing Code Engine Project
✅ **Good news**: You can deploy to the same project!
- **Project**: `coverage-agent-project` (reuse)
- **No action needed** - proceed to create application
---
## Phase 5: Create Application in Code Engine
1. **Navigate to Your Project**
- IBM Cloud → Code Engine → `coverage-agent-project`
- Click "Applications"
- Click "Create"
2. **General Settings**
- **Name**: `mcp-benefits-agent`
- **Project**: `coverage-agent-project`
- **Source**: "Source code"
3. **Build Details**
- Click "Specify build details"
**Code:**
- **Code repo URL**: `https://github.com/unnimk75-web/mcp-benefits-agent`
- **Branch**: `main`
- **Context directory**: (leave empty)
**Strategy:**
- **Strategy**: `Dockerfile`
- **Dockerfile**: `Dockerfile`
**Output:**
- **Registry server**: `au.icr.io`
- **Registry access**: Select existing
- **Namespace**: `coverage-agent-ns`
- **Repository**: `benefits-server`
- **Tag**: `latest`
4. **Resources & Scaling**
- **CPU**: `0.25 vCPU`
- **Memory**: `0.5 GB`
- **Ephemeral storage**: `0.4 GB`
- **Min instances**: `0`
- **Max instances**: `1`
- **Listening port**: `8000` ⚠️ **CRITICAL!**
5. **Create**
- Click "Create"
- Wait 3-5 minutes for build
---
## Phase 6: Verify Deployment
1. **Check Status**
- Wait for "Ready" status (green)
- Check "Traffic: 100%"
2. **Get Your URL**
- Will be something like:
https://mcp-benefits-agent.245v76j6fyee.us-east.codeengine.appdomain.cloud
3. **Test in Browser**
- Try: `https://mcp-benefits-agent.245v76j6fyee.us-east.codeengine.appdomain.cloud/sse`
---
## Phase 7: Connect to WatsonX Orchestrate
1. **In WatsonX Orchestrate**
- Add new MCP server
- Transport: SSE
2. **Enter URL with /sse**
https://mcp-benefits-agent.245v76j6fyee.us-east.codeengine.appdomain.cloud/sse
