MemeStack

Official20 toolsLive

by memestack

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

ai.memestack/mcp — Model Context Protocol (MCP) Server

The ai.memestack/mcp MCP server provides tools to search and browse a curated gallery of memes, infographics, and visual content. It supports exploration of this visual catalog through MCP-integrated capabilities, with a toolset count of 20.

🛠️ Key Features

Search a curated gallery of memes, infographics, and visual content
Browse visual items from the curated collection
20 tools available in the server

🚀 Use Cases

Finding specific memes or infographic visuals in a curated gallery
Browsing visual content collections for reference or exploration

⚡ Developer Benefits

Access curated meme/infographic content via 20 MCP tools
Consistent integration through MCP for search and browsing workflows

⚠️ Limitations

Scope appears limited to the curated gallery of memes, infographics, and visual content (no other content types described)

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.

Parameters7

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

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query — combines semantic AI and keyword matching automatically. Alias: `q` (matches the REST API param name)."
    },
    "q": {
      "type": "string",
      "description": "Alias for `query`. Provided so REST-API muscle memory (?q=...) works on the MCP tool too. If both are set, `query` wins."
    },
    "tag": {
      "type": "string",
      "description": "Filter results by a single tag slug (backward compat)"
    },
    "tags": {
      "type": "string",
      "description": "Filter results by multiple tag slugs (comma-separated, AND logic — e.g. \"bitcoin,meme\")"
    },
    "limit": {
      "type": "number",
      "description": "Results per page (1-50, default 10)"
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset (default 0)"
    },
    "sort": {
      "type": "string",
      "enum": [
        "newest",
        "popular",
        "oldest"
      ],
      "description": "Sort order (default: relevance)"
    }
  },
  "required": [
    "query"
  ]
}

get_image

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

Parameters1

string

required

Image UUID

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Image UUID"
    }
  },
  "required": [
    "id"
  ]
}

find_similar

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

Parameters2

id	string	required	Source image UUID
limit	number	optional	Max results (1-20, default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Source image UUID"
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-20, default 10)"
    }
  },
  "required": [
    "id"
  ]
}

find_related

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

Parameters2

id	string	required	Source image UUID
limit	number	optional	Max results (1-20, default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Source image UUID"
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-20, default 10)"
    }
  },
  "required": [
    "id"
  ]
}

browse_images

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

Parameters4

tag	string	optional	Filter by tag slug (e.g. "bitcoin", "meme")
sort	string	optional	Sort order (default: newest)
limit	number	optional	Results per page (1-50, default 10)
offset	number	optional	Pagination offset (default 0)

Raw schema

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Filter by tag slug (e.g. \"bitcoin\", \"meme\")"
    },
    "sort": {
      "type": "string",
      "enum": [
        "newest",
        "popular",
        "oldest",
        "trending"
      ],
      "description": "Sort order (default: newest)"
    },
    "limit": {
      "type": "number",
      "description": "Results per page (1-50, default 10)"
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset (default 0)"
    }
  }
}

get_user_profile

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

Parameters1

identifier

string

required

User public key (hex) or UUID

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "User public key (hex) or UUID"
    }
  },
  "required": [
    "identifier"
  ]
}

get_leaderboard

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

Parameters2

type	string	required	Leaderboard type
period	string	optional	Time period (default: week)

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "images",
        "zappers"
      ],
      "description": "Leaderboard type"
    },
    "period": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month",
        "all"
      ],
      "description": "Time period (default: week)"
    }
  },
  "required": [
    "type"
  ]
}

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.

Parameters3

tag	string	required	Tag slug (e.g. "bitcoin", "meme", "lightning")
limit	number	optional	Images per page (1-50, default 10). When provided, images are included in the response.
offset	number	optional	Pagination offset (default 0)

Raw schema

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag slug (e.g. \"bitcoin\", \"meme\", \"lightning\")"
    },
    "limit": {
      "type": "number",
      "description": "Images per page (1-50, default 10). When provided, images are included in the response."
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset (default 0)"
    }
  },
  "required": [
    "tag"
  ]
}

browse_by_category

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

Parameters1

list_categories

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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.

Parameters1

tag

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag slug (e.g. \"bitcoin\", \"meme\")"
    }
  },
  "required": [
    "tag"
  ]
}

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.

Parameters1

image_id

string

required

Image UUID

Raw schema

{
  "type": "object",
  "properties": {
    "image_id": {
      "type": "string",
      "description": "Image UUID"
    }
  },
  "required": [
    "image_id"
  ]
}

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.

Parameters3

query	string	required	Text to search for in image OCR
limit	number	optional	Results per page (1-50, default 10)
offset	number	optional	Pagination offset

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Text to search for in image OCR"
    },
    "limit": {
      "type": "number",
      "description": "Results per page (1-50, default 10)"
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset"
    }
  },
  "required": [
    "query"
  ]
}

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.

Parameters2

vibe	string	required	The vibe, topic, or idea you want a meme for
limit	number	optional	How many memes to return (1-20, default 5)

