Skip to content
MCP server

Lorem Picsum

Search CC0 photos and build exact-size placeholder image URLs over MCP

Answers · sign-in required (OAuth)

The server answered 3 hours ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Remotely
Access
Needs sign-in (OAuth)
Version
1.0.0
Listing updated
today

Similar MCP servers

About Lorem Picsum

Lorem Picsum is a freemium MCP server for web search and scraping. It runs as a hosted remote server, so there is nothing to install locally.

The README-style MCP entry and the connect page describe a remote server that lets a coding agent search the Picsum catalogue of CC0 photos and generate image links at chosen dimensions. The server is reached at a single streamable HTTP endpoint and authenticates through OAuth 2.1 with PKCE, so there is no API key to copy into a config file.

The exposed tools cover four jobs: searching photos by tag and category, looking up a photo's author and licence by ID, listing categories, and building a sized URL or HTML img tag with optional seed, grayscale, blur and WebP settings. Access is read-only, and the consent page shows which client is requesting it.

The page targets developers and agent users who need placeholder or sample imagery inside Claude Code, Codex or Grok Bot. Pricing for the underlying photo service is separate: the pricing page says custom sizes and effects are free without an account, while credit packs are sold for other usage.

Install

Run in a terminal

claude mcp add --transport http mcp https://picsum.org/mcp

Add to Settings → Connectors → Add custom connector

https://picsum.org/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://picsum.org/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://picsum.org/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://picsum.org/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://picsum.org/mcp

Enter a Name (for example "Lorem Picsum"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://picsum.org/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

search_photos
Search CC0 photos by tag and category. Results are paginated and include a ready-to-use URL.
get_photo
Look up a photo's author, description, tags, dimensions, source and licence by ID.
list_categories
List the category IDs and names in the same groups as on the homepage.
build_image_url
Build an exact-size URL and an HTML img tag. Supports seeds, categories, grayscale, blur and WebP.

What it does

Photo search by tag
Finds CC0 photos by tag and category with paginated results and ready-to-use URLs.
Exact-size image URLs
Builds random image links at specified dimensions, with an HTML img tag option.
Image effects
Supports seeds, grayscale, blur and WebP output in generated URLs.
OAuth sign-in
Connects through OAuth 2.1 with PKCE and dynamic client registration, with no key to copy.
Read-only access
The server can search and build URLs but cannot read or change account data or files.

Good for

  • Filling mockups or prototypes with sample photos from an agent chat
  • Generating sized placeholder img tags for web page layouts
  • Finding CC0 photos with author and licence details for reuse
  • Adding random food or nature images to a grid built by a coding agent

Pricing

Freemium

Custom sizes and effects are free; credit packs from $9.90 for other usage.

Prices change. Check picsum.org before you buy.

Lorem Picsum FAQ

Does it need an API key?

No. The connect page says clients sign in with OAuth and there is no key to copy.

Can the server change my account?

No. The page describes access as read-only and says the tool cannot modify the account.

Which agents are supported?

The page gives setup steps for Claude Code, Codex and Grok Bot, and says other MCP clients can connect if they support OAuth with dynamic client registration.

Are custom sizes free?

The pricing page says custom sizes, grayscale and blur are free without an account or API key.

Is Lorem Picsum free?

Lorem Picsum has a free plan, with paid plans for more usage or features.

How do I add Lorem Picsum to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://picsum.org/mcp

What are the best alternatives to Lorem Picsum?

The closest alternatives to Lorem Picsum are Pexels, Calotype, Commonkite: Free Image Search API, Creative Commons & CC0, OpenGraph.io MCP Server and ScreenshotMCP.

Where this comes from

  • Description: written from the project's website and its MCP Registry entry.
  • Status: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers