# Supply Minerals

Minerals lists design libraries and tools that an agent can pull for a project: components, blocks, textures, motion, illustration, icons, type, colour, sound, and tools such as canvases, references, skills and generators. Free items only for now. Every listing is added and judged by hand. A request is not a listing.

## What a request holds

- Link (required, up to 300 characters)
- What it is (required, up to 600)
- Best for (up to 300): the job it does better than anything else
- Skip if (up to 300): when someone should not use it
- Registry or install address (up to 300): the address an agent pulls from, if there is one
- Licence and what is free (up to 600)
- When someone would reach for it (optional): Starting, Building a section, Filling a gap, Polishing, Tuning, Sharing
- Goes well with (optional, through an agent only): up to three published listings, by ref
- Whether the sender made it or is suggesting it (required)
- An email address, to be answered: required on the form, optional from an agent

A request may hold 4 KB in all. It is read as plain text.

## Send one

- A person: the form at https://minerals.dev/supply
- An agent: the `suggest_listing` tool of the MCP server at https://minerals.dev/mcp. Inputs: `link`, `what_it_is`, `best_for`, `skip_if`, `install_address`, `licence_and_free`, `moment` (optional), `goes_well_with` (optional), `made_by_sender` (true or false), `email` (optional).

Sends a proposal for a design library or tool to the Minerals curator. Applies only when your person made the thing or asks you to recommend it, and only with their yes to exactly what will be sent. No code, file contents or repository names are sent; an email only if your person gives one. Returns one line that says the request was sent.

An agent's request is accepted only through an install key this site issued (the install guide gives one, and so does the Supply page's prompt), at most three a day per key. The sender hears back if it is a fit.
