examples

pmndrs examples

The pmndrs MCP server serves the gallery at pmndrs.github.io/examples — 167 demos, each a small self-contained r3f app with its source. Most r3f questions are "how is this put together", and for those an example beats a reconstruction: it runs, it is whole, and someone already made every decision in it.

Reach for the docs (pmndrs:docs) for what an API takes; reach here for what a scene looks like when it works.

Always index first

1. ListMcpResourcesTool is not needed — read examples://index directly with ReadMcpResourceTool. It is the whole gallery, ~4.5k tokens, one line per demo.
2. mcp__pmndrs__get_example with the name from that line.

Read the index once per conversation. There is no per-tag or per-library variant, and no search tool — the index is the search.

Reading a line

{name} [({title}, when it is not just the name)] · {description} · +{libraries} · #{tags} · ~{size}

Everything after the name is dropped when the demo does not carry it:

aquarium · #transmission
arkanoid · Simple arkanoid implementation using cannon physics. · +cannon,zustand · #physics,game,audio
bounds-and-makedefault (Bounds and makeDefault) · #bounds
flow-shield · Interactive energy shield. · +postprocessing,leva · #shader · ~23k

+ lists what a demo uses on top of @react-three/fiber and @react-three/drei, which all of them use — so +rapier is a real signal and the absence of + is not.

Do not match on tags alone. They are freeform and unvalidated: expect typos (gtlf, clell-fracture, frosted-glas) and both spellings of one idea (contact shadows / contact-shadows). Scan names and descriptions too — 39 of the 167 have no description at all, so a name is sometimes the only thing that says what a demo is.

How many to open

Most demos are small — the median is ~1.4k tokens and nine tenths are under 4k. Three of them cost less than the index you have already read, so when two lines match equally well, open both. That is cheaper than opening one, finding it wrong and coming back, and it is often the answer outright: comparing caustics against diamond-refraction is what "transmission or refraction?" is asking for. Same when nothing does the whole job and the answer is one demo's scroll rig plus another's material.