Skip to main content
Glama
sudhakaren

FastMCP Patient Information Server

by sudhakaren

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"
    }
  }
}
F
license - not found
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sudhakaren/healthnav'

If you have feedback or need assistance with the MCP directory API, please join our Discord server