Developer Platform — Coming soon

Developer API
coming soon

Mother Nature AI is developing API access to its domain-specific health AI models. Public API access is not currently available. Access is planned for AskMN v3, Sylvia 2.1, NutriGen 1.0, and Genlyy 1.3, with structured outputs and evidence citations on HIPAA-compliant infrastructure.

Retrieval over a curated index of medical literature · Structured JSON I/O · HIPAA BAA available

Request API Access View Model Specs
REST + JSON
Business Associate Agreements available for covered entities.
API coming soon
API key auth

Planned Models

Four specialized health AI models

Each model is domain-specific. Request access for the models relevant to your use case.

API in development

AskMN v3

Herbal medicine · Toxicology · General health

The primary health and herbal intelligence model. Reasons across 3,000+ medicinal plants, drug-herb interactions, toxicology risk, and integrative health protocols with evidence citations.

Request access
API in development

Sylvia 2.1

Mental health · Crisis detection · CBT/DBT

Specialized mental health model fine-tuned on CBT, DBT, trauma-informed care, and psychiatric literature. Includes 98.2%-sensitivity crisis detection and safe messaging protocol activation.

Request access
API in development

NutriGen 1.0

Nutrigenomics · Dietary optimization

Multi-modal nutrigenomics engine. Fuses SNP data, dietary logs, and micronutrient panels to generate genotype-specific nutrition protocols calibrated to 200+ genetic loci.

Request access
Invite Only

Genlyy 1.3

Genomic variant interpretation · PGx

Structured genomic interpretation. Processes VCF/SNP arrays and returns ACMG/AMP-classified variant reports across 4,800+ loci with FDA pharmacogenomics cross-reference.

Request access

The public API has not launched. You can register interest and we will contact you when private preview opens. No timeline is committed at this stage. Genlyy 1.3 will require additional partner vetting.

Authentication

API key authentication

The planned API will use bearer token authentication. Include your API key in the Authorization header. Keys are intended to be project-scoped, with configurable model-level permissions.

  • Project-scoped keys, separate per environment
  • Scoping of keys to specific model families
  • Audit logging of API key activity
Authentication

Illustrative API preview — endpoint not currently available

# Set your API key as an environment variable
export ASKMN_API_KEY="replace_with_your_askmn_api_key"

# Include in every request header
Authorization: Bearer $ASKMN_API_KEY

# Verify your key
curl https://api.askmn.ai/v1/models \
  -H "Authorization: Bearer $ASKMN_API_KEY"

# Response
{
  "models": [
    { "id": "askmn-v3", "status": "available" },
    { "id": "sylvia-2.1", "status": "available" },
    { "id": "nutrigen-1.0", "status": "available" },
    { "id": "genlyy-1.3", "status": "invite_only" }
  ]
}
200 OK — Response body

Illustrative API preview — endpoint not currently available

{
  "id": "chat_01JK8X2F4M9NV3P",
  "model": "askmn-v3",
  "content": "Ashwagandha (Withania somnifera) contains withanolide glycosides that may modestly inhibit CYP2C9 — the primary enzyme responsible for warfarin (S-warfarin) metabolism. Co-administration carries a theoretical risk of elevated warfarin plasma levels and increased bleeding risk [PMID: 28601062, 31394563].",
  "structured_findings": {
    "interaction_severity": "moderate",
    "mechanism": "CYP2C9 inhibition (theoretical, in vitro evidence)",
    "clinical_recommendation": "If patient proceeds, monitor INR within 1–2 weeks of initiating ashwagandha. Dose reduction of warfarin may be required.",
    "contraindication_flags": [
      {
        "type": "drug_herb_interaction",
        "compound_a": "warfarin",
        "compound_b": "ashwagandha",
        "severity": "moderate",
        "evidence_level": "in_vitro_theoretical"
      }
    ]
  },
  "citations": [
    {
      "pmid": "28601062",
      "title": "Withania somnifera CYP inhibition in human liver microsomes",
      "journal": "Phytomedicine"
    },
    {
      "pmid": "31394563",
      "title": "Herb-drug interactions in anticoagulant therapy",
      "journal": "British Journal of Clinical Pharmacology"
    }
  ],
  "confidence_level": "moderate",
  "escalation_flag": false,
  "usage": { "input_tokens": 94, "output_tokens": 284 }
}

Structured Outputs

Machine-readable health intelligence

Every model returns structured JSON alongside conversational text — making it straightforward to build clinical features without parsing free-form responses.

Interaction severity classification

Structured compound-pair objects with severity level, mechanism of action, and evidence grade.

Evidence citations

Designed to provide PMID references and journal attribution where available.

Contraindication flags

Machine-readable flag objects for drug-herb interactions, toxicology risks, and crisis signals.

Confidence level

Model-assessed confidence (high / moderate / low) based on evidence density and case complexity.

Escalation flag

Boolean signal for red-flag situations requiring immediate clinical or crisis intervention.

Use Cases

What builders are creating

Integrative Health Apps

Embed AskMN v3 as an herbal and integrative health reasoning layer. Users ask about supplements, herbal combinations, and plant-drug interactions and receive evidence-cited, toxicology-aware guidance.

Mental Wellness Platforms

Power CBT and mindfulness apps with Sylvia 2.1. Crisis detection, psychoeducation delivery, and PHQ-9/GAD-7 severity classification built into every interaction.

Nutrition & Wellness SaaS

Layer NutriGen 1.0 on food logging or supplement platforms to deliver genotype-specific nutrition protocols. Connects seamlessly with Genlyy for full genomic context.

Genetic Testing Labs

Use Genlyy 1.3 as an AI interpretation layer for raw DNA test outputs. Turn VCF files into provider-facing patient reports with medication metabolism profiles.

EHR & Clinical Systems

Integrate AskMN v3 summarization and analysis endpoints to generate AI-assisted clinical notes, surface herb-drug interaction flags, and support integrative medicine workflows.

Research Platforms

Access model APIs for population-level health research, genomic cohort analysis, and clinical decision support development under IRB-governed data use agreements.

SDKs

Planned client libraries

These packages are not yet published. Names and versions are indicative of the planned surface.

Python

Planned

API in development
Python SDK — not yet published

Full-featured Python SDK with type hints, async support, streaming, and automatic retry. Python 3.9+ compatible.

JavaScript / TypeScript

Planned

API in development
JavaScript SDK — not yet published

Isomorphic SDK for Node.js and browser. Full TypeScript types, ESM + CJS, streaming via async iterators.

REST (Direct)

Planned v1

API in development
Endpoint not yet available

Direct REST access via HTTP is planned. An OpenAPI spec is not currently published.

Compliance & Security

Infrastructure you can build on

HIPAA BAA

Business Associate Agreements available for covered entities. PHI is processed in isolated compute environments.

HIPAA

HIPAA compliant. Security controls documentation available to partners under NDA.

Data Residency

US inference by default.

Audit Logging

Audit logging of API activity is planned for the API preview.

Ready to build?

Register interest in API access. The public API has not launched, and we are not committing a credentials timeline. We will contact you if a private preview opens.

Request API Access View Model Specs

Related