// connections

Memelord

Generate image memes and captioned short-form video memes from a prompt, and rewrite an existing meme's text, on your Memelord account. Connect with a Memelord API key.

3 mcp tools5 operations
rest
https://api.superagnt.com/v1/connections/memelord plus the vendor's own path, with your superagnt_ API key as Authorization: Bearer.
mcp
Tools named connection_memelord_* on https://mcp.superagnt.com/mcp, served once the account is connected.
billing
Memelord bills your own account. Calls cost no superagnt_ data credits.
rate limit
5 requests a second, 120 a minute: the vendor's ceiling as the registry records it, for sizing bursts. Your plan's own limit is on Connections.

The Memelord connection lets an agent make memes. It generates image memes from a prompt, submits captioned video memes that render in the background, rewrites the text or caption of an existing meme from a plain-language instruction, and checks on video renders.

01

Setup

  1. Create an API key. In your Memelord developer settings at memelord.com, create an API key (mlord_live_...).
  2. Connect Memelord. In the superagnt app open Integrations, pick Memelord, paste the key and press Connect.

02

Things to know

  • Every meme spends credits on your Memelord account: 1 per image meme or image edit, 5 per video meme or video edit. A request for several memes (count, up to 10 images or 5 videos) costs that many times as much.
  • Generating and editing run without asking by default, so a deployed agent spends credits on its own. Set those tools to Ask if a person should approve each one (Permissions).
  • Image memes come back in the response as signed download URLs that expire after expires_in seconds. Save the file if you need it later.
  • include_nsfw defaults to true. Send false to keep NSFW templates out.
  • caption_style (top, tiktok or snapchat) switches image generation to caption-only mode. Do not send it when editing a template-mode meme: Memelord answers 400.
  • An image edit needs the template_id and template_data from the original generation response. A video edit needs the template_id and the current caption.

Video renders

  • A video meme or video edit returns a job_id per meme straight away and renders in the background.
  • Poll connection_memelord_video_renders_read with that id as jobId until status is completed (with an mp4Url) or failed (with an error).
  • Or pass webhookUrl, and Memelord posts each result there when it is done. On a new video meme, webhookSecret makes Memelord sign the payload with HMAC-SHA256.
  • A webhookUrl can be a superagnt_ inbound webhook endpoint, which starts an agent when the render finishes. Leave the endpoint's signature verification off: it does not check Memelord's signature.
  • The mp4Url expires 7 days after the render completes. Download any video you want to keep.

03

Examples

Generate image memes

two image memesbash
curl -X POST "https://api.superagnt.com/v1/connections/memelord/api/v1/ai-meme" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "developer fixing bugs at 3am", "count": 2, "include_nsfw": false}'

Start a video meme

submit a video renderbash
curl -X POST "https://api.superagnt.com/v1/connections/memelord/api/v1/ai-video-meme" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "when the deploy finally goes green", "force_caption_style": "tiktok"}'

Check the render

poll a render jobbash
curl "https://api.superagnt.com/v1/connections/memelord/api/video/render/remote?jobId=<job_id>" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY"
04// mcp tools

3 tools, one per resource and risk

MCP servers and agents on the grouped surface list Memelord as these tools. Each takes an action, and the ones that work across record types an object. Every operation also keeps its own per-operation name, in the next table, which works on every server. How grouping works: Grouped tools.

ToolRiskActions
connection_memelord_images_create

Generate image memes

Generate an image meme from a prompt, or edit the text of an existing one. Each costs 1 Memelord credit.

paid
generateedit
connection_memelord_videos_create

Generate video memes

Generate a video meme from a prompt, or edit the text of an existing one. Each costs 5 Memelord credits. Renders run in the background: poll them with connection_memelord_video_renders_read or pass webhookUrl.

paid
generateedit
connection_memelord_video_renders_read

Check Memelord video renders

Get the status of a video meme render job by jobId: pending, completed (with the mp4 URL, which expires after 7 days) or failed.

read
get
05// operations

All 5 operations

Each operation is a REST path under https://api.superagnt.com/v1/connections/memelord and an MCP tool. The per-operation tool name is the one permissions, approvals and usage records use.

OperationMCP tool
POST/api/v1/ai-meme

Generate AI image memes

connection_memelord_generateimagememegrouped: connection_memelord_images_create, action generate
POST/api/v1/ai-meme/edit

Edit an existing image meme

connection_memelord_editimagememegrouped: connection_memelord_images_create, action edit
POST/api/v1/ai-video-meme

Generate AI video memes (async)

connection_memelord_generatevideomemegrouped: connection_memelord_videos_create, action generate
POST/api/v1/ai-video-meme/edit

Edit a video meme caption (async)

connection_memelord_editvideomemegrouped: connection_memelord_videos_create, action edit
GET/api/video/render/remote

Poll a video render job

connection_memelord_getvideorenderjobgrouped: connection_memelord_video_renders_read, action get