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

### Tags & Categories (no auth)
- GET /v1/tag-pages              — all categories with top tags, descriptions, image counts
- GET /v1/tag-pages/{slug}       — single category detail with top images

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

cryptocurrency, economics, finance, data visualization, geography, politics, technology, memes, science, history, health, environment, education, culture, social media, art

## Content Taxonomy

### Cryptocurrency (573 images)
Bitcoin, altcoins, blockchain, wallets, mining, and crypto markets
Top tags: Bitcoin, River Financial, Cryptocurrency, Institutional Adoption, Decentralization, Lightning, Wallet, Satoshi
Browse: https://memestack.ai/categories/cryptocurrency

### Economics (7,952 images)
Markets, trade, GDP, inflation, monetary policy, and economic systems
Top tags: Chart, History, Economics, News, Historical Data, Choropleth Map, 2023, Informational
Browse: https://memestack.ai/categories/economics

### Finance (1,778 images)
Banking, investing, stocks, personal finance, and financial markets
Top tags: Economic Data, Bitcoin, Financial Data, River Financial, Investment, Cryptocurrency, Finance, Government Spending
Browse: https://memestack.ai/categories/finance

### Data Visualization (7,625 images)
Charts, graphs, maps, infographics, and statistical displays
Top tags: Chart, Statistics, Infographic, Our World in Data, Diagram, Public Health, News, Time Series
Browse: https://memestack.ai/categories/data-visualization

### Geography (4,822 images)
Maps, countries, regions, continents, and geospatial data
Top tags: World Map, Global, Geography, Global Data, Country, Choropleth Map, Country Data, Population
Browse: https://memestack.ai/categories/geography

### Politics (8,494 images)
Government, elections, policy, geopolitics, and political commentary
Top tags: Chart, History, News, Demographics, Social Commentary, Choropleth Map, Artwork, Education
Browse: https://memestack.ai/categories/politics

### Technology (1,158 images)
Software, hardware, AI, internet, and tech industry
Top tags: Technology, Artificial Intelligence, Gaming, Privacy, Future, Elon Musk, Gaming Culture, Prediction
Browse: https://memestack.ai/categories/technology

### Memes (4,976 images)
Internet memes, reaction images, humor, satire, and viral content
Top tags: Meme, Personalities, Social Commentary, Satire, Green, Artwork, Internet Culture, Reaction
Browse: https://memestack.ai/categories/memes

### Science (5,340 images)
Research, biology, physics, chemistry, and scientific discoveries
Top tags: Research, Education, Educational, Informational, Development, Social Science, Epidemiology, Data Analysis
Browse: https://memestack.ai/categories/science

### History (6,087 images)
Historical events, timelines, eras, and historical data
Top tags: History, Historical Data, Education, Educational, Development, United Kingdom, Academic, Decline
Browse: https://memestack.ai/categories/history

### Health (4,617 images)
Medicine, public health, epidemiology, and wellness
Top tags: Public Health, Global Health, 2023, Trend, Epidemiology, Data Analysis, Population, United States
Browse: https://memestack.ai/categories/health

### Environment (2,794 images)
Climate, energy, pollution, conservation, and sustainability
Top tags: Environmental Data, Africa, Climate Change, Sustainability, Asia, Agriculture, Environmental Impact, Environmental
Browse: https://memestack.ai/categories/environment

### Education (5,872 images)
Learning, literacy, schools, and educational resources
Top tags: Choropleth Map, Education, Educational, Comparison, Informational, Development, Social Science, Quantitative Data
Browse: https://memestack.ai/categories/education

### Culture (8,373 images)
Society, demographics, religion, language, and cultural trends
Top tags: Chart, Demographics, Social Commentary, Artwork, Internet Culture, Humor, Sociology, Anonymous
Browse: https://memestack.ai/categories/culture

### Social Media (3,903 images)
Platforms, viral content, online communities, and digital culture
Top tags: Meme, Screenshot, Internet Culture, Reaction, Humor, Political Commentary, Anonymous, Twitter
Browse: https://memestack.ai/categories/social-media

### Art (1,651 images)
Visual art, design, illustration, and creative works
Top tags: Artwork, Cartoon, Black And White, Antisemitism, Conceptual, Contrast, Glasses, White
Browse: https://memestack.ai/categories/art
## Direct Links

- All tags: https://memestack.ai/tags
- All categories: https://memestack.ai/categories
- Search: https://memestack.ai/?q={query}
- For creators (publish + get verified): https://memestack.ai/creators
- MCP server: https://mcp.memestack.ai/mcp

## Recommended Tools

Hardware wallets, privacy tools, and the exchange the MemeStack operator personally uses and recommends (affiliate links, disclosed on the page):
- Browse: https://memestack.ai/gear
- Self-custody hardware wallets: Trezor, Ledger, BitBox
- Privacy & security: Proton VPN
- Buy Bitcoin: Kraken

## 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
  - browse_by_tag: Browse all images with a specific tag (paginated)
  - browse_by_category: Browse all images in a category with top sub-tags
  - list_categories: List all content categories with descriptions and image counts
  - get_tag_profile: Full profile for a tag — description, top images, related tags
  - 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"]}}}