{"openapi":"3.1.0","info":{"title":"Everstack Agent Commerce API","version":"1.0.0","description":"Versioning: v1 is stable; every path is also served under /api/v1/ (for example /api/v1/catalog). Breaking changes ship as /api/v2 with 90 days of overlap. Public, read-only catalog of Everstack supplement regimens (US only) plus a non-binding checkout intent. No auth. Pre-launch: checkout intents return a waitlist link and no payment is taken. Structure/function claims only; see disclaimer fields.","contact":{"email":"hello@everstackhealth.com"}},"servers":[{"url":"https://everstackhealth.com"}],"externalDocs":{"description":"Agent and developer guide","url":"https://everstackhealth.com/agents"},"paths":{"/api/agent/catalog":{"get":{"operationId":"listProducts","summary":"List or search products","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}},{"name":"q","in":"query","schema":{"type":"string"},"description":"Keyword: ingredient, goal or name"}],"responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/api/agent/products/{id}":{"get":{"operationId":"getProduct","summary":"Get one product","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["foundation","foundation-sleep","longevity-pro","performance"]}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}}],"responses":{"200":{"description":"Product","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"404":{"description":"Not found","content":{"application/problem+json":{}}}}}},"/api/agent/checkout-intent":{"get":{"operationId":"checkoutIntentGet","summary":"Get a buy/reserve link for a product","parameters":[{"name":"product","in":"query","required":true,"schema":{"type":"string","enum":["foundation","foundation-sleep","longevity-pro","performance"]}},{"name":"quantity","in":"query","schema":{"type":"integer","minimum":1,"maximum":6}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}}],"responses":{"200":{"description":"Intent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutIntent"}}}}}},"post":{"operationId":"checkoutIntent","summary":"Create a checkout intent","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["product"],"properties":{"product":{"type":"string","enum":["foundation","foundation-sleep","longevity-pro","performance"]},"quantity":{"type":"integer","minimum":1,"maximum":6},"lang":{"type":"string","enum":["en","es"]}}}}}},"responses":{"200":{"description":"Intent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutIntent"}}}}}}},"/api/agent/papers":{"get":{"operationId":"listPapers","summary":"Search the graded research library (DOI verified)","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"topic","in":"query","schema":{"type":"string"}},{"name":"grade","in":"query","schema":{"type":"string","enum":["A","B","C","D"]}}],"responses":{"200":{"description":"Papers"}}}},"/api/agent/papers/{id}":{"get":{"operationId":"getPaper","summary":"One paper by slug or DOI","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}}],"responses":{"200":{"description":"Paper"},"404":{"description":"Not found"}}}},"/api/agent/podcasts":{"get":{"operationId":"listPodcasts","summary":"Verified podcast episodes by evidence topic","parameters":[{"name":"topic","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Episodes"}}}},"/api/agent/health":{"get":{"operationId":"listHealthHubs","summary":"Immunity, brain, glycine and children's health articles with citations (education only)","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}}],"responses":{"200":{"description":"Hubs"}}}},"/api/agent/kids":{"get":{"operationId":"listKidsProducts","summary":"Kids candidate products: parent/guardian buyers 18+ only, label dose only, pediatrician sheets","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}}],"responses":{"200":{"description":"Kids products"}}}},"/api/agent/frontier":{"get":{"operationId":"listFrontier","summary":"Longevity research frontier (not products)","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","es"],"default":"en"}}],"responses":{"200":{"description":"Frontier"}}}},"/api/waitlist":{"post":{"operationId":"joinWaitlist","summary":"Reserve a regimen for a human (with their consent)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email"},"tier":{"type":"string","enum":["","foundation","foundation-sleep","longevity-pro","performance"]},"lang":{"type":"string","enum":["en","es"]},"source":{"type":"string","example":"agent"}}}}}},"responses":{"200":{"description":"Saved"},"400":{"description":"Invalid"}}}},"/api/mcp":{"post":{"operationId":"mcp","summary":"MCP server (Streamable HTTP, JSON-RPC 2.0). Tools: search_products, get_product, get_evidence, list_faq, create_checkout_intent","requestBody":{"content":{"application/json":{}}},"responses":{"200":{"description":"JSON-RPC response"}}}}},"components":{"schemas":{"Price":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"},"interval":{"type":"string"},"per_day":{"type":"number"}}},"Ingredient":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"dose":{"type":"string"},"time":{"type":"string","enum":["AM","PM"]},"claim":{"type":"string"},"certification":{"type":"string"},"evidence_grade":{"type":"string","enum":["A","B","C","D"]},"evidence_url":{"type":"string"},"citations":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}}}},"Product":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"tagline":{"type":"string"},"for_who":{"type":"string"},"price":{"$ref":"#/components/schemas/Price"},"availability":{"type":"string"},"ingredients":{"type":"array","items":{"$ref":"#/components/schemas/Ingredient"}},"url":{"type":"string"},"checkout_intent":{"type":"string"},"disclaimer":{"type":"string"}}},"Catalog":{"type":"object","properties":{"status":{"type":"object"},"count":{"type":"integer"},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}},"CheckoutIntent":{"type":"object","properties":{"product":{"type":"string"},"quantity":{"type":"integer"},"subtotal":{"$ref":"#/components/schemas/Price"},"status":{"type":"string","enum":["waitlist","checkout"]},"action_url":{"type":"string"},"instructions":{"type":"string"},"requires_human_confirmation":{"type":"boolean"}}}}}}