Skip to content

MCP guide: read a bottle row's addedTablespoons with its amount and unit - #65

Merged
DrAlexHarrison merged 1 commit into
mainfrom
measurefollow
Oct 10, 2026
Merged

DrAlexHarrison merged 1 commit into
mainfrom
measurefollow

Conversation

@DrAlexHarrison

Copy link
Copy Markdown
Member

Documents the bottling plan's mix rows for partners, including the new addedTablespoons field from fuel-backend #1740.

Depends-On: SaturdayInc/fuel-backend#1740

Why

Until #1740 a row's amount + unit was the whole dose. A cup row can now need addedTablespoons as well: ⅜ cup + addedTablespoons: 1 is 87.5 g of sugar, and a reader that prints only "⅜ cup Sugar" puts 12.5 g less in the bottle. The only prod partner with bottling on today is the Claude connector, which reads the text content and gets the composite, so no live reader is affected; this lands before bottling opens to another partner. Flagged by the #1740 review (https://github.com/SaturdayInc/fuel-backend/pull/1740#issuecomment-6095559896).

What the page now says

Under "Bottling plans" in guides/mcp-integration.mdx:

  • what a row's amount and unit mean, with the unit tokens
  • addedTablespoons: tablespoons measured after a cup amount, counted in carbG, absent when 0, with one example row
  • kitchen sugar follows the athlete's carb measure; a call with no athlete reads cups; the text content writes ⅜ cup + 1 Tbsp Sugar
  • structuredContent.measures (cupMl, tbspMl, cupsOffered) for a non-US kitchen, which was undocumented

Checks

scripts/check-docs-drift.py clean against fuel-backend main and against #1740's branch. Its JSON key check matches snake_case keys only, so camelCase payload keys such as addedTablespoons and carbG are not checked against the Go tags either way.

Merge after fuel-backend #1740 lands, so the page does not describe a field before partners can get it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01BasXynvDZeJp2RYJAdJWhe

A cup row of a bottling plan can carry tablespoons measured after the cup
amount (fuel-backend #1740). A partner that shows only amount and unit would
print a bottle short of its sugar, so the guide describes the rows, shows one
with addedTablespoons, and names the measures a non-US kitchen counts in.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BasXynvDZeJp2RYJAdJWhe

Ci-From: linux
Ci-Session: e5711247-a754-4ad2-bff4-55d04a7c6133
@DrAlexHarrison
DrAlexHarrison merged commit 95d150b into main Oct 10, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant