MedX MCP Server

AI-powered clinical agentic platform featuring our MedX-powered AI Agents and HealthOS, delivering advanced diagnostic support and personalized healthcare.

Overview

The MedX MCP Server provides a RESTful API for AI agents to access medical AI capabilities. It supports:

• Advanced diagnostic support

• Personalized healthcare recommendations

• Clinical decision support

• AI-powered medical consultations

Features

• ✅ RESTful API with Server-Sent Events (SSE) streaming

• ✅ Asynchronous tool execution

• ✅ Session management for conversations

• ✅ Idempotent requests

• ✅ Tool cancellation

• ✅ Health and readiness checks

Quick Start

Server Setup

Server runs on http://localhost:8000 by default.

Client Usage

Documentation

• CLIENT_USAGE_GUIDE.md - Complete client usage guide

• API_DOCUMENTATION.md - Full API reference

• API_QUICK_REFERENCE.md - Quick API cheat sheet

• AGENT_INTEGRATION_GUIDE.md - How agents integrate with MCP server

• ARCHITECTURE_EXPLANATION.md - Server architecture details

Client SDK

The project includes a Python client SDK in the client/ directory:

See CLIENT_USAGE_GUIDE.md for complete examples.

Examples

• examples/simple_client_example.py - Basic client usage

• examples/langchain_integration_example.py - LangChain agent integration

API Endpoints

• GET /mcp/manifest - Discover server capabilities and tools

• POST /mcp/execute - Execute a tool

• GET /mcp/stream/{call_id} - Stream results

• POST /mcp/cancel/{call_id} - Cancel a call

• GET /healthz - Health check

• GET /readyz - Readiness check

Configuration

Environment variables:

• OPENAI_API_KEY - OpenAI API key (required)

• MCP_SERVER_TOKEN - Bearer token for authentication (default: "super-secret-token")

• SERVER_HOST - Server host (default: "0.0.0.0")

• SERVER_PORT - Server port (default: 8000)

License

[Add your license here]

Support

For issues and questions, see the documentation files or create an issue.