{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"percent-yield"},"result":{"entity_type":"calculator","id":"percent-yield","calculator_id":"percent-yield","canonical_url":"https://tttkmbb.com/chemistry/percent-yield","name":"Percent Yield Calculator","title":"Percent Yield Calculator – Actual vs Theoretical Yield of a Chemical Reaction","category":"chemistry","category_name":"Chemistry","tool_name":"calculate_percent_yield","featured_mcp_tool":false,"description":"Divides the actual (experimental) yield by the theoretical yield to give percent yield, plus the amount and percentage of product lost.","use_when":"You have the theoretical yield from stoichiometry and the mass or moles actually isolated, and want the reaction's percent yield.","do_not_use_when":"You still need the theoretical yield itself (compute moles of product from the limiting reagent with moles-mass first), or you want atom economy, which compares molar masses of reagents and product rather than isolated yield.","inputs":[{"name":"actual_yield","label":"Actual yield","type":"number","required":true,"min":0,"description":"Amount of product actually obtained, in grams or moles (same unit as theoretical_yield).","example":4.5},{"name":"theoretical_yield","label":"Theoretical yield","type":"number","required":true,"exclusive_min":0,"description":"Maximum amount of product predicted by stoichiometry from the limiting reagent, same unit as actual_yield.","example":5}],"outputs":[{"name":"percent_yield","label":"Percent yield","type":"number","unit":"%","decimals":2,"description":"100 × actual / theoretical."},{"name":"yield_fraction","label":"Yield fraction","type":"number","decimals":4,"description":"actual / theoretical."},{"name":"product_lost","label":"Product lost","type":"number","decimals":4,"description":"theoretical − actual, in the input unit."},{"name":"percent_lost","label":"Percent lost","type":"number","unit":"%","decimals":2,"description":"100 − percent_yield."}],"input_schema":{"type":"object","properties":{"actual_yield":{"description":"Amount of product actually obtained, in grams or moles (same unit as theoretical_yield).","type":"number","minimum":0,"examples":[4.5]},"theoretical_yield":{"description":"Maximum amount of product predicted by stoichiometry from the limiting reagent, same unit as actual_yield.","type":"number","exclusiveMinimum":0,"examples":[5]}},"additionalProperties":false,"required":["actual_yield","theoretical_yield"]},"output_schema":{"type":"object","properties":{"percent_yield":{"description":"100 × actual / theoretical. Unit: %.","type":"number","x-unit":"%"},"yield_fraction":{"description":"actual / theoretical.","type":"number"},"product_lost":{"description":"theoretical − actual, in the input unit.","type":"number"},"percent_lost":{"description":"100 − percent_yield. Unit: %.","type":"number","x-unit":"%"}}},"formula":"percent_yield = 100 × actual_yield / theoretical_yield; product_lost = theoretical_yield − actual_yield","sources":[{"name":"OpenStax Chemistry 2e – 4.4 Reaction Yields","url":"https://openstax.org/books/chemistry-2e/pages/4-4-reaction-yields","type":"textbook","retrieved_at":"2026-09-23"},{"name":"Wikipedia – Yield (chemistry)","url":"https://en.wikipedia.org/wiki/Yield_(chemistry)","type":"reference","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"4.5 g obtained of 5.0 g theoretical","inputs":{"actual_yield":4.5,"theoretical_yield":5},"expected":{"percent_yield":90,"yield_fraction":0.9,"product_lost":0.5,"percent_lost":10},"url":"https://tttkmbb.com/api/v1/calculate/percent-yield?actual_yield=4.5&theoretical_yield=5"},{"name":"12.3 g obtained of 15.0 g theoretical","inputs":{"actual_yield":12.3,"theoretical_yield":15},"expected":{"percent_yield":82,"product_lost":2.7},"url":"https://tttkmbb.com/api/v1/calculate/percent-yield?actual_yield=12.3&theoretical_yield=15"}],"faq":[{"q":"Can percent yield exceed 100%?","a":"Not for a pure, dry product. A value above 100% indicates residual solvent, impurities or a weighing error; the calculator reports it with a note."},{"q":"Should I use grams or moles?","a":"Either, as long as both yields use the same unit for the same product; the ratio is identical."}],"tags":["percent yield","theoretical yield","actual yield","reaction yield","stoichiometry"],"related":[{"calculator_id":"moles-mass","reason":"Convert moles of product from stoichiometry into the theoretical mass."},{"calculator_id":"molar-mass","reason":"Molar mass of the product for the mass conversion."},{"calculator_id":"percentage","reason":"General percentage arithmetic."}],"links":{"html":"https://tttkmbb.com/chemistry/percent-yield","markdown":"https://tttkmbb.com/chemistry/percent-yield.md","json":"https://tttkmbb.com/chemistry/percent-yield.json","api":"https://tttkmbb.com/api/v1/calculate/percent-yield","schema":"https://tttkmbb.com/api/v1/calculators/percent-yield","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:31:14Z","next_actions":[{"tool":"run_calculator","calculator_id":"percent-yield","reason":"Run Percent Yield Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/chemistry/percent-yield.md"}}