Server definition
- Hash
- sha256:45c096a498c32e2c7074c8c95b1a4ba100191c5b54646697c6b816bb597afd82
- What it is
- What a remote MCP server returned when asked what it offers: 18 tools
The blob, as servednamed by its sha256
{
"instructions": "FormulaSignal keeps a permanent, dated, evidence-backed Record of U.S. pre-workout products: what each one declares, what it costs per serving, how that has changed, and what published research and regulatory filings say about the ingredients. Start with products.resolve to turn a name into a canonical product_id, then call the capability that answers the actual question. Do not call record.search repeatedly with reworded questions; it costs the user quota and produces the same answer. Report status and limitations as facts about the Record rather than as facts about the product. FormulaSignal performs no laboratory testing, gives no medical or suitability advice, and does not publish an unreviewed change as a confirmed one. An observation window is not an exact change date. When asked exactly when a product changed, give the window and say the exact date is not established.",
"tools": [
{
"description": "Return regulatory records and documented cautions for named ingredients, each carrying the class of record it actually is.\n\nWhen to use: Use when you need to know what filings, advisories, label warnings, interactions, or enforcement actions FormulaSignal holds for an ingredient.\n\nWhat it cannot provide: A regulatory filing is never returned as an approval, a warning, or a finding of harm. Nothing here is medical clearance.\n\nLimits: Pass ingredient_ids (at most 5) or one product_id, not both. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ingredient_ids": {
"description": "Up to five canonical ingredient ids. Pass these or product_id, not both.",
"items": {
"maxLength": 120,
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"product_id": {
"description": "A canonical product id, to read the ingredients that product declares. Pass this or ingredient_ids, not both.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "ingredients.regulatory",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the dose range used in the selected evidence set for named ingredients, with the citation and its limitations.\n\nWhen to use: Use to place a declared amount against published work. Pass ingredient ids, or a product_id to read the ingredients that product declares.\n\nWhat it cannot provide: A dose comparison is not evidence of effectiveness, safety, or suitability for any person, and the response says so on every record.\n\nLimits: Pass ingredient_ids (at most 5) or one product_id, not both. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ingredient_ids": {
"description": "Up to five canonical ingredient ids. Pass these or product_id, not both.",
"items": {
"maxLength": 120,
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"product_id": {
"description": "A canonical product id, to read the ingredients that product declares. Pass this or ingredient_ids, not both.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "ingredients.research",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return one Category Ledger edition: the executive summary, confirmed changes released in the period, category benchmarks with their cohorts, serving economics, the product comparison, and the limitations.\n\nWhen to use: Use when an agent needs the month's category intelligence with every denominator attached, or needs to cite a figure a customer is reading on the web edition.\n\nWhat it cannot provide: It never returns an unreviewed candidate, a Signal the publication gate refuses, a preserved-source path, or a hash of any stored source. The edition_hash it does return is a hash of the published document itself, so a machine citation and the page a person was sent can be checked against each other.\n\nLimits: One edition per call. Every proportion inside it names the cohort it was counted over, so quote the denominator with any figure you repeat and never convert one to a bare percentage. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"edition_id": {
"description": "A Category Ledger edition id, as returned by ledger.list.",
"type": "string"
}
},
"required": [
"edition_id"
],
"type": "object"
},
"name": "ledger.get",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "List the published Category Ledger editions: period, status, data-as-of date and the count released in each.\n\nWhen to use: Call this first to find which edition covers a period, then fetch that edition by id.\n\nWhat it cannot provide: It returns no figures from inside an edition and no product data. A closed edition's identity never changes, so this list is safe to cache.\n\nLimits: Identities only. A frozen edition never changes, so its listing and its content are both safe to cache; an in-progress one moves until its period closes. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "ledger.list",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Compare two or three covered products on consistent FormulaSignal criteria.\n\nWhen to use: Use when a user asks how covered products differ on formula, serving economics, stimulant load, or record depth.\n\nWhat it cannot provide: It returns no overall winner and no suitability judgement. A product whose depth is REGISTERED is refused rather than compared, because a guessed label beside a measured one implies a precision the Record does not have.\n\nLimits: At most 3 products per call, and every product must be at NORMALIZED depth. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_ids": {
"description": "Two or three canonical product ids to compare. Resolve names with products.resolve first.",
"items": {
"maxLength": 120,
"type": "string"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [
"product_ids"
],
"type": "object"
},
"name": "products.compare",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the controlled current Record for one covered product: identity, serving configuration, declared ingredients, captured price context, and freshness.\n\nWhen to use: Use when you need what a product declares right now, with the dates and limitations attached.\n\nWhat it cannot provide: It returns no preserved source bytes, no internal capture identifiers, no review notes, and no verdict about whether the product is good or suitable.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "A canonical FormulaSignal product id, such as the product_id returned by products.resolve. Not a display name.",
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "products.get",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the controlled historical timeline for one covered product, with each state classified by what it can actually support.\n\nWhen to use: Use to find out whether a product has changed, how deep the recoverable history is, and which states are comparable to each other.\n\nWhat it cannot provide: It never presents an observation window as an exact reformulation date, and it never reports an unreviewed candidate as a confirmed change.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "A canonical FormulaSignal product id, such as the product_id returned by products.resolve. Not a display name.",
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "products.history",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Resolve a brand, product name, or alias to one canonical covered product.\n\nWhen to use: Call this first whenever you hold a user-supplied product name and need the canonical product_id every other capability takes.\n\nWhat it cannot provide: It never guesses. An ambiguous or generic name returns the candidate list and no match, and an uncovered product returns no match at all.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"identifier": {
"description": "A brand, product name or alias as the user wrote it, for example \"C4 Original\".",
"maxLength": 120,
"type": "string"
}
},
"required": [
"identifier"
],
"type": "object"
},
"name": "products.resolve",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the captured commercial facts and the deterministic price arithmetic for one covered product.\n\nWhen to use: Use for package price, price basis, serving count, price per serving, and the date each was observed.\n\nWhat it cannot provide: It never calls an observed price a list price unless the Record recorded it as one, and it never reports a promotional-versus-list difference as a price change.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "A canonical FormulaSignal product id, such as the product_id returned by products.resolve. Not a display name.",
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "products.serving_economics",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Answer one specific, bounded question from FormulaSignal's covered pre-workout Record.\n\nWhen to use: Use for a single natural-language question about a covered product: what it declares now, whether it changed, what it costs per serving, or which covered products meet one stated numeric condition.\n\nWhat it cannot provide: It cannot list the database, export products, answer medical or suitability questions, or answer about a product FormulaSignal does not cover.\n\nLimits: One question, at most 300 characters. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"query": {
"description": "One plain-language question about covered pre-workout products, for example \"How much caffeine is in C4 Original?\". Ask once; rewording the same question returns the same answer and costs quota.",
"maxLength": 300,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "record.search",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the public Record version, the methodology version, the supported category, coverage counts, and source freshness.\n\nWhen to use: Call this to state which version of FormulaSignal intelligence an answer came from, or to detect that coverage has moved.\n\nWhat it cannot provide: It exposes no implementation detail, no internal scoring, and no proprietary methodology text.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "record.version",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Explain one approved FormulaSignal Signal: a confirmed, reviewed change between two comparable product states.\n\nWhen to use: Use when a product record or history response named a signal_id and you need the before state, the after state, the observation window, and the evidence.\n\nWhat it cannot provide: It has no access to unreviewed candidates, review deliberation, or the internal review queue. A signal_id that is not approved returns not found.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"signal_id": {
"description": "A Signal id, as named by a product record, a formula history, or signals.list.",
"type": "string"
}
},
"required": [
"signal_id"
],
"type": "object"
},
"name": "signals.explain",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return approved FormulaSignal Signals in release order, newest first, for incremental polling.\n\nWhen to use: Use to keep a system in step with the Record. Pass `since` with the release date you last saw, or follow `next_cursor`, and filter by product, brand, dimension or category.\n\nWhat it cannot provide: It returns no unreviewed candidate and no change event that fails the publication gate, and it is not an export of the product table.\n\nLimits: At most 25 Signals per page, newest release first. Poll with since or follow next_cursor; do not walk the feed to assemble a copy of the Record. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"brand": {
"description": "Only Signals for this brand, matched on the full brand name, case-insensitive.",
"type": "string"
},
"category": {
"description": "Only Signals whose change category matches this value, case-insensitive, as shown in a Signal's change.category field.",
"type": "string"
},
"cursor": {
"description": "The next_cursor value from the previous page. Omit it for the first page.",
"type": "string"
},
"dimension": {
"description": "Only Signals of this kind of change: FORMULA, FORMULA_DOSE, SERVING, PRICE, CLAIMS, CERTIFICATION, LIFECYCLE or OTHER.",
"type": "string"
},
"limit": {
"description": "Signals per page, 1 to 25. Defaults to the plan's page size.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"product_id": {
"description": "Only Signals for this canonical product id.",
"type": "string"
},
"since": {
"description": "Only Signals released on or after this date, YYYY-MM-DD. Pass the newest release date you have already seen to poll for what is new.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"until": {
"description": "Only Signals released on or before this date, YYYY-MM-DD.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "signals.list",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return a bounded summary of approved Signals and coverage state across the covered pre-workout set for a date window.\n\nWhen to use: Use for 'what changed in the category recently'. Pass from and to dates; the window is capped and the page size is capped.\n\nWhat it cannot provide: It is not an export. It returns approved Signals inside one bounded window, never the product table and never the underlying Record.\n\nLimits: Bounded window of at most 400 days and at most 25 items per page. Follow next_cursor for more. Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The next_cursor value from the previous page. Omit it for the first page.",
"type": "string"
},
"from": {
"description": "Start of the window, YYYY-MM-DD. Defaults to the widest window the plan allows before `to`.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"limit": {
"description": "Signals per page, 1 to 25. Defaults to the plan's page size.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"to": {
"description": "End of the window, YYYY-MM-DD. Defaults to today (UTC).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "signals.snapshot",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Add one covered product to the bound account's watchlist.\n\nWhen to use: Use when a person asks to start watching a product. Resolve the product first if you were given a name rather than an id.\n\nWhat it cannot provide: It cannot add a product outside the covered set, exceed the account's watch limit, or act on an account this key is not bound to. It refuses a covered product FormulaSignal cannot monitor yet and says why in the refusal. It does not start a subscription and refuses when the account is not entitled.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "The canonical product id to start watching. Resolve a name with products.resolve first.",
"maxLength": 120,
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "watchlist.add",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the watchlist of the one Founding Pro account this key is bound to, with each product's monitoring state.\n\nWhen to use: Use to answer what a person is watching, when each product was last read, when the next check is due, and whether anything is currently unreadable.\n\nWhat it cannot provide: It reaches exactly one account, the one bound to this key, and no other. It returns no candidate detail, no source URL and no internal identifier, and it is not a way to read the covered set.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "watchlist.list",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Return the monitoring receipt for one period: valid checks, attempts that returned nothing, recoveries, and confirmed Signals.\n\nWhen to use: Use to answer whether anything a person watches changed in a period, and what monitoring did in the period whether or not anything did.\n\nWhat it cannot provide: A count of valid checks is not a claim that a product held still. It reports no candidate, no source URL and no internal identifier, and a period the monitoring ledger does not reach is reported as partly covered rather than as zero.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"period": {
"description": "A calendar month, YYYY-MM. Defaults to the current month (UTC).",
"maxLength": 7,
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "watchlist.receipt",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
},
{
"description": "Remove one product from the bound account's watchlist.\n\nWhen to use: Use when a person asks to stop watching a product. Future alerts stop; everything already delivered stays.\n\nWhat it cannot provide: It cannot delete an account, cancel a subscription, or remove history. Removing a watch never removes what was already sent.\n\nLimits: Your plan has a daily limit on how many distinct products, Signals and ingredients you may read. Repeating a question about the same product costs nothing extra; reading many different products costs one each. Do not iterate through products, aliases, or date windows to assemble a copy of the Record: it is refused, scored, and can suspend the key.\n\nFormulaSignal covers a defined, counted set of U.S. pre-workout products. Coverage is not the whole category, and a product being absent from coverage says nothing about that product. Every response carries a status. `supported` means the Record answered. `partial`, `stale`, `under_review`, `ambiguous` and `unsupported` are all real answers about the Record and none of them is a fact about the product: report them as what FormulaSignal holds, never as what is true of the product. Read `limitations` and repeat what applies. An observation date is when a source was read, not when a change was made, and an observation window is not an exact reformulation date. Nothing here is medical advice or a suitability judgement for any person.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "The canonical product id to stop watching.",
"maxLength": 120,
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "watchlist.remove",
"outputSchema": {
"additionalProperties": true,
"properties": {
"calculations": {
"description": "Deterministic arithmetic FormulaSignal performed, with its operands.",
"items": {
"type": "object"
},
"type": "array"
},
"candidates": {
"description": "Present when `status` is `ambiguous`. Pick one; never assume the first.",
"items": {
"type": "object"
},
"type": "array"
},
"capability": {
"description": "The API capability that answered.",
"type": "string"
},
"commercial_facts": {
"description": "Dated commercial observations, each with its price basis.",
"items": {
"type": "object"
},
"type": "array"
},
"comparison": {
"type": "object"
},
"confidence": {
"properties": {
"explanation": {
"type": "string"
},
"level": {
"enum": [
"high",
"moderate",
"low",
"none"
],
"type": "string"
}
},
"type": "object"
},
"coverage": {
"type": "object"
},
"disclaimer": {
"type": "string"
},
"documented_cautions": {
"description": "Documented cautions, kept apart from filings.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"description": "Present only on a refusal: code, message, and what to do next.",
"type": "object"
},
"history": {
"description": "Dated product states, oldest first.",
"items": {
"type": "object"
},
"type": "array"
},
"ledger": {
"type": "object"
},
"limitations": {
"description": "Always present, including when empty. Read it and repeat what applies.",
"items": {
"type": "string"
},
"type": "array"
},
"methodology_version": {
"type": "string"
},
"next_cursor": {
"description": "Pass back as `cursor` for the next page. Null on the last page.",
"type": [
"string",
"null"
]
},
"product": {
"description": "The covered product the answer is about, when there is exactly one.",
"type": [
"object",
"null"
]
},
"products": {
"description": "Covered products named by the answer.",
"items": {
"type": "object"
},
"type": "array"
},
"record_as_of": {
"description": "The Record's as-of date, YYYY-MM-DD.",
"type": "string"
},
"record_timestamp": {
"description": "The newest dated observation the Record holds. Deliberately not \"now\".",
"type": "string"
},
"record_version": {
"description": "The Record data-state id. Two answers sharing it came from one committed state.",
"type": "string"
},
"regulatory_records": {
"description": "Filings and records, each labelled with the class of record it is.",
"items": {
"type": "object"
},
"type": "array"
},
"request_id": {
"description": "Quote this if you contact support.",
"type": "string"
},
"research_context": {
"description": "Dose ranges from the selected evidence set, with citations.",
"items": {
"type": "object"
},
"type": "array"
},
"signals": {
"description": "Approved Signals: confirmed, reviewed changes.",
"items": {
"type": "object"
},
"type": "array"
},
"source_references": {
"description": "Citations a reader can open: publisher, URL, observation date.",
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"description": "What kind of answer this is. Every value except `supported` is still a real answer about the Record rather than a fact about the product.",
"enum": [
"supported",
"partial",
"stale",
"under_review",
"ambiguous",
"unsupported",
"refused"
],
"type": "string"
},
"summary": {
"description": "One sentence saying what kind of answer this is.",
"type": "string"
},
"verified_facts": {
"description": "What a captured source literally declares.",
"items": {
"type": "object"
},
"type": "array"
},
"watch": {
"description": "The bound account's watchlist or monitoring receipt.",
"type": "object"
}
},
"required": [
"request_id",
"capability",
"status"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:45c096a498c32e2c7074c8c95b1a4ba100191c5b54646697c6b816bb597afd82 | sha256sum