How do I use Benefits Agent MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Benefits Agent MCP Server check if MEM001 is eligible for dental cleaning" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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