How to Use AFCD food search in dots
Returns matching food entries and their Public Food Keys. Use it to find the right food description before retrieving a full nutrient profile.
Prompts to try with AFCD food search in dots
Copy an example into dots, or ask in your own words.
Every Monday at 9am: use AFCD food search to look this up and give me the result as a table.
Pull the latest numbers from AFCD food search and tell me what changed since last week.
Check AFCD food search and summarize what you find in three bullet points.
Pull the newest data from AFCD food search and give me the result as a table.
Check AFCD food search every morning and tell me only when something changed.
How to set up AFCD food search in dots
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send dots this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Create an API key
In the console, open API keys and create a key for your dot. Copy it.
- Send your dot this message
Your dot reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- Give your dot the key
When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run AFCD food search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "afcd-foodstandards-gov-au/foods/search_foods", "input": { "page": 1 } }'
Then paste one of the prompts above: dots finds AFCD food search on Spiral, shows the price and runs it.
AFCD food search providers and prices
Spiral runs AFCD food search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask dots for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | a number from 1 | 1 | 1-based page of the client-side paginated result (the API returns the whole list). |
| Page size | 1 to 200 | 50 | Rows per page (1-200). |
| Food group ID | a number from 1 | Restrict to one AFCD food group (see list_food_groups). | |
| Sub food group ID | a number from 1 | Restrict to one AFCD sub food group (see list_food_groups). |
Every API field of Australian Food Composition Database (AFCD, FSANZ) · Search foods is on its tool page: open its card above.
What can you do with AFCD food search in dots?
Keep an Australian food reference collection ready for editorial or product review. A scheduled agent can compare AFCD categories, definitions, and selected food records across retrievals and report the differences.
Compare breakfast cereals
Identify the ready-to-eat cereal category, list its foods, and resolve named cereals. Check nutrient definitions, rank the entries by iron, and inspect the selected food profiles and sampling notes.
Build a cheese reformulation reference
Find AFCD's cheese categories and enumerate the reference foods. Match named cheese types, check sodium definitions and units, then compare sodium values and inspect the underlying profiles.
Match recipe ingredients to reference foods
Map ingredients such as rolled oats, milk, and almonds to AFCD descriptions. Browse the relevant categories when names are ambiguous, then inspect preparation details and nutrient profiles before calculating recipe estimates.
Create an Australian food reference browser
Use the category hierarchy and category inventories for navigation, food search for lookup, nutrient definitions for explanations, nutrient comparisons for sorting, and individual profiles for the detail view.
Review changes to a food reference collection
Periodically compare retrieved categories, food inventories, nutrient definitions, rankings, and selected profiles with earlier observations. Produce a review queue when AFCD descriptions or values change.
Review the evidence behind category comparisons
List foods in a category, resolve ambiguous names, and inspect selected derivation and sampling notes. Explain which comparisons rely on analyzed foods and which involve calculated or borrowed data.
Compare food preparation descriptions
Find raw and cooked food entries, examine their descriptions, and compare selected nutrients using the documented definitions. Keep preparation differences explicit when presenting the results.
More on AFCD food search and dots
Overview
AFCD food search in other agents
Questions about AFCD food search in dots
Can dots use AFCD food search?
Yes. Add Spiral to dots as an MCP server, and dots can find and run AFCD food search like any built-in tool.
How much does AFCD food search cost in dots?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.
Do I need an Alexandria account to use AFCD food search in dots?
You need no Alexandria account. dots uses one Spiral API key for every tool, and Spiral runs AFCD food search on its own Alexandria account.
How long does it take to set up AFCD food search in dots?
About two minutes: create an API key, then send your dot this message, then give your dot the key.
Does dots wait while AFCD food search runs?
AFCD food search runs in the background. dots starts the run, checks on it and gives you the json when it's ready.
Which foods does AFCD cover?
AFCD covers 1,588 foods commonly available in Australia. Its coverage is a reference selection of Australian foods, rather than a complete inventory of products sold worldwide.
How many nutrients can AFCD describe?
AFCD reports up to 268 nutrients per food. The nutrient documentation explains the units, derivation, assumptions, and limitations used for those components.
What changed in the latest AFCD dataset?
Release 3 incorporated new analytical data for 118 foods and an updated vitamin D dataset. That update describes the dataset as a whole; individual sampling notes provide the evidence behind a particular food.
Are all AFCD values laboratory measurements?
Laboratory analysis is the primary source, but a food's derivation can also identify calculated, borrowed, or label-based data. Sampling notes can include how many samples were purchased and where and when they were purchased.
Are nutrient comparisons based on serving size?
AFCD's nutrient comparison tables report values per 100 g. A ranking therefore compares equal food weights, which can differ substantially from the amounts someone would serve.
Start using AFCD food search in dots
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into dots:
set up https://spiral.ai/SKILL.md


