@gera/mcp-heliodoc

MCP (Model Context Protocol) server for Heliodoc -- the AI-powered telemedicine platform by Gera Services.

Enables AI assistants (Claude, ChatGPT, etc.) to search doctors, check availability, and book medical appointments across 50+ countries.

Tools

| Tool | Description | Auth Required | |------|-------------|:---:| | search_doctors | Search doctors by specialty, location, language, appointment type, and rating | No | | get_doctor_profile | Get detailed doctor profile (bio, qualifications, fees, languages) | No | | get_available_slots | Get open appointment time slots for a doctor on a given date | No | | list_specialties | List all medical specialties available in a country | No | | get_featured_doctors | Get top-rated, verified doctors | No | | get_health_services | Get all health service types available in a country (telemedicine, pharmacy, labs, home nursing) | No | | book_appointment | Book a video, in-person, or chat consultation | Yes |

Installation

npm install @gera/mcp-heliodoc

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "heliodoc": {
      "command": "npx",
      "args": ["@gera/mcp-heliodoc"]
    }
  }
}

With a custom API endpoint

{
  "mcpServers": {
    "heliodoc": {
      "command": "npx",
      "args": ["@gera/mcp-heliodoc"],
      "env": {
        "HELIODOC_API_URL": "https://your-api-url.example.com"
      }
    }
  }
}

Standalone

npx @gera/mcp-heliodoc

Configuration

| Environment Variable | Description | Default | |---------------------|-------------|---------| | HELIODOC_API_URL | Base URL for the Heliodoc API | https://api.heliodoc.com |

Multi-Country Support

Heliodoc operates across 50+ countries. Pass a country code (ISO 3166-1 alpha-2) to any tool to scope results to that country. Supported countries include Georgia (GE), Uganda (UG), Ghana (GH), Kenya (KE), Nigeria (NG), Pakistan (PK), Bangladesh (BD), Colombia (CO), Peru (PE), Ecuador (EC), and many more.

Authentication

Read-only tools (search, availability, specialties) work without authentication. Booking requires a user bearer token passed via the auth_token parameter.

License

MIT