{
  "$schema": "https://schemas.openai.com/agent-card/v1",
  "name": "Onvox Voice Glucose",
  "description": "Voice-based metabolic state estimation and personal glucose prediction. Extracts 119 acoustic features from voice recordings and maps them through physiological pathways to estimate metabolic state (no CGM needed) or personal glucose (with calibration). Privacy-first: audio never leaves the device.",
  "url": "https://api.onvox-ai.com",
  "provider": {
    "organization": "Onvox AI",
    "url": "https://onvox-ai.com",
    "contact_email": "info@onvox-ai.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "metabolic_state_estimation": {
      "description": "Estimate metabolic state (low/normal/elevated) from voice features alone. No calibration needed. Works from first recording.",
      "endpoint": "POST /api/v1/developer/metabolic-state",
      "auth_required": true,
      "calibration_required": false
    },
    "personal_glucose_prediction": {
      "description": "Personalized glucose prediction using adaptive ensemble (Ridge + GP). Requires 5+ paired voice-glucose calibration samples.",
      "endpoint": "POST /api/v1/developer/users/{ext_id}/predict",
      "auth_required": true,
      "calibration_required": true,
      "min_calibrations": 5
    },
    "calibration": {
      "description": "Submit paired voice features + reference glucose to train personal model.",
      "endpoint": "POST /api/v1/developer/users/{ext_id}/calibrate",
      "auth_required": true
    },
    "model_status": {
      "description": "Check model stage, calibration count, active models (GP, hypo, voice signal).",
      "endpoint": "GET /api/v1/developer/users/{ext_id}/model",
      "auth_required": true
    },
    "temporal_insights": {
      "description": "Get temporal glucose patterns and personalized insights.",
      "endpoint": "GET /api/v1/developer/users/{ext_id}/insights",
      "auth_required": true,
      "calibration_required": true
    },
    "hypo_risk_detection": {
      "description": "Hypoglycemia risk assessment using hybrid rule-based + ML classification with quality gating.",
      "included_in": "personal_glucose_prediction"
    }
  },
  "authentication": {
    "schemes": [
      {
        "type": "api_key",
        "header": "X-API-Key",
        "description": "Developer API key. Get one at https://onvox-ai.com/developers/pricing",
        "tiers": {
          "free": { "requests_per_month": 1000 },
          "starter": { "requests_per_month": 10000 },
          "pro": { "requests_per_month": 100000 }
        }
      }
    ]
  },
  "protocols": {
    "rest": {
      "base_url": "https://api.onvox-ai.com",
      "openapi": "https://api.onvox-ai.com/openapi.json",
      "documentation": "https://onvox-ai.com/developers/docs"
    },
    "mcp": {
      "transport": "stdio",
      "command": "python3",
      "args": ["-m", "onvox.mcp.server"],
      "env_keys": ["ONVOX_API_KEY"],
      "tools": 13,
      "resources": 4,
      "prompts": 4,
      "install": "pip install onvox"
    }
  },
  "data_handling": {
    "audio_policy": "Audio is processed on-device only. Raw audio is never transmitted to or stored on any server.",
    "feature_policy": "Only numeric feature vectors (119 floats) are transmitted. Feature vectors are non-invertible to audio.",
    "storage": "Calibration data stored in Supabase (EU region). User can delete all data via API.",
    "compliance": "GDPR-aware. No PII in feature vectors."
  },
  "limitations": {
    "disclaimer": "Research prototype. Not a medical device. Not FDA/CE cleared.",
    "accuracy": "Personal models require 10+ calibration samples for reliable predictions. Population-level voice-glucose signal does not exist.",
    "languages": "Voice features are language-agnostic (acoustic, not semantic). Tested primarily on German and English speakers."
  },
  "links": {
    "homepage": "https://onvox-ai.com",
    "documentation": "https://onvox-ai.com/developers/docs",
    "pricing": "https://onvox-ai.com/developers/pricing",
    "playground": "https://onvox-ai.com/developers/playground",
    "privacy_policy": "https://app.onvox-ai.com/privacy",
    "llms_txt": "https://onvox-ai.com/llms.txt",
    "ai_plugin": "https://onvox-ai.com/.well-known/ai-plugin.json",
    "github": "https://github.com/WolfGebhardt/onvox-ai2"
  }
}