# MemeStack

> Searchable image gallery for memes, infographics, charts, and visual content.
> AI-tagged, Lightning-ranked. Find "that one image that explains X."

## What This Is

MemeStack is a search engine for visual content. Every image is automatically analyzed by AI to generate captions, tags, and OCR text. Images are ranked by Lightning Network zaps (Bitcoin micropayments). Use MemeStack when you need a visual that explains a concept, illustrates an argument, or is simply the right meme for the moment.

## API

Base URL: https://api.memestack.ai
OpenAPI spec: https://api.memestack.ai/openapi.json
Full API docs: https://memestack.ai/llms-full.txt
Developer docs: https://memestack.ai/developers

All read endpoints are public — no authentication required.

## Quick Start

Search for images about a topic:
  GET https://api.memestack.ai/v1/images/search?q=bitcoin+halving

Get image metadata (caption, tags, OCR text):
  GET https://api.memestack.ai/v1/images/{id}/meta

Get the image file:
  GET https://api.memestack.ai/v1/images/{id}/canonical

## Search

Search is unified — every query runs semantic similarity (vector embeddings) combined with keyword matching. No mode toggle needed. Best for any query, conceptual ("inflation explained") or literal ("21 million").

## Endpoints

### Search & Browse (no auth)
- GET /v1/images/search?q={query}                — unified search (semantic + keyword)
- GET /v1/images/search?tag={slug}               — browse by single tag
- GET /v1/images/search?tags={slug1},{slug2}     — filter by multiple tags (AND)
- GET /v1/images/search?sort_by=zap_total_sats&sort_order=desc — browse by popularity
- GET /v1/images/search?sort_by=trending&sort_order=desc  — browse by trending score

### Image Details (no auth)
- GET /v1/images/{id}/meta       — full metadata (caption, tags, alt text, OCR text, dimensions, zap stats)
- GET /v1/images/{id}/canonical  — web-optimized image (max 2500px, original format)
- GET /v1/images/{id}/thumbnail  — thumbnail (max 768px)
- GET /v1/images/{id}/similar    — perceptually similar images (phash)
- GET /v1/images/{id}/related    — semantically related images (embedding cosine similarity)

### Users (no auth)
- GET /v1/users/{pubkey}         — user profile and stats
- GET /v1/users/{pubkey}/images  — user's images (paginated)
- GET /v1/users/{pubkey}/tags    — user's tags by frequency

### Leaderboard (no auth)
- GET /v1/leaderboard/images?period=week   — top zapped images (day/week/month/all)
- GET /v1/leaderboard/zappers?period=week  — top zappers (day/week/month/all)

## Content Categories

memes, infographics, charts, screenshots, diagrams, photos, artwork, logos

## Website

https://memestack.ai
Deep link to search: https://memestack.ai/?q={query}

## MCP Server (Model Context Protocol)

MemeStack provides a remote MCP server for AI agents:
  https://mcp.memestack.ai/mcp

Available tools:
  - search_images: Unified semantic + keyword image search
  - get_image: Full metadata for one image
  - find_similar: Visually similar images (perceptual hash)
  - find_related: Semantically related images (AI embeddings)
  - browse_images: Browse by tag, trending, or recent
  - get_user_profile: User profile and stats
  - get_leaderboard: Top images or top zappers by period

Claude Desktop / Claude Code config:
  {"mcpServers": {"memestack": {"type": "url", "url": "https://mcp.memestack.ai/mcp"}}}

Fallback for clients without remote MCP support:
  {"mcpServers": {"memestack": {"command": "npx", "args": ["mcp-remote", "https://mcp.memestack.ai/mcp"]}}}