free-image-library
Provides search over Openverse's index for openly licensed images and audio, with filters, random picks, and ready-to-paste attribution on every result.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@free-image-library Find a CC-licensed photo of a sunset for my blog header, with attribution."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Free Image Library — Free CC Images & Audio MCP 🖼️
Free images for any project: millions of openly-licensed, royalty-free Creative Commons images and audio (Flickr, Wikimedia, museums) — every result with ready-to-paste attribution. Zero API keys, zero configuration.
The visual sibling of the Free Music Library for the same content-creator audience: the agent finds the image AND the credit line in one call, so the attribution never gets lost between copy and paste.
Why this exists
Models suggest random stock images (license unknown, credit never written). This returns license-safe images with the credit the user MUST paste — built into the same result.
License intelligence, not just labels: every row carries a
credit_notestating the actual obligation — CC BY-NC rows are loudly flagged non-commercial-only before your client ships them into a paid campaign.Serendipity:
image_roulettepicks from deep in the result set, not the first hit everyone has seen.Built on Openverse — keyless (anonymous limits: 20 requests/min, 200/day, verified; a free registered key raises them via
OPENVERSE_API_KEY). A 5-minute TTL cache makes repeat searches free.
Related MCP server: webfetch
Tools
Tool | What it does |
| Free CC image search with filters (license, aspect_ratio, size, extension) + attribution on every row |
| One random license-safe pick, honest about how it was chosen |
| Free CC music / sound effects / field recordings from Openverse's audio index |
| Updatable playbooks: CC license briefs in plain language, error recovery |
Plus prompts: hero-image, license-safe-images.
Quickstart
# 1-Line Universal Installer (auto-configures Claude Desktop, Cursor, Claude Code, VS Code, ...)
curl -fsSL "https://free-image-library.builditwithai.xyz/install" | bash
# Or run directly via your preferred runtime:
uvx free-image-library
npx -y free-image-libraryExample
User: I need a hero image for my climate blog post
find_images(query="melting glacier", aspect_ratio="wide", count=3,
intent="hero image for a climate blog post")
→ images: [{
title: "Glacier calving", creator: "…", license: "CC BY 2.0",
image_url: "https://…", width: 2048, height: 1152,
attribution: "\"Glacier calving\" image by … (flickr), licensed CC BY 2.0 (…)",
credit_note: "Credit REQUIRED — paste the attribution verbatim." }]Telemetry & privacy
Anonymous usage telemetry (no PII, no queries, no paths) via the fleet
standard (schema v2, dual-endpoint fallback). Opt out any time:
FREE_IMAGE_LIBRARY_TELEMETRY=false or DO_NOT_TRACK=1.
Development
uv venv && uv pip install -e ".[dev]"
DO_NOT_TRACK=1 .venv/bin/python -m pytest tests/ -q # unit + live + e2eLive tests hit the real Openverse API; they skip themselves when offline or rate-limited.
License
MIT
Available Tools
6 toolscheck_for_updatesARead-onlyIdempotent
Check PyPI for newer versions of free-image-library and get upgrade instructions.
Inputs: no named parameters.
find_audioFind openly-licensed audioBRead-onlyIdempotent
Search CC music, sound effects and field recordings from Openverse's audio index
Inputs: query (required), count, intent, license.
find_imagesFind openly-licensed imagesARead-onlyIdempotent
Search millions of CC-licensed images (Flickr, Wikimedia, museums…); every result carries a ready-to-paste attribution
Inputs: query (required), size, count, intent, +3 more.
image_rouletteImage rouletteARead-only
Serendipity: a random openly-licensed image matching a topic — one pick, honest about how it was chosen
Inputs: seed, query, license.
skill_readRead a skillARead-onlyIdempotent
Fetch the full content of one skill by name (from skills_list)
Inputs: name (required).
skills_listList skillsARead-onlyIdempotent
List available skills (guidance playbooks) for using this server well — read one with skill_read
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a recognizable action: skill discovery (skills_list/skill_read), version check, image search, audio search, and random image. The only real overlap is find_images vs image_roulette, but the descriptions clearly separate deterministic search from a single serendipity pick. The skill_list/skill_read pair is complementary rather than ambiguous.
Mostly readable but the convention shifts: verb_noun (find_images, find_audio, check_for_updates), noun_verb (skill_read), noun_plural_verb (skills_list), and a bare noun (image_roulette). The find_* pair is consistent, but skill_read vs skills_list differ in both word order and plurality.
Six tools is a comfortable scope for a search-focused library. Half the surface is meta (skills_list, skill_read, check_for_updates), which is slightly heavy relative to the two core search tools, but nothing feels redundant.
Search across both images and audio plus attribution and a serendipity mode covers the core retrieval workflow for a CC content library. Gaps remain: no fetch-by-ID/URL to re-retrieve a specific asset, no license/source filtering, and audio lacks any equivalent of the roulette/detail affordances.
Maintenance
Related MCP Connectors
Openverse MCP — Creative-Commons-licensed image + audio search.
Find free-to-use stock photos by words, by image or by similarity; every result names its licence.
Search free music and sound effects (SFX), mostly CC0, with license terms and credit lines.
181Search, organize, and publish AI-generated images and video with provenance and lineage.
Related MCP Servers
- AlicenseAqualityBmaintenanceFederated, license-verified search across open-access museum collections — currently The Met, Cleveland, AIC, Wikimedia Commons, and Europeana, with more being added. Strict-default-deny rights gate accepts only CC0 / Public Domain Mark, returning reuse-safe artwork with citations in three styles.5176 npm15MIT
- AlicenseAqualityCmaintenanceLicense-first federated image search for AI agents and humans. Exposes MCP tools for concise, attribution-aware image discovery, license probing, and guarded downloads across open, platform, and editorial sources.736 npm3MIT
- AlicenseBqualityDmaintenanceEnables searching and retrieving images from Wikipedia Commons with detailed metadata including licenses and authors.247 npm11MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for searching and retrieving Creative-Commons-licensed images and audio from Openverse. Enables AI agents to query open media content.459 npmMIT