Horizon MCP Server

MCP server exposing get_medical_plan and get_patient tools for the Horizon healthcare platform.
Designed for deployment on horizon.prefect.io.

---

Files

File	Purpose
server.py	Production server — calls live Horizon REST API
server_mock.py	Local dev/test — returns hard-coded sample payloads
requirements.txt	Python dependencies
Dockerfile	Container for SSE-mode deployment

---

Local development

# 1. Install dependencies
pip install -r requirements.txt

# 2. Run in mock mode (stdio, no live API needed)
python server_mock.py

# 3. Or run the real server in SSE mode locally
HORIZON_BASE_URL=https://api.yourdomain.com \
HORIZON_API_KEY=your_key_here \
MCP_TRANSPORT=sse \
python server.py

---

Environment variables

Variable	Default	Description
HORIZON_BASE_URL	https://horizon.prefect.io/api	Base URL of the Horizon REST API
HORIZON_API_KEY	(empty)	Bearer token / API key for auth
MCP_TRANSPORT	stdio	stdio for local, sse for HTTP hosting
MCP_HOST	0.0.0.0	Bind host (SSE mode only)
MCP_PORT	8000	Bind port (SSE mode only)

---

Docker deployment

docker build -t horizon-mcp .

docker run -p 8000:8000 \
  -e HORIZON_BASE_URL=https://api.yourdomain.com \
  -e HORIZON_API_KEY=your_key_here \
  horizon-mcp

The MCP SSE endpoint is available at:
http://localhost:8000/sse

---

Tools

get_medical_plan

Argument	Type	Required	Description
account_id	str	✅	Account UUID
medical_plan_id	str	⬜	Full composite plan ID (e.g. ...M10412)
auto_id	int	⬜	Numeric plan key (e.g. 10412)

Returns a full plan object with deductible, OOP, office visit, physician, facility, diagnostic, DME, emergency care, PT, mental health details, and network records.

---

get_patient

Argument	Type	Required	Description
contact_id	str	✅	Patient contact UUID
account_id	str	⬜	Account UUID (recommended)

Returns demographic data (name, DOB, email, phone) plus an embedded employee object with medical, dental, and vision plan summaries.

---

Claude Desktop / Cursor config (stdio mode)

{
  "mcpServers": {
    "horizon": {
      "command": "python",
      "args": ["/path/to/horizon_mcp/server.py"],
      "env": {
        "HORIZON_BASE_URL": "https://api.yourdomain.com",
        "HORIZON_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Desktop / Cursor config (sse mode — after Docker deploy)

{
  "mcpServers": {
    "horizon": {
      "url": "http://horizon.prefect.io:8000/sse"
    }
  }
}