
memecub
Meme search & auto meme placement for AI agents. Remote MCP server, Agent Skill, CLI and REST API that let Claude Code, Cursor and Codex find reaction memes,…
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up memecub (git-clone project) into my current project. Found on https://claudeers.com/memecub Repo: https://github.com/liyupi/memecub Homepage/docs: https://memecub.com Detected install method: git-clone → git clone https://github.com/liyupi/memecub Category: skills. Platforms: cli, api, desktop, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
git clone https://github.com/liyupi/memecub
// compatibility
| Platforms | cli, api, desktop, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
memecub
Meme search and automatic meme placement for AI agents.
Give Claude Code, Cursor, Codex or Claude Desktop a meme library. Search reaction memes by feeling, or hand over an article and get it back with the right meme after the right sentence.
English · 简体中文

Real output of match_article. The model picks the moments; memecub finds the meme and inserts it as Markdown.
Why memecub
- It places memes, not just finds them.
match_articlereads a whole post, picks the sentences worth a meme and returns the article with images inserted. Your agent doesn't have to guess where they go. - Search by feeling. Ask for
facepalm,this is fine,it works on my machine,无语or摸鱼and get the reaction you meant, not a keyword lookalike. - English memes and Chinese 表情包 in one library. Drake, This Is Fine, Doge and Surprised Pikachu next to 熊猫头, 奶龙, 金馆长, 吗喽 and DeepSeek 鲸鱼娘. Chinese queries match whole phrases, so a character name returns that character.
- Zero install. A remote MCP server over Streamable HTTP, or a plain-curl Agent Skill. Searching works without a key.
- License-aware results. Every image says whether it is cleared for commercial use, links its source, and ships a ready Markdown snippet with the credit line when one is required. Ask for commercial-safe only and that's all you get.
- Safe defaults for agents. Memes whose captions contain swearing are left out of agent results unless you ask for them.
Quick start
The server is https://memecub.com/mcp. Pick your client:
Claude Code
claude mcp add --transport http memecub https://memecub.com/mcp
Cursor (~/.cursor/mcp.json)
{ "mcpServers": { "memecub": { "url": "https://memecub.com/mcp" } } }
VS Code (.vscode/mcp.json)
{ "servers": { "memecub": { "type": "http", "url": "https://memecub.com/mcp" } } }
Claude Desktop / claude.ai: Settings → Connectors → Add custom connector → https://memecub.com/mcp
Codex and any agent that reads skills: use the Agent Skill below.
Then just ask:
Add 3 memes to draft.md where they fit.
Find me a facepalm meme, commercial use only.
给这篇文章配几张表情包。
MCP tools
| Tool | What it does |
|---|---|
search_memes | Search by reaction, feeling or character. Filters: commercial_only, no_credit, kind (meme, gif, emoji, artwork, photo), min_size |
match_article | Read an article, pick the spots that deserve a meme, return the article with images inserted (needs a key) |
get_meme | Full details for one image: license, source, author, credit line, tags |
list_categories | Library categories |
You can try it without a key (20 searches a day per IP). Add Authorization: Bearer <key> (run npx memecub login, or create one at memecub.com/dashboard) to use your credits: a free account gets 1,000 a month, a search costs 1 and match_article costs 20 per image it places. Plans and credit packs: memecub.com/pricing.
Agent skill
skills/memecub/SKILL.md teaches an agent to place memes into writing with plain curl. No MCP, no dependencies, works in Claude Code, Codex and Cursor.
npx skills add liyupi/memecub
Or by hand:
# Claude Code: ~/.claude/skills Codex: ~/.codex/skills Cursor: ~/.cursor/skills
mkdir -p ~/.claude/skills/memecub
curl -s https://memecub.com/skill.md -o ~/.claude/skills/memecub/SKILL.md
REST API
curl -sG https://memecub.com/api/v1/search --data-urlencode "q=facepalm" -d limit=1
{
"data": [{
"title": "Facepalm",
"url": "https://gpic.code-nav.cn/memecub/public/12vw20qg0awo.jpg",
"page_url": "https://memecub.com/meme/12vw20qg0awo-facepalm",
"width": 679, "height": 600, "kind": "meme",
"license": { "code": "web", "commercial_use": false, "attribution_required": false },
"markdown": ""
}]
}
All endpoints and limits: memecub.com/developers.
CLI and JS client
memecub on npm, source in cli/. Node 18+.
npx memecub search "facepalm" --limit 5
npm i -g memecub # or install the `memecub` command
memecub search "facepalm" --limit 5
memecub search "mind blown" --commercial # only images cleared for commercial use
memecub match ./article.md --count 4 > article.with-memes.md
import { MemecubClient } from "memecub";
const client = new MemecubClient("https://memecub.com", process.env.MEMECUB_API_KEY);
const { data } = await client.search({ q: "mind blown", limit: 5, commercialOnly: true });
The website
Everything the agent sees is also browsable at memecub.com: search, topic pages, one-click copy and download, and the article tool in the browser.
| Home | Topic page | Agent setup |
|---|---|---|
![]() | ![]() | ![]() |
FAQ
Is it free? Browsing memecub.com is free, and so is light API use: 20 keyless searches a day, or 1,000 credits a month with a free account. Heavier use runs on plans and credit packs.
Can I use the images commercially? Check license.commercial_use on each result. Memes collected from the web are false: copyright belongs to their creators and the source link is kept. Openly licensed images (CC0, public domain, CC BY and similar) are true and come with the credit line when the license needs one. Pass commercial_only: true (MCP) or commercial=1 (REST) to get only those.
Is the website open source? No. This repository holds the integrations (MCP descriptor, Agent Skill, CLI and client). The site and its data pipeline are run by memecub.
Found a problem with an image? Use the report button on its page, or see memecub.com/dmca.
License
Code in this repository is MIT. Images are not covered by MIT; each result carries its own license.
If memecub saves your agent a trip to the image search, a ⭐ helps others find it.
// faq
What is memecub?
Meme search & auto meme placement for AI agents. Remote MCP server, Agent Skill, CLI and REST API that let Claude Code, Cursor and Codex find reaction memes, GIFs and Chinese 表情包 by feeling and insert them into articles. 表情包搜索 · AI 配图 · 斗图 MCP. It is open-source on GitHub.
Is memecub free to use?
memecub is open-source under the MIT license, so it is free to use.
What category does memecub belong to?
memecub is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/memecub)
// retro hit counter
[](https://claudeers.com/memecub)
// reviews
// guestbook
// related in Claude Skills
An agentic skills framework & software development methodology that works.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
💫 Toolkit to help you get started with Spec-Driven Development