Raw schema

{
  "type": "object",
  "properties": {
    "vibe": {
      "type": "string",
      "description": "The vibe, topic, or idea you want a meme for"
    },
    "limit": {
      "type": "number",
      "description": "How many memes to return (1-20, default 5)"
    }
  },
  "required": [
    "vibe"
  ]
}

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

Parameters1

limit

number

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "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.

Parameters2

prefix	string	required	Tag prefix to autocomplete (≥ 2 characters), e.g. "bit" → "bitcoin".
limit	number	optional	Max suggestions (1-50, default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "prefix": {
      "type": "string",
      "minLength": 2,
      "description": "Tag prefix to autocomplete (≥ 2 characters), e.g. \"bit\" → \"bitcoin\"."
    },
    "limit": {
      "type": "number",
      "description": "Max suggestions (1-50, default 10)"
    }
  },
  "required": [
    "prefix"
  ]
}

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.

Parameters1

image_ids

array

required

Up to 50 image UUIDs

Raw schema

{
  "type": "object",
  "properties": {
    "image_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 50 image UUIDs",
      "minItems": 1,
      "maxItems": 50
    }
  },
  "required": [
    "image_ids"
  ]
}

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.

Parameters2

url	string	required	HTTPS image URL, or data:image/(jpeg\|png\|webp);base64,... URL
limit	number	optional	Max results (1-20, default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL"
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-20, default 10)"
    }
  },
  "required": [
    "url"
  ]
}

submit_image

Submit an image to the MemeStack review queue. Paid tool — 100 sats (or USDC equivalent) per submission via the agent payment rails (x402/L402); no account or API key. IMPORTANT: there is NO refund if moderation rejects the submission (duplicate, nsfw/spam, low quality) — the fee is the anti-spam mechanism. Accepted images await human review before publication. Accepts an HTTPS image URL or a data:image/...;base64 URL (JPEG/PNG/WebP, max 8MB). Optional caption/tags/attribution are hints shown to the AI tagger and moderators — never published verbatim. If the call fails or times out, retry with the SAME payment proof to resume — one payment delivers at most one submission and is never charged twice (up to 10 delivery attempts per payment; a corrected image_url is allowed while no submission has been created yet). Note for x402 clients: 100 sats exceeds the agents-SDK default per-call cap of $0.10 whenever BTC trades above $100k — raise maxPaymentValue in withX402Client if payment is refused client-side.

Parameters4

image_url	string	required	HTTPS image URL, or data:image/(jpeg\|png\|webp);base64,... URL. Max 8MB.
caption	string	optional	Optional caption hint for the AI tagger (admin-visible, never published verbatim).
tags	array	optional	Optional tag hints (max 10).
attribution	string	optional	Optional credit line for the original creator/source (shown to moderators, not published).

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "description": "HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL. Max 8MB."
    },
    "caption": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional caption hint for the AI tagger (admin-visible, never published verbatim)."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 10,
      "description": "Optional tag hints (max 10)."
    },
    "attribution": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional credit line for the original creator/source (shown to moderators, not published)."
    }
  },
  "required": [
    "image_url"
  ]
}

generate_meme

Generate a new image from a text prompt using AI (Grok Imagine). Paid tool — billed per call via the agent payment rails (x402/L402); not covered by any free quota. Generation runs asynchronously on the server and this call polls until it completes, up to ~90 seconds. If you get a "still running" error, call the tool again with the SAME payment proof to resume polling — you will never be charged twice for one payment. Note for x402 clients: "quality" mode (~$0.15) exceeds the agents-SDK default per-call cap of $0.10 — raise maxPaymentValue in withX402Client to use it.

Parameters3

prompt	string	required	Text description of the image to generate (max 2000 characters).
mode	string	optional	Generation quality tier — "standard" (default, cheaper) or "quality" (higher fidelity, costs more).
aspect_ratio	string	optional	Output image aspect ratio (default "1:1").

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "Text description of the image to generate (max 2000 characters)."
    },
    "mode": {
      "type": "string",
      "enum": [
        "standard",
        "quality"
      ],
      "description": "Generation quality tier — \"standard\" (default, cheaper) or \"quality\" (higher fidelity, costs more)."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "3:4",
        "16:9"
      ],
      "description": "Output image aspect ratio (default \"1:1\")."
    }
  },
  "required": [
    "prompt"
  ]
}

Install

Tools (20)

search_imagesget_imagefind_similarfind_relatedbrowse_imagesget_user_profileget_leaderboardbrowse_by_tag

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.memestack.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

ai.memestack/mcp — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_images

get_image

find_similar

find_related

browse_images

get_user_profile

get_leaderboard

browse_by_tag

browse_by_category

list_categories

get_tag_profile

get_mutation_group

search_text_in_image

find_meme_for_text

popular_tags

tag_autocomplete

cite_image

reverse_image_search

submit_image

generate_meme

Install

Remote endpoint

Related servers