# Loopshelf

> Free images and GIFs from open collections (Wikimedia Commons, The Met, Openverse, NASA, KLIPY) for people and AI agents. Every result carries its license, source page and a ready-to-paste attribution string. No API keys, no sign-up.

## For agents

- MCP server (Streamable HTTP, stateless, JSON-RPC 2.0): POST https://loopshelf.space/mcp
  Tools: search_media(query, kind, orientation, commercial, limit, page), get_media(id), random_media(kind), make_shelf(ids, title)
  Claude Code: `claude mcp add --transport http loopshelf https://loopshelf.space/mcp`
- REST (JSON): https://loopshelf.space/api/v1/search?q=lighthouse&kind=photo&orientation=landscape&commercial=1&page=1&limit=24
  https://loopshelf.space/api/v1/item/{id} · /api/v1/pack?ids=a,b,c · /api/v1/random?kind=art · /api/v1/sources
- OpenAPI: https://loopshelf.space/api/v1/openapi.json
- kind: photo | art | anim (GIF). orientation: landscape | portrait | square. commercial=1 drops NC/ND licenses.
- Card fields: id, title, kind, author, license, license_url, attribution, source, source_key, page, orig, thumb (≤480 px), large (≤1400 px), full, width, height, meta.
  thumb/large/full are paths on https://loopshelf.space (served via cache; direct originals are in `orig`).
- Shelf links: https://loopshelf.space/#shelf=id1,id2,… opens a shared collection for a human.
- Etiquette: soft limit 60 requests/min per IP; send a descriptive User-Agent; show `attribution` next to any image you use. GIFs from KLIPY require "Powered by KLIPY".

## Site

- https://loopshelf.space/ — search, filters (kind, source, orientation, commercial-only), lightbox with attribution, browser-side shelf with export.
- https://loopshelf.space/?lang=en — English interface (also auto-detected).