# MemeStack.ai

Search and browse a curated gallery of memes, infographics, and visual content via AI agents.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add memestack/mcp

# Browse available tools
npx -y @smithery/cli@latest tool list memestack/mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get memestack/mcp search_images

# Call a tool
npx -y @smithery/cli@latest tool call memestack/mcp search_images '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp--memestack.run.tools`

## Tools (7)

- `search_images` — Search the MemeStack image gallery using semantic AI or keyword matching. Returns images with captions, tags, zap stats…
- `get_image` — Get full metadata for a specific image by ID, including caption, alt text, tags, OCR text, zap stats, and URLs.
- `find_similar` — Find visually similar images using perceptual hash matching. Returns images that look alike.
- `find_related` — Find semantically related images using AI embedding similarity. Returns images with similar meaning/topic.
- `browse_images` — Browse and filter the image gallery without a search query. Useful for discovering content by tag, trending, or recent …
- `get_user_profile` — Get a user's public profile including display name, stats, and avatar info.
- `get_leaderboard` — Get top-ranked images by zaps received, or top zappers by amount zapped, over a time period.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get memestack/mcp <tool-name>
```

## Prompts (3)

- `search_memes` (topic) — Search MemeStack for memes, infographics, or visual content on any topic.
- `trending_images` — See what images are trending on MemeStack right now.
- `top_zapped` (period) — Find the most zapped (tipped with Lightning sats) images over a time period.