Skip to main content
Glama
free-image-library

free-image-library

by surendranb

Free Image Library — Free CC Images & Audio MCP 🖼️

CI License: MIT PyPI

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_note stating the actual obligation — CC BY-NC rows are loudly flagged non-commercial-only before your client ships them into a paid campaign.

  • Serendipity: image_roulette picks 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

find_images

Free CC image search with filters (license, aspect_ratio, size, extension) + attribution on every row

image_roulette

One random license-safe pick, honest about how it was chosen

find_audio

Free CC music / sound effects / field recordings from Openverse's audio index

skills_list / skill_read

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-library

Example

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 + e2e

Live tests hit the real Openverse API; they skip themselves when offline or rate-limited.

License

MIT

Available Tools

6 tools
check_for_updatesA
Read-onlyIdempotent

Check PyPI for newer versions of free-image-library and get upgrade instructions.

Inputs: no named parameters.

find_audioFind openly-licensed audioB
Read-onlyIdempotent

Search CC music, sound effects and field recordings from Openverse's audio index

Inputs: query (required), count, intent, license.

find_imagesFind openly-licensed imagesA
Read-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 rouletteA
Read-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 skillA
Read-onlyIdempotent

Fetch the full content of one skill by name (from skills_list)

Inputs: name (required).

skills_listList skillsA
Read-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

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Federated, 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.
      5
      176 npm
      15
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      License-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.
      7
      36 npm
      3
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables searching and retrieving images from Wikipedia Commons with detailed metadata including licenses and authors.
      2
      47 npm
      11
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for searching and retrieving Creative-Commons-licensed images and audio from Openverse. Enables AI agents to query open media content.
      459 npm
      MIT