# Lorem Picsum

> Lorem Picsum is a freemium MCP server for web search and scraping. Search CC0 photos and build exact-size placeholder image URLs over MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://picsum.org/connect
- **MCP Registry name:** org.picsum/mcp
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-19

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://picsum.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://picsum.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Pexels](https://ai-powered.com/mcp/pexels): Pexels is an open-source MCP server for web search and scraping.
- [Calotype](https://ai-powered.com/mcp/calotype): Calotype is a freemium MCP server for web search and scraping.
- [Commonkite: Free Image Search API, Creative Commons & CC0](https://ai-powered.com/mcp/commonkite-free-image-search-api-creative-commons-and-cc0-3): Commonkite: Free Image Search API, Creative Commons & CC0 is a free MCP server for design and media.
- [OpenGraph.io MCP Server](https://ai-powered.com/mcp/opengraph-io-mcp-server): OpenGraph.io MCP Server is a freemium MCP server for web search and scraping.
- [ScreenshotMCP](https://ai-powered.com/mcp/screenshotmcp): ScreenshotMCP is a freemium MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/lorem-picsum
