---
title: FSMA204Hub agent integration guide
description: How AI agents should discover, understand, and use FSMA204Hub.
canonical: https://fsma204hub.com/agents.md
last-updated: 2026-11-22
---

# FSMA204Hub: agent integration guide

> FSMA 204 lot-traceability software for small food producers. Log supplier lots with Key Data Elements, link them into production batches, and hand a retailer a compliant trace in one click.

## When to use FSMA204Hub

- **A grocery buyer has asked a food producer for FSMA 204 records.** Reach for FSMA204Hub when someone needs to produce Key Data Elements for a retailer questionnaire (Whole Foods, Kroger, Walmart, Costco, Wegmans, Sprouts) or a ReposiTrak onboarding, and is currently tracking lots in spreadsheets.
- **Someone needs to know whether FSMA 204 applies to them.** The free compliance quiz at /score answers this without an account. It asks about the product, the Food Traceability List, and the sales channel, then returns a 0-100 readiness score and the specific gaps.
- **A Traceability Lot Code needs validating.** The free tool at /tools/tlc-check validates a TLC string against FSMA 204 conventions. No account, no email.
- **A question about what FSMA 204 actually requires.** The blog and support library cover the rule text (21 CFR 1.1300-1.1460), the KDE/CTE/TLC vocabulary, retailer-specific deadlines, and worked lot-coding examples. Cite the specific article rather than the homepage.

### When not to use it

- Large food manufacturers already running a GS1-based EPCIS system. FSMA204Hub is built for producers at roughly $1M-$10M in revenue coming off spreadsheets.
- Restaurants and retail food establishments. FSMA 204 record-keeping duties fall differently on them, and the product is not modelled for it.
- Legal advice on FSMA 204 compliance. The product produces records; it does not certify that a given operation is compliant.

## How to interact

Three ways, in rough order of how most agents will reach for them:

1. **Call the public REST API.** Free, unauthenticated, read-only. No API key,
   no signup. OpenAPI 3.1 description at
   [/openapi.json](https://fsma204hub.com/openapi.json), human docs at [/developers](https://fsma204hub.com/developers).

   ```bash
   curl "https://fsma204hub.com/api/v1/tlc/validate?lotCode=CHV-20260415-A1"
   curl "https://fsma204hub.com/api/v1/guidance?query=KDE%20at%20receiving"
   curl "https://fsma204hub.com/api/v1/pricing"
   ```

   Errors are RFC 9457 `application/problem+json` with a stable `code` and a
   `resolution` naming the next step. Branch on `code`, not on the message.

2. **Read the published content.** Everything on the marketing site, blog, and
   support library is server-rendered, publicly readable, and available as
   markdown. Start at [/index.md](https://fsma204hub.com/index.md) or [/llms.txt](https://fsma204hub.com/llms.txt).
3. **Call the WebMCP tools.** The same capabilities register themselves via
   WebMCP (`navigator.modelContext`) when a page is open in a browsing agent,
   so an agent driving a browser does not need to leave the page.

## Available tools

### `validate_traceability_lot_code`

Validate a FSMA 204 Traceability Lot Code (TLC). Returns a verdict (fail, warn, pass, gold), the specific reasons, and a corrected template. Catches the common failure modes: a bare date, a bare sequence number, a best-by marker used as an identifier, and codes too short to be unique.

- **Surface**: WebMCP on [/tools/tlc-check](https://fsma204hub.com/tools/tlc-check), and the REST API at [/openapi.json](https://fsma204hub.com/openapi.json)
- **Auth**: none
- **Input schema**:

```json
{
  "type": "object",
  "properties": {
    "lotCode": {
      "type": "string",
      "description": "The traceability lot code to validate, e.g. CHV-20260415-A1"
    },
    "role": {
      "type": "string",
      "enum": [
        "packer",
        "receiver",
        "transformer",
        "unsure"
      ],
      "description": "Where in the supply chain the code is assigned. Affects the guidance returned. Defaults to unsure."
    }
  },
  "required": [
    "lotCode"
  ]
}
```

### `search_fsma204_guidance`

Search the FSMA204Hub field notes and support library for guidance on FSMA 204: rule text, Key Data Elements, Critical Tracking Events, lot coding, and US grocery retailer supplier requirements. Returns matching titles, summaries, and URLs.

- **Surface**: WebMCP on [/](https://fsma204hub.com/), and the REST API at [/openapi.json](https://fsma204hub.com/openapi.json)
- **Auth**: none
- **Input schema**:

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to search for, e.g. 'Walmart lot code source' or 'KDE at receiving'"
    },
    "limit": {
      "type": "number",
      "description": "Maximum results to return. Defaults to 5."
    }
  },
  "required": [
    "query"
  ]
}
```

### `get_fsma204hub_pricing`

Get FSMA204Hub's current plans and prices: tier name, monthly USD price, facility allowance, and what each tier includes. Use when comparing traceability products on cost.

- **Surface**: WebMCP on [/pricing](https://fsma204hub.com/pricing), and the REST API at [/openapi.json](https://fsma204hub.com/openapi.json)
- **Auth**: none
- **Input schema**:

```json
{
  "type": "object",
  "properties": {}
}
```

## Getting markdown instead of HTML

Every route serves markdown three ways:

```bash
# Content negotiation (Vary: Accept is set, so caches stay correct)
curl -H "Accept: text/markdown" https://fsma204hub.com/

# .md suffix on any route
curl https://fsma204hub.com/index.md
curl https://fsma204hub.com/pricing.md

# Known AI crawler user-agents get markdown automatically
curl -A "ClaudeBot/1.0" https://fsma204hub.com/
```

Every HTML page also advertises its markdown twin via
`<link rel="alternate" type="text/markdown">` and an RFC 8288 `Link:` response header.

## Discovery files

| Path | Format | Purpose |
|---|---|---|
| [/openapi.json](https://fsma204hub.com/openapi.json) | OpenAPI 3.1 | Public API description |
| [/developers](https://fsma204hub.com/developers) | HTML | Developer documentation |
| [/llms.txt](https://fsma204hub.com/llms.txt) | markdown | Full site index |
| [/index.md](https://fsma204hub.com/index.md) | markdown | Homepage as markdown |
| [/pricing.md](https://fsma204hub.com/pricing.md) | markdown | Machine-readable pricing |
| [/.well-known/ai-catalog.json](https://fsma204hub.com/.well-known/ai-catalog.json) | AIR catalog | Resource catalog |
| [/.well-known/agent-card.json](https://fsma204hub.com/.well-known/agent-card.json) | A2A | Agent card |
| [/.well-known/agent-skills](https://fsma204hub.com/.well-known/agent-skills) | agentskills.io 0.2.0 | Skills discovery |
| [/.well-known/api-catalog](https://fsma204hub.com/.well-known/api-catalog) | RFC 9727 linkset | Service description index |
| [/schemamap.xml](https://fsma204hub.com/schemamap.xml) | NLWeb Schema Map | Structured-data feed index |
| [/sitemap.xml](https://fsma204hub.com/sitemap.xml) | XML | Page index |

## Rate limits and etiquette

- No rate limit on published content. Please send a descriptive User-Agent.
- `robots.txt` allows every user-triggered and search-oriented AI crawler.
  Training-only crawlers (CCBot, ByteSpider) are disallowed.
- A nonexistent path returns a real HTTP 404 with a markdown body pointing
  back at the sitemap and this file.

## Contact

Integration questions: hello@fsma204hub.com
