[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [AFCD food search](https://spiral.ai/integrations/instinct/afcd-food-search)

# How to Use AFCD food search in Instinct

Returns matching food entries and their Public Food Keys. Use it to find the right food description before retrieving a full nutrient profile.

|  |  |
| --- | --- |
| Model | AFCD food search |
| Available through | Alexandria |
| Category | Industry Data |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with AFCD food search in Instinct

- 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 Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **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

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run AFCD food search**: One request; the result comes back by polling or a webhook.

```bash
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: Instinct finds AFCD food search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## AFCD food search tools and prices

- [Australian Food Composition Database (AFCD, FSANZ) · Search foods](https://spiral.ai/tools/alexandria/afcd-foodstandards-gov-au/foods/search_foods) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to … | 1 | 1-based page of the client-side paginated result (the API returns the whole list). |
| query |  | — | Case-insensitive substring matched against the food name and inclusions (e.g. 'vegemite', 'breakfast cereal'). Optional when a group or letter is given. |
| letter |  | — | Browse foods whose name starts with this letter (A-Z); switches to the per-letter endpoint. Pattern: ^[A-Za-z]$. |
| page_size | 1 to 200 | 50 | Rows per page (1-200). |
| food_group_id | 1 to … | — | Restrict to one AFCD food group (see list_food_groups). |
| sub_food_group_id | 1 to … | — | Restrict to one AFCD sub food group (see list_food_groups). |

## What can you do with AFCD food search in Instinct?

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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## AFCD food search in other agents

- [Amp](https://spiral.ai/integrations/amp/afcd-food-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/afcd-food-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/afcd-food-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/afcd-food-search)
- [Cline](https://spiral.ai/integrations/cline/afcd-food-search)
- [Codex](https://spiral.ai/integrations/codex/afcd-food-search)
- [Cursor](https://spiral.ai/integrations/cursor/afcd-food-search)
- [Devin](https://spiral.ai/integrations/devin/afcd-food-search)
- [dots](https://spiral.ai/integrations/dots/afcd-food-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/afcd-food-search)
- [Gemini](https://spiral.ai/integrations/gemini/afcd-food-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/afcd-food-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/afcd-food-search)
- [goose](https://spiral.ai/integrations/goose/afcd-food-search)
- [Grok](https://spiral.ai/integrations/grok/afcd-food-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/afcd-food-search)
- [Hermes](https://spiral.ai/integrations/hermes/afcd-food-search)
- [Manus](https://spiral.ai/integrations/manus/afcd-food-search)
- [Muse](https://spiral.ai/integrations/muse/afcd-food-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/afcd-food-search)
- [n8n](https://spiral.ai/integrations/n8n/afcd-food-search)
- [Notion](https://spiral.ai/integrations/notion/afcd-food-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/afcd-food-search)
- [opencode](https://spiral.ai/integrations/opencode/afcd-food-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/afcd-food-search)
- [Raycast](https://spiral.ai/integrations/raycast/afcd-food-search)
- [VS Code](https://spiral.ai/integrations/vscode/afcd-food-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/afcd-food-search)
- [Zapier](https://spiral.ai/integrations/zapier/afcd-food-search)

## More Instinct guides

- [AFCD food nutrient profile](https://spiral.ai/integrations/instinct/afcd-food-nutrient-profile)
- [AFCD foods by nutrient](https://spiral.ai/integrations/instinct/afcd-foods-by-nutrient)
- [AFCD food groups](https://spiral.ai/integrations/instinct/afcd-food-groups)
- [AFCD foods in a category](https://spiral.ai/integrations/instinct/afcd-foods-in-a-category)
- [fal Vignette](https://spiral.ai/integrations/instinct/fal-vignette)
- [AFCD nutrient definitions](https://spiral.ai/integrations/instinct/afcd-nutrient-definitions)

## Questions about AFCD food search in Instinct

**Can Instinct use AFCD food search?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run AFCD food search like any built-in tool.

**How much does AFCD food search cost in Instinct?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need an Alexandria account to use AFCD food search in Instinct?**

You need no Alexandria account. Instinct 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 Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while AFCD food search runs?**

AFCD food search runs in the background. Instinct 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.

