ai.memestack/mcp

Official19 tools

MemeStack

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

Captured live from the server via tools/list.

search_images

Search the MemeStack image gallery. Runs semantic AI and keyword matching in parallel and merges results. Returns images with captions, tags, zap stats, and URLs.

Parameters (7)

querystringrequired
Search query — combines semantic AI and keyword matching automatically. Alias: `q` (matches the REST API param name).
qstring
Alias for `query`. Provided so REST-API muscle memory (?q=...) works on the MCP tool too. If both are set, `query` wins.
tagstring
Filter results by a single tag slug (backward compat)
tagsstring
Filter results by multiple tag slugs (comma-separated, AND logic — e.g. "bitcoin,meme")
limitnumber
Results per page (1-50, default 10)
offsetnumber
Pagination offset (default 0)
sortstring
Sort order (default: relevance)

get_image

Get full metadata for a specific image by ID, including caption, alt text, tags, OCR text, zap stats, and URLs.

Parameters (1)

idstringrequired
Image UUID

find_similar

Find visually similar images using perceptual hash matching. Returns images that look alike.

Parameters (2)

idstringrequired
Source image UUID
limitnumber
Max results (1-20, default 10)

find_related

Find semantically related images using AI embedding similarity. Returns images with similar meaning/topic.

Parameters (2)

idstringrequired
Source image UUID
limitnumber
Max results (1-20, default 10)

browse_images

Browse and filter the image gallery without a search query. Useful for discovering content by tag, trending, or recent uploads.

Parameters (4)

tagstring
Filter by tag slug (e.g. "bitcoin", "meme")
sortstring
Sort order (default: newest)
limitnumber
Results per page (1-50, default 10)
offsetnumber
Pagination offset (default 0)

get_user_profile

Get a user's public profile including display name, stats, and avatar info.

Parameters (1)

identifierstringrequired
User public key (hex) or UUID

get_leaderboard

Get top-ranked images by zaps received, or top zappers by amount zapped, over a time period.

Parameters (2)

typestringrequired
Leaderboard type
periodstring
Time period (default: week)

browse_by_tag

Browse images for a specific tag. Returns the tag profile (description, stats) and optionally a paginated list of images tagged with it.

Parameters (3)

tagstringrequired
Tag slug (e.g. "bitcoin", "meme", "lightning")
limitnumber
Images per page (1-50, default 10). When provided, images are included in the response.
offsetnumber
Pagination offset (default 0)

browse_by_category

Get a category and its featured images. Categories group related tags (e.g. "charts", "memes", "lightning-network").

Parameters (1)

categorystringrequired
Category slug (e.g. "charts", "memes")

list_categories

List all available image categories. Use this to discover what categories exist before calling browse_by_category.

No parameters.

get_tag_profile

Get the profile for a tag (description, image count, total zaps, related tags) without fetching any images. Use browse_by_tag to also retrieve images.

Parameters (1)

tagstringrequired
Tag slug (e.g. "bitcoin", "meme")

get_mutation_group

Get all variants of a meme template tracked on MemeStack. Returns the dominant image plus every variant in the same mutation group, with citation blocks for each. Use this to research how a meme has evolved or to find variants of a known image.

Parameters (1)

image_idstringrequired
Image UUID

search_text_in_image

Search for images by the text written or printed in them (OCR). Different from regular search — only matches the text_in_image field, not captions or tags. Use this to find screenshots of specific quotes, signs, watermarks, or memes with specific embedded text.

Parameters (3)

querystringrequired
Text to search for in image OCR
limitnumber
Results per page (1-50, default 10)
offsetnumber
Pagination offset

find_meme_for_text

Find a meme that captures a vibe, idea, or concept. Returns ready-to-embed images with citation blocks. Use this when writing posts, articles, or social content and you need a meme to illustrate a point.

Parameters (2)

vibestringrequired
The vibe, topic, or idea you want a meme for
limitnumber
How many memes to return (1-20, default 5)

popular_tags

List the most-used tags on MemeStack by all-time usage count. (Time-period filtering is not yet supported — tag usage is currently counted across the full lifetime of each tag.)

Parameters (1)

limitnumber
How many tags to return (1-100, default 20)

tag_autocomplete

Suggest tag slugs matching a prefix. Use this to verify a tag exists before filtering by it, or to discover related tags. Prefix must be ≥ 2 characters.

Parameters (2)

prefixstringrequired
Tag prefix to autocomplete (≥ 2 characters), e.g. "bit" → "bitcoin".
limitnumber
Max suggestions (1-50, default 10)

cite_image

Generate canonical attribution blocks for one or more MemeStack images. Returns markdown, HTML, and plain-text citation strings ready to paste into your output, plus a combined block for citing multiple images at once.

Parameters (1)

image_idsarrayrequired
Up to 50 image UUIDs

reverse_image_search

Find MemeStack images that look visually similar to a given image. Accepts an HTTPS image URL or a `data:image/...;base64,...` URL for bytes pasted into agent context. Returns visually-similar matches via perceptual-hash (dHash) hamming distance, with citation blocks. Heavily rate-limited (10/min/IP) since each call hashes the input.

Parameters (2)

urlstringrequired
HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL
limitnumber
Max results (1-20, default 10)

submit_image

Submit an image to MemeStack. Currently in preview — see https://memestack.ai/mcp/agent-tier for access details.

Parameters (3)

image_urlstringrequired
Public HTTPS URL of the image to submit.
captionstring
Optional caption for the image.
tagsarray
Optional list of tag slugs to apply.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.memestack.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.