Let your AI agent pick the memes

What it does

• Illustrate a whole article

  After you write a post, memes land right after the lines that deserve them.

• Find one meme

  “Find me a facepalm meme” gives you a few to pick from.

• Safe for client work

  Say it's commercial and it only uses images cleared for commercial use.

Claude CodeRecommended

1. 1

   Open a terminal. Mac: press ⌘ + Space, type “Terminal”, press Enter. Windows: press the Windows key, type “PowerShell”, press Enter.

2. 2

   Copy the command below, paste it into the terminal and press Enter.

   Mac / Linux

   mkdir -p ~/.claude/skills/memecub
   curl -o ~/.claude/skills/memecub/SKILL.md https://memecub.com/skill.md

   Copy

   Windows (PowerShell)

   mkdir -Force $HOME\.claude\skills\memecub
   curl.exe -o $HOME\.claude\skills\memecub\SKILL.md https://memecub.com/skill.md

   Copy
3. 3

   If it is already running, type /exit and start claude again.

4. 4

   Ask it: “Add 3 memes to this article”, then paste the article or tell it where the file is.

Codex

1. 1

   Open a terminal. Mac: press ⌘ + Space, type “Terminal”, press Enter. Windows: press the Windows key, type “PowerShell”, press Enter.

2. 2

   Copy the command below, paste it into the terminal and press Enter.

   Mac / Linux

   mkdir -p ~/.codex/skills/memecub
   curl -o ~/.codex/skills/memecub/SKILL.md https://memecub.com/skill.md

   Copy

   Windows (PowerShell)

   mkdir -Force $HOME\.codex\skills\memecub
   curl.exe -o $HOME\.codex\skills\memecub\SKILL.md https://memecub.com/skill.md

   Copy
3. 3

   If it is already running, quit and start codex again.

4. 4

   Ask it: “Add 3 memes to this article”, then paste the article or tell it where the file is.

Cursor

1. 1

   Open a terminal. Mac: press ⌘ + Space, type “Terminal”, press Enter. Windows: press the Windows key, type “PowerShell”, press Enter.

2. 2

   Copy the command below, paste it into the terminal and press Enter.

   Mac / Linux

   mkdir -p ~/.cursor/skills/memecub
   curl -o ~/.cursor/skills/memecub/SKILL.md https://memecub.com/skill.md

   Copy

   Windows (PowerShell)

   mkdir -Force $HOME\.cursor\skills\memecub
   curl.exe -o $HOME\.cursor\skills\memecub\SKILL.md https://memecub.com/skill.md

   Copy
3. 3

   Quit Cursor completely, reopen it and use the Agent chat.

4. 4

   Ask it: “Add 3 memes to this article”, then paste the article or tell it where the file is.

Claude Desktop / ChatGPT

These clients don't load skills, so connect memecub's MCP server instead; it works the same way. Server URL:

https://memecub.com/mcp

Claude Code and Cursor can use MCP too, though the skill is usually enough:

claude mcp add --transport http memecub https://memecub.com/mcp

Check it works

Ask your agent: “Use memecub to find a facepalm meme”

If it calls memecub and shows you images, you're set. If it says it doesn't know memecub, the install probably didn't run; check the file exists (Claude Code shown), then restart the agent.

ls ~/.claude/skills/memecub

Things to ask

• 「Add 4 memes to ./post.md and edit the file」
• 「This is for a client, only use images cleared for commercial use」
• 「Give me 5 Drake memes to choose from」
• 「The second one isn't funny enough, swap it」
• 「Find a meme for “Monday morning at work”」

API key (optional)

Works without a key (120 searches a day). With one you get 300 a day, your private uploads, and server-side article matching.

1. 1

   Sign in, open My library → API keys, click Create key and copy it.

2. 2

   Save it as an environment variable (replace mb_xxx with your key):

   Mac / Linux

   echo 'export MEMECUB_API_KEY=mb_xxx' >> ~/.zshrc && source ~/.zshrc

   Copy

   Windows (PowerShell)

   setx MEMECUB_API_KEY mb_xxx

   Copy
3. 3

   Restart the terminal and your agent; the skill picks the key up automatically.

REST API

For developers building their own integration. The skill and MCP server use the same endpoints.

GET  https://memecub.com/api/v1/search?q=drake&limit=10&min_size=150
     q, limit (≤50), offset, kind (meme|gif|emoji|artwork|photo|upload),
     category, commercial, no_credit, private, min_size,
     profanity (include swearing captions), sort (newest|popular)
GET  https://memecub.com/api/v1/memes/{id}
GET  https://memecub.com/api/v1/memes/{id}/download
GET  https://memecub.com/api/v1/categories
POST https://memecub.com/api/v1/match        {"text": "...", "count": 4, "commercial": false}
POST https://memecub.com/api/v1/uploads      multipart: file, title, tags, license, rights=true

Authorization: Bearer mb_your_key

Every result carries license (commercial use, credit required), an attribution line and a ready-to-paste markdown snippet. CLI: npx memecub search "drake"

FAQ