Build with GATOR
Health Intelligence

Connect AI agents and automations to unified health data from labs, wearables, and activity trackers.

Get Started API Reference

Quick Start

Five minutes to your first API call.

1Sign up at healthgator.ai

2Go to Settings → Developer API → Generate Token

3Make your first call:

4Connect to Claude via MCP (see below)

bash

curl -H "Authorization: Bearer gator_xxx" \
  https://healthgator.ai/api/v1/health-summary

Authentication

All requests require an Authorization: Bearer gator_xxx header.

Tokens are generated in Settings → Developer API. They are shown once on creation — save immediately.

Revoke tokens anytime from Settings. Revoked tokens return 401 immediately.

API Endpoints

Full specification: /api/v1/openapi.json

GET/api/v1/health-summaryFree

Unified health snapshot: score, readiness, goals, connected devices

GET/api/v1/health-scoreFree

Health Score with 7-pillar breakdown and history

Parameters: days (number, default: 30)

GET/api/v1/labs/summaryFree

Aggregate lab statistics (no raw values)

GET/api/v1/goalsFree

Active health goals with progress tracking

GET/api/v1/readinessIntelligence

Readiness score with HRV, sleep, recovery, strain components and trend

Parameters: days (number, default: 7)

GET/api/v1/biomarkersIntelligence

Lab biomarkers with reference ranges, percentiles, and clinical ratios

Parameters: category (string)

GET/api/v1/activitiesIntelligence

Deduplicated workouts with source attribution

Parameters: days (number, default: 30), type (string)

GET/api/v1/insightsIntelligence

AI-generated health insights with severity and suggested actions

Parameters: limit (number, default: 5)

Rate Limits

Tier	Requests/Hour	Requests/Day
Free	100	1,000
Intelligence	2,000	20,000

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) included on every response. Exceeding limits returns 429 with Retry-After header.

MCP Setup (Connect to Claude)

GATOR works natively with Claude via the Model Context Protocol (MCP).

Claude Desktop

Generate an API token in Settings
Add this to your Claude Desktop config.json:

json

{
  "mcpServers": {
    "gator": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://healthgator.ai/api/mcp"],
      "env": { "GATOR_API_TOKEN": "gator_YOUR_TOKEN" }
    }
  }
}

Restart Claude Desktop
Ask Claude about your health data

Available Tools

get_health_summaryUnified health snapshot

get_health_scoreHealth score with pillar breakdown

get_labs_summaryAggregate lab statistics

get_goalsHealth goals with progress

get_readinessReadiness score with trend

get_biomarkersLab biomarker results

get_activitiesWorkout activities

get_insightsAI-generated insights

Code Examples

bash

curl -H "Authorization: Bearer gator_YOUR_TOKEN" \
  https://healthgator.ai/api/v1/health-summary

Webhook Events

Webhooks deliver events via HTTP POST with HMAC-SHA256 signatures. Manage webhooks in Settings or via the API.

readiness.thresholdReadiness score crosses a zone boundary

labs.processedNew lab results uploaded and processed

sync.completedDevice sync completed successfully

insights.generatedNew AI insights available

Ready to build?

Generate your API token and start building in minutes.

Get Started Free

Build with GATORHealth Intelligence