MemeStack MCP

by Ed-Relight

163 downloads
Not rated
GitHub

About

MemeStack MCP — hosted MCP server for searching an AI-tagged image gallery (memes, infographics, charts, visual explainers) ranked by Lightning zaps. 19 tools, 6 prompts, 3 resources. Every response includes ready-to-paste citation blocks (markdown / HTML / plain). Free, no auth:

Details

Author
Ed-Relight
Downloads
163
Categories
Search, Security, Knowledge Base, Other

- AI-tagged image gallery search
- Results ranked by Lightning zaps
- 19 tools, 6 prompts, 3 resources
- Ready-to-paste citation blocks (markdown, HTML, plain)
- Free to use, no authentication required

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MemeStack MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Point your MCP client to the hosted server at https://mcp.memestack.ai/mcp. No authentication or registration is required. The server exposes 19 tools, 6 prompts, and 3 resources. Responses include ready-to-paste citation blocks in markdown, HTML, or plain text.

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.

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

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.

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.

browse_by_category

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

list_categories

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

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

HostedModel Context Protocolserver forMemeStack— a visual search engine for memes, infographics, charts, screenshots, and diagrams. Find images by meaning, by the OCR text printed inside them, or by visual similarity. AI-captioned, Lightning-ranked. Public, no auth, no signup — reads are free with daily quotas, generation is paid per call.

Every list response returns citation blocks (markdown / HTML / plain) ready to paste with attribution. Image bytes are served fromhttps://api.memestack.ai/v1/images/{id}/{thumbnail|canonical|social-card}— directly embeddable.

This is a hosted server. No clone, no build, no local environment. Point any MCP-aware client at the endpoint.

claude mcp add --transport http memestack https://mcp.memestack.ai/mcp

Editclaude_desktop_config.json(%APPDATA%\Claude\on Windows,~/Library/Application Support/Claude/on macOS):

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

Recent Claude Desktop versions support direct HTTP MCP servers — if yours does, you can drop themcp-remotewrapper:

{ "mcpServers": { "memestack": { "url": "https://mcp.memestack.ai/mcp" } } }

Edit~/.cursor/mcp.json(or per-project.cursor/mcp.json):

{ "mcpServers": { "memestack": { "url": "https://mcp.memestack.ai/mcp" } } }

In~/.continue/config.json, add undermcpServers:

"memestack": { "url": "https://mcp.memestack.ai/mcp" }
curl -X POST https://mcp.memestack.ai/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Same endpoint forinitialize,tools/call,prompts/list,prompts/get,resources/list,resources/read. Protocol version:2025-06-18.

- 20 tools— 18 free reads (7 of them with a daily quota, then a few sats per call — seePricing & payments), 2 always paid (generate_meme,submit_image) — full catalog:docs/tools.md
- 6 prompts— pre-baked workflows (topic search, top zapped, cite a meme, find a meme for a vibe, research meme evolution, trending):
docs/prompts.md
- 3 resources— attribution guide, tag taxonomy, recent uploads feed:
docs/resources.md

- search_images— semantic + keyword merged
- search_text_in_image— OCR-only search (find screenshots of specific quotes/text)
- find_meme_for_text— vibe-to-meme matcher for writing & social
- reverse_image_search— phash-based "find this image" (accepts HTTPS ordata:URLs)
- find_similar/find_related— neighbors of a known image (visual phash / semantic embedding)
- browse_images,browse_by_tag,browse_by_category,list_categories
- popular_tags,tag_autocomplete,get_tag_profile
- get_image,get_user_profile,get_leaderboard,get_mutation_group

- cite_image— canonical markdown/HTML/plain attribution blocks for one or many image IDs

Paid (agent payment rails — pay per call, no account):

- generate_meme— AI image generation via Grok Imagine. 60 sats standard / 150 sats quality (or the USDC equivalent). Returns a hosted, auto-tagged, CDN-served image URL.
- submit_image— submit an image by URL into the moderation review queue. 100 sats/submission (or the USDC equivalent), always paid, no free quota. No refund on moderation rejection (duplicate/nsfw/spam/low-quality) — the fee is the anti-spam mechanism; accepted images await human review before publication.

Every list response includes acitations_combinedblock in three formats (markdown / HTML / plain) for the full set, plus a per-imagecitationon every individual image. Per-source rules differ — OWID images carry CC-BY 4.0 attribution to Our World in Data; Imgflip templates carry Imgflip attribution; direct uploads carry the uploader's display name and the MemeStack page URL — and Verified Creator uploads link the creator's name directly to their own website (mandatory attribution).

Readmemestack://attribution-guideonce per sessionfor the license model and per-source rules. Seedocs/resources.md.

Reads are free with generous daily quotas; generation is paid per call.No account, no API key— payment itself is the auth, over two rails:

- x402(USDC on Base) — standardx402/error+x402/payment_metaflow; works out of the box with the Cloudflare Agents SDK'swithX402Client. Heads-up: the SDK's defaultmaxPaymentValueis $0.10 — raise it to usegenerate_memequality mode (~$0.15) orsubmit_image(100 sats, which alone exceeds $0.10 whenever BTC trades above $100k).
- L402(Lightning sats) — on REST, standardWWW-Authenticate: L402 macaroon="…", invoice="…"challenge; retry withAuthorization: L402 <macaroon>:<preimage>. Over MCP, an experimentall402/payment_metaextension carries the same proof.

Paid REST twins (same prices, standard dual-header 402):POST api.memestack.ai/v1/agent/generate,POST api.memestack.ai/v1/agent/reverse-search, andPOST api.memestack.ai/v1/agent/submit— see theOpenAPI spec.

One payment delivers at most one result — if a call fails or times out mid-generation, retry with thesamepayment proof to resume; you are never charged twice for one payment.

submit_imagesubmissions land in the moderation review queue, not directly in the public gallery — there isno refund if moderation rejectsthe submission (duplicate/nsfw/spam/low-quality), since the review attempt itself is what the fee buys.

How MemeStack exposes itself to AI agents, beyond MCP:

The MCP server runs on Cloudflare Workers and proxies the public MemeStack REST API (api.memestack.ai). The server's source is part of the larger MemeStack codebase, which is not publicly mirrored at this time. This repository hosts the public-facing docs, install snippets, and tool catalog so directory submissions and integrators can link to a stable, browsable surface.

If you want to fork theprotocol behaviorand self-host a similar gallery, theREST APIis documented and a sufficient backend for any MCP-style wrapper.

TheDockerfilein this repo is a thin proxy — it usesmcp-remoteto bridge stdio MCP to the hosted HTTP endpoint, and exists only so MCP directories that require Dockerfile-based introspection (Glama, etc.) can validate the live tools/prompts/resources. End users should connect directly tomcp.memestack.ai/mcpper theInstallsection above; the Docker image holds no source.

MIT — covers the snippets and docs in this repo. The hosted MemeStack service is governed separately bymemestack.ai/terms. Image content carries per-source licenses, surfaced in each image'scitationblock.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search, audit, and install from 117K+ open-source AI agent skills & MCP servers — every result carries a security grade (SAFE/CAUTION/UNSAFE/UNAUDITED) and quality score checked BEFORE installing. Local cached index, works offline, no auth. Install: npx -y @agentskillshub/mcp

Search and compare 1,113 curated AI tools by pricing, rating, features and alternatives — hosted, no-auth Streamable HTTP.

BudgetFitter is a free UK deal discovery platform with a public MCP server. Search verified discount codes, look up brand intelligence, and navigate deals — no auth required.

Cinematography reference library. Search film stills from 5,489 films by lighting, lens character, shot size, colour and mood. Remote server, four tools, OAuth, free tier.

Read-only remote MCP server (no auth): live search of 100,000+ fine jewelry products with prices, availability, and store policies.

Search a curated board of customer-experience jobs where AI is part of the actual work. Filter by role pillar, region, and seniority; get featured roles, board stats, and CX+AI hiring Insights. Free, remote MCP, no auth — https://cx-jobs.lorikeet.tools/api/mcp

Verified job search — every listing confirmed live and accepting applicants within the last 72 hours; read-only, no auth required.

Search your Plex media library. Supports OAuth and static token authentication.

Search jobs, companies, candidates, and salaries from Armenia's #1 job platform - 12 tools, no auth required.

Provides threat intelligence queries for IPs, domains, files, URLs, and vulnerabilities using the ThreatBook API.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.