Stocky

@joelio

About Stocky

Find beautiful royalty-free stock images 📸

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "stocky": {
      "command": "python",
      "args": [
        "/path/to/stocky_mcp.py"
      ],
      "env": {
        "PEXELS_API_KEY": "your_pexels_key",
        "UNSPLASH_ACCESS_KEY": "your_unsplash_key"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Stocky?

Stocky is a Model Context Protocol (MCP) server that searches and retrieves royalty-free stock images from multiple providers (Pexels and Unsplash) simultaneously. It is built for Python developers who need to find stock photos with rich metadata inside MCP-enabled applications.

How to use Stocky?

Install Stocky by cloning its repository, installing dependencies with pip install -r requirements.txt, and adding Pexels and Unsplash API keys to a .env file. Run the server with python stocky_mcp.py, then configure your MCP client to launch the script with the required environment variables. Use the search_stock_images tool to find images and get_image_details to retrieve full metadata for a specific image.

Key features of Stocky

Multi-provider search across Pexels and Unsplash simultaneously.
Rich image metadata including dimensions, photographer info, and licensing.
Pagination support for browsing large result sets.
Graceful error handling for API failures.
Async performance with concurrent API calls.
Provider flexibility – search all providers or a specific one.

Use cases of Stocky

Quickly find royalty-free images for blog posts and marketing materials.
Populate a design mood board with diverse stock photos from multiple sources.
Automate image selection in content creation workflows by querying via MCP.
Compare image options from Pexels and Unsplash without switching platforms.
Integrate stock photo search into AI assistants or developer tools.

FAQ from Stocky

What runtime or dependencies does Stocky require?

Stocky requires Python 3.8 or newer and its dependencies are installed via pip install -r requirements.txt. It is MCP-compatible.

How do I get API keys for Stocky?

You need free API keys from Pexels (get at pexels.com/api) and Unsplash (sign up at unsplash.com/developers). Add them as PEXELS_API_KEY and UNSPLASH_ACCESS_KEY in your .env file or environment configuration.

Where do the images come from and where is my data stored?

All images are fetched in real time from Pexels and Unsplash via their APIs. Stocky does not store images or personal data locally; search results and metadata are returned directly to the client.

Are there any rate limits when using Stocky?

Yes. Pexels allows 200 requests per hour, Unsplash allows 50 requests per hour on the demo plan and 5000 per hour on the production plan.

How does Stocky handle authentication and transport?

Authentication is handled via environment variables containing API keys. Stocky runs as a local Python process over standard I/O (MCP stdio transport); no network authentication is needed beyond the API keys.

Frequently asked questions

What runtime or dependencies does Stocky require?

Stocky requires Python 3.8 or newer and its dependencies are installed via `pip install -r requirements.txt`. It is MCP-compatible.

How do I get API keys for Stocky?

You need free API keys from Pexels (get at pexels.com/api) and Unsplash (sign up at unsplash.com/developers). Add them as `PEXELS_API_KEY` and `UNSPLASH_ACCESS_KEY` in your `.env` file or environment configuration.

Where do the images come from and where is my data stored?

All images are fetched in real time from Pexels and Unsplash via their APIs. Stocky does not store images or personal data locally; search results and metadata are returned directly to the client.

Are there any rate limits when using Stocky?

Yes. Pexels allows 200 requests per hour, Unsplash allows 50 requests per hour on the demo plan and 5000 per hour on the production plan.

How does Stocky handle authentication and transport?

Comments

Basic information

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K