MCP-Server
FormulaSignal
com.formulasignal/record
Was dieses MCP kann
Provides dated formula records, ingredient research and regulatory context, pricing data, comparisons, and change monitoring for pre-workout supplements.
Funktionen
Tools
18
Tools
ingredients.regulatory
Get regulatory context
Return regulatory records and documented cautions for named ingredients, each carrying the class of record it actually is.
When to use: Use when you need to know what filings, advisories, label warnings, interactions, or enforcement actions FormulaSignal holds for an ingredient.
What it cannot provide: A regulatory filing is never returned as an approval, a warning, or a finding of harm. Nothing here is medical clearance.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'product_id': {'type': 'string', 'description': 'A canonical product id, to read the ingredients that product declares. Pass this or ingredient_ids, not both.'}, 'ingredient_ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 5, 'minItems': 1, 'description': 'Up to five canonical ingredient ids. Pass these or product_id, not both.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
ingredients.research
Get research context
Return the dose range used in the selected evidence set for named ingredients, with the citation and its limitations.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'product_id': {'type': 'string', 'description': 'A canonical product id, to read the ingredients that product declares. Pass this or ingredient_ids, not both.'}, 'ingredient_ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 5, 'minItems': 1, 'description': 'Up to five canonical ingredient ids. Pass these or product_id, not both.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
ledger.get
Get ledger edition
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.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['edition_id'], 'properties': {'edition_id': {'type': 'string', 'description': 'A Category Ledger edition id, as returned by ledger.list.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
ledger.list
List ledger editions
List the published Category Ledger editions: period, status, data-as-of date and the count released in each.
When to use: Call this first to find which edition covers a period, then fetch that edition by id.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
products.compare
Compare products
Compare two or three covered products on consistent FormulaSignal criteria.
When to use: Use when a user asks how covered products differ on formula, serving economics, stimulant load, or record depth.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_ids'], 'properties': {'product_ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 3, 'minItems': 2, 'description': 'Two or three canonical product ids to compare. Resolve names with products.resolve first.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
products.get
Get product record
Return the controlled current Record for one covered product: identity, serving configuration, declared ingredients, captured price context, and freshness.
When to use: Use when you need what a product declares right now, with the dates and limitations attached.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'description': 'A canonical FormulaSignal product id, such as the product_id returned by products.resolve. Not a display name.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
products.history
Get formula history
Return the controlled historical timeline for one covered product, with each state classified by what it can actually support.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'description': 'A canonical FormulaSignal product id, such as the product_id returned by products.resolve. Not a display name.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
products.resolve
Resolve product
Resolve a brand, product name, or alias to one canonical covered product.
When to use: Call this first whenever you hold a user-supplied product name and need the canonical product_id every other capability takes.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'maxLength': 120, 'description': 'A brand, product name or alias as the user wrote it, for example "C4 Original".'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
products.serving_economics
Get serving economics
Return the captured commercial facts and the deterministic price arithmetic for one covered product.
When to use: Use for package price, price basis, serving count, price per serving, and the date each was observed.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'description': 'A canonical FormulaSignal product id, such as the product_id returned by products.resolve. Not a display name.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
record.search
Search record
Answer one specific, bounded question from FormulaSignal's covered pre-workout Record.
When 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.
What it cannot provide: It cannot list the database, export products, answer medical or suitability questions, or answer about a product FormulaSignal does not cover.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 300, '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.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
record.version
Get record version
Return the public Record version, the methodology version, the supported category, coverage counts, and source freshness.
When to use: Call this to state which version of FormulaSignal intelligence an answer came from, or to detect that coverage has moved.
What it cannot provide: It exposes no implementation detail, no internal scoring, and no proprietary methodology text.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
signals.explain
Explain signal
Explain one approved FormulaSignal Signal: a confirmed, reviewed change between two comparable product states.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['signal_id'], 'properties': {'signal_id': {'type': 'string', 'description': 'A Signal id, as named by a product record, a formula history, or signals.list.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
signals.list
List signal changes
Return approved FormulaSignal Signals in release order, newest first, for incremental polling.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'brand': {'type': 'string', 'description': 'Only Signals for this brand, matched on the full brand name, case-insensitive.'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': "Signals per page, 1 to 25. Defaults to the plan's page size."}, 'since': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', '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.'}, 'until': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Only Signals released on or before this date, YYYY-MM-DD.'}, 'cursor': {'type': 'string', 'description': 'The next_cursor value from the previous page. Omit it for the first page.'}, 'category': {'type': 'string', 'description': "Only Signals whose change category matches this value, case-insensitive, as shown in a Signal's change.category field."}, 'dimension': {'type': 'string', 'description': 'Only Signals of this kind of change: FORMULA, FORMULA_DOSE, SERVING, PRICE, CLAIMS, CERTIFICATION, LIFECYCLE or OTHER.'}, 'product_id': {'type': 'string', 'description': 'Only Signals for this canonical product id.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
signals.snapshot
Get category snapshot
Return a bounded summary of approved Signals and coverage state across the covered pre-workout set for a date window.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End of the window, YYYY-MM-DD. Defaults to today (UTC).'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start of the window, YYYY-MM-DD. Defaults to the widest window the plan allows before `to`.'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': "Signals per page, 1 to 25. Defaults to the plan's page size."}, 'cursor': {'type': 'string', 'description': 'The next_cursor value from the previous page. Omit it for the first page.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
watchlist.add
Watch product
Add one covered product to the bound account's watchlist.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'maxLength': 120, 'description': 'The canonical product id to start watching. Resolve a name with products.resolve first.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
watchlist.list
List watched products
Return the watchlist of the one Founding Pro account this key is bound to, with each product's monitoring state.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
watchlist.receipt
Get watch receipt
Return the monitoring receipt for one period: valid checks, attempts that returned nothing, recoveries, and confirmed Signals.
When 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.
What 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.
Limits: 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.
FormulaSignal 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'period': {'type': 'string', 'maxLength': 7, 'description': 'A calendar month, YYYY-MM. Defaults to the current month (UTC).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
watchlist.remove
Unwatch product
Remove one product from the bound account's watchlist.
When to use: Use when a person asks to stop watching a product. Future alerts stop; everything already delivered stays.
What it cannot provide: It cannot delete an account, cancel a subscription, or remove history. Removing a watch never removes what was already sent.
Limits: 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.
FormulaSignal 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.
Destruktiv
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'maxLength': 120, 'description': 'The canonical product id to stop watching.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['request_id', 'capability', 'status'], 'properties': {'error': {'type': 'object', 'description': 'Present only on a refusal: code, message, and what to do next.'}, 'watch': {'type': 'object', 'description': "The bound account's watchlist or monitoring receipt."}, 'ledger': {'type': 'object'}, 'status': {'enum': ['supported', 'partial', 'stale', 'under_review', 'ambiguous', 'unsupported', 'refused'], 'type': 'string', '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.'}, 'history': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated product states, oldest first.'}, 'product': {'type': ['object', 'null'], 'description': 'The covered product the answer is about, when there is exactly one.'}, 'signals': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Approved Signals: confirmed, reviewed changes.'}, 'summary': {'type': 'string', 'description': 'One sentence saying what kind of answer this is.'}, 'coverage': {'type': 'object'}, 'products': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Covered products named by the answer.'}, 'candidates': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present when `status` is `ambiguous`. Pick one; never assume the first.'}, 'capability': {'type': 'string', 'description': 'The API capability that answered.'}, 'comparison': {'type': 'object'}, 'confidence': {'type': 'object', 'properties': {'level': {'enum': ['high', 'moderate', 'low', 'none'], 'type': 'string'}, 'explanation': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Quote this if you contact support.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Always present, including when empty. Read it and repeat what applies.'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass back as `cursor` for the next page. Null on the last page.'}, 'calculations': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Deterministic arithmetic FormulaSignal performed, with its operands.'}, 'record_as_of': {'type': 'string', 'description': "The Record's as-of date, YYYY-MM-DD."}, 'record_version': {'type': 'string', 'description': 'The Record data-state id. Two answers sharing it came from one committed state.'}, 'verified_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'What a captured source literally declares.'}, 'commercial_facts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dated commercial observations, each with its price basis.'}, 'record_timestamp': {'type': 'string', 'description': 'The newest dated observation the Record holds. Deliberately not "now".'}, 'research_context': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Dose ranges from the selected evidence set, with citations.'}, 'source_references': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Citations a reader can open: publisher, URL, observation date.'}, 'regulatory_records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Filings and records, each labelled with the class of record it is.'}, 'documented_cautions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Documented cautions, kept apart from filings.'}, 'methodology_version': {'type': 'string'}}, 'additionalProperties': True}
Verlauf
Letzte Tool-Änderungen
Entfernt
formulasignal_watch_product
29. September 2026 03:02
Entfernt
formulasignal_unwatch_product
29. September 2026 03:02
Entfernt
formulasignal_search_record
29. September 2026 03:02
Entfernt
formulasignal_resolve_product
29. September 2026 03:02
Entfernt
formulasignal_list_watched_products
29. September 2026 03:02
Entfernt
formulasignal_list_signal_changes
29. September 2026 03:02
Entfernt
formulasignal_list_ledger_editions
29. September 2026 03:02
Entfernt
formulasignal_get_watch_receipt
29. September 2026 03:02
Entfernt
formulasignal_get_serving_economics
29. September 2026 03:02
Entfernt
formulasignal_get_research_context
29. September 2026 03:02
Entfernt
formulasignal_get_regulatory_context
29. September 2026 03:02
Entfernt
formulasignal_get_record_version
29. September 2026 03:02
Entfernt
formulasignal_get_product_record
29. September 2026 03:02
Entfernt
formulasignal_get_ledger_edition
29. September 2026 03:02
Entfernt
formulasignal_get_formula_history
29. September 2026 03:02
Entfernt
formulasignal_get_category_snapshot
29. September 2026 03:02
Entfernt
formulasignal_explain_signal
29. September 2026 03:02
Entfernt
formulasignal_compare_products
29. September 2026 03:02
Hinzugefügt
record.version
29. September 2026 03:02
Hinzugefügt
watchlist.receipt
29. September 2026 03:02
Hinzugefügt
watchlist.remove
29. September 2026 03:02
Hinzugefügt
watchlist.add
29. September 2026 03:02
Hinzugefügt
watchlist.list
29. September 2026 03:02
Hinzugefügt
ledger.get
29. September 2026 03:02
Hinzugefügt
ledger.list
29. September 2026 03:02
Hinzugefügt
signals.snapshot
29. September 2026 03:02
Hinzugefügt
ingredients.regulatory
29. September 2026 03:02
Hinzugefügt
ingredients.research
29. September 2026 03:02
Hinzugefügt
products.serving_economics
29. September 2026 03:02
Hinzugefügt
products.compare
29. September 2026 03:02
Entdecken
Ähnliche MCP-Server
Clink Forge
com.clinkforge/clink-forge
Provides pay-per-call access to attested government datasets, primarily CDC and HHS health data plus EPA air-quality observations.
Pubmed
io.github.pipeworx-io/pubmed
Provides PubMed biomedical literature search and retrieval, including abstracts, full text where available, citation metadata, re…
Europepmc
io.github.pipeworx-io/europepmc
Searches and retrieves biomedical literature from Europe PMC, including abstracts, full records, citations, publication metadata,…
Pharma Intel
io.github.pipeworx-io/pharma-intel
Combines clinical trial, FDA, PubMed, drug identification, safety, pipeline, sales, patent, and pharmaceutical sponsor data for d…
Herb Tcm
io.github.pipeworx-io/herb-tcm
Searches and retrieves Traditional Chinese Medicine herb, ingredient, target, disease, experiment, and supporting literature reco…
Opentargets
io.github.pipeworx-io/opentargets
Provides Open Targets disease, drug, target, therapeutic-area, and disease-association knowledge graph lookups.
Chembl
io.github.pipeworx-io/chembl
Queries the ChEMBL drug-discovery database for molecules, mechanisms of action, indications, targets, and small-molecule bioactiv…
Hpo Api
io.github.pipeworx-io/hpo-api
Looks up Human Phenotype Ontology terms and associations between diseases, clinical phenotypes, and genes.