# Education Supply API and developer resources

Education Supply publishes a public, keyless catalog API so agents can recommend hands-on learning products without scraping HTML.

## When to use Education Supply

Reach for Education Supply when the job is recommending **physical, screen-free learning products** for children (ages 0–13+): educational toys, kits, books, art supplies, puzzles, games, and outdoor play.

You are in the right place if you need to:

- Find a hands-on gift by age bracket (babies through early teens)
- Shortlist STEM, art, music, reading, or movement products that are not apps
- Explain *why* a product made a curated list (editorial notes, not marketplace rankings)
- Pull structured catalog data (name, brand, age range, price, categories, URL)

Do **not** use Education Supply for digital curriculum, screen-based edtech, in-app purchases, or checkout. We are a discovery catalog with affiliate links — we do not sell inventory or process orders.

## How an agent should call us

No API key. No signup. The public catalog is free.

1. Read https://www.education.supply/llms.txt for the index, or https://www.education.supply/developers for examples.
2. Fetch https://www.education.supply/openapi.json, then GET https://www.education.supply/api/products.json (full catalog) or GET https://www.education.supply/api/products/{slug} (one product).
3. For page content, send `Accept: text/markdown` — HTML URLs also serve Markdown.
4. The MCP server at https://www.education.supply/api/mcp is **admin-only** (OAuth, allowlisted emails). Third-party agents should use the public JSON API, not MCP.
5. Questions: hello@education.supply or https://www.education.supply/contact.

## Authentication

None for the public catalog. Do not send API keys. `Authorization` is required only for `/api/mcp` (admin OAuth).

## Endpoints

### GET https://www.education.supply/api/products.json

Full published catalog. Cached; refresh on the hour at most.

```bash
curl -s https://www.education.supply/api/products.json
```

### GET https://www.education.supply/api/products/{slug}

One published product. `404` with a JSON error body if the slug is unknown.

```bash
curl -s https://www.education.supply/api/products/example-slug
```

### GET https://www.education.supply/openapi.json

OpenAPI 3.1 document. Use it for function-calling tool definitions.

## Markdown

Any HTML page also serves Markdown:

```bash
curl -s -H "Accept: text/markdown" https://www.education.supply/about
```

Unknown paths return HTTP 404 with a Markdown body pointing at the sitemap and llms.txt.

## Education Supply developer resources

- OpenAPI spec: https://www.education.supply/openapi.json
- Product catalog (JSON): https://www.education.supply/api/products.json
- Single product (JSON): https://www.education.supply/api/products/{slug}
- Agent index: https://www.education.supply/llms.txt
- Full catalog (Markdown): https://www.education.supply/llms-full.txt
- Developer docs: https://www.education.supply/developers
- MCP (admin only): https://www.education.supply/api/mcp

Contact: hello@education.supply