Openverse

liveMediaArt

Creative-Commons-licensed image + audio search (Wikimedia, Flickr, museums). Keyless (anonymous rate-limit).

6tools
0msauth
free tier50 calls/day

Tools

search_imagesrequired: query

"Find royalty-free / Creative Commons / public-domain images of [X]" / "CC images of [Y]" / "free-to-use pictures of [topic]" / "stock photos of [subject]" — search Creative-Commons-licensed images ac

Parameters
NameTypeDescription
queryreqstring—
licenseoptstring—
license_typeoptstring—
sizeoptstring—
sourceoptstring—
pageoptnumber—
page_sizeoptnumber—
▶Try it
search_audiorequired: query

"Find royalty-free / Creative Commons / public-domain audio for [X]" / "free music / sound effects of [Y]" / "CC-licensed audio" — search Creative-Commons-licensed audio (music, sound effects, podcast

Parameters
NameTypeDescription
queryreqstring—
licenseoptstring—
license_typeoptstring—
sourceoptstring—
pageoptnumber—
page_sizeoptnumber—
▶Try it
get_imagerequired: id

Fetch full metadata for a single Openverse image record by UUID (license, attribution, source, dimensions). Use after `search_images` for licensing details.

Parameters
NameTypeDescription
idreqstring—
▶Try it
get_audiorequired: id

Fetch full metadata for a single Openverse audio record by UUID (license, duration, attribution, source). Use after `search_audio` for licensing details.

Parameters
NameTypeDescription
idreqstring—
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/openverse/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/openverse/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_images","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_images", {"query":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("creative-commons-licensed image + audio search (wikimedia, flickr, museums)");