theta-health-mcp-client/README.md

Theta Health MCP Client for WebSocket connection - Works like @notionhq/notion-mcp-server

# theta-health-mcp-client

Theta Health MCP Client for WebSocket connection. Works just like `@notionhq/notion-mcp-server` with `npx`!

## Installation & Usage

### Use with npx (Recommended)

Just like other MCP servers, you can use it directly with npx:

```bash
npx theta-health-mcp-client
```

### Use in Cursor MCP Configuration

Add to your `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "theta-health-remote": {
      "command": "npx",
      "args": ["-y", "theta-health-mcp-client"],
      "env": {
        "THETA_HEALTH_TOKEN": "your_jwt_token_here",
        "THETA_HEALTH_ENDPOINT": "ws://localhost:18022"
      }
    }
  }
}
```

## Environment Variables

- `THETA_HEALTH_TOKEN` - Your JWT authentication token (required)
- `THETA_HEALTH_ENDPOINT` - WebSocket server endpoint (default: `ws://localhost:18022`)

## Available Tools

This MCP client provides access to 6 health-related tools:

1. **get_user_health_profile** - Get user health profile information
2. **get_user_basic_info** - Get user basic information (name, gender, birth date)
3. **get_medical_records** - Get user medical records
4. **get_lab_results** - Get laboratory test results
5. **analyze_database_table** - Analyze database table structure and data distribution
6. **list_database_tables** - List all tables in a specified schema

## Requirements

- Node.js >= 16.0.0
- A running Theta Health WebSocket MCP server

## Example Usage

```bash
# Set environment variables
export THETA_HEALTH_TOKEN="your_jwt_token"
export THETA_HEALTH_ENDPOINT="ws://localhost:18022"

# Run the client
npx theta-health-mcp-client
```

## License

MIT

## Support

For issues and questions, please visit: https://github.com/theta-health/mcp-client/issues