Use MagicMeme from your agent

MagicMeme is a caption-on-template studio you can also drive from an AI agent. The agent does not invent a finished image URL. It looks up a catalog slug, writes captions that fit the boxes, then either shows a rendered still or hands you a studio link.

Two ways in. Keep them separate.

Make a meme. You add https://magicmeme.com/api/mcp in the agent app. The agent searches templates, generates caption variants, and calls render_meme_still when it should show pixels in chat. If a human should edit, it uses get_create_url instead.

Face swap. Humans sign in, buy credits, and generate at /tools/face-swap-meme. Agents can pay $0.50 per swap through Machine Payments Protocol: face_swap_meme with settlement=agentic, then POST the payment link, accept HTTP 402, retry with a Shared Payment Token plus the face image.

In this guide, a skill is a markdown file the agent should fetch and follow (llms.txt or .cursor/skills/magicmeme/SKILL.md). MCP is the live tool connection at POST /api/mcp. Captions are not a finished image. Render is.

What you can do from chat

• A first still without walking the studio. Connect MCP, name a situation, get a jpeg in the thread.
• A studio deep link when the human will edit. Same situation, get_create_url, they tap a caption and download PNG.
• A paid face swap without your OpenRouter key. Agent pays MPP; we generate with ours.

This is not a chatbot wrapped around the catalog. The agent you already use stays the UI. MagicMeme supplies templates, captions, pixels, and checkout.

A first prompt that works

For a still:

Fetch https://magicmeme.com/llms.txt and follow it. Situation: 9am standup on two hours of sleep. Pick a format, write captions, call render_meme_still, and show me the image.

For a human who will edit:

Same situation. Call get_create_url and give me the studio link. Do not invent a finished CDN URL.

For a paid face swap, after MCP is connected:

Call face_swap_meme with slug success-kid and settlement=agentic. Follow the paymentLink. Do not generate locally.

Give it those three things: what to fetch, the situation, and what "done" looks like.

What to explore next

• Get started with the MCP JSON and the first prompt.
• Auth if login or guest limits are confusing.
• Connect MCP for the hosted URL and tool list.
• Face swap & MPP if you only care about identity swaps.
• Agent skill if you want the dispatch file, not the tools.

Developer resources

Agents and integrations can discover MagicMeme by name through predictable, machine-readable surfaces:

• OpenAPI spec: https://magicmeme.com/openapi.json describes captions, catalog, render, face-swap, and agentic hooks. Also facts for humans in llms.txt.
• Hosted MCP: POST https://magicmeme.com/api/mcp (Streamable HTTP).
• Policies: Terms, Privacy, Refunds.