Skip to main content
Memelord MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH, API_KEY
  • Composio-managed OAuth available? No
  • Tools: 19
  • Triggers: 0
  • Slug: MEMELORD_MCP
  • Version: 00000000_00

Tools

Slug: MEMELORD_MCP_CHECK_VIDEO_STATUSCheck one video job from any video-producing tool. Returns status (pending / processing → completed | failed) and the MP4 download URL once complete. Free — poll every few seconds after a tool returns a job_id.

Input Parameters

string
required
job_id returned by a video tool (e.g. generate_video_meme, edit_video_meme, run_agent) or list_video_jobs
Slug: MEMELORD_MCP_CREATE_MEDIA_UPLOAD_URLStart a direct upload for a file too large to send inline (over 3 MB), typically a video. Returns an upload_url and upload_id: PUT the raw file bytes to upload_url with the returned Content-Type header (for example curl -X PUT -H “Content-Type: video/mp4” —data-binary @clip.mp4 “<upload_url>”), then call upload_media with upload_id to get the file’s url. The upload_url expires after 2 hours. Accepts image/jpeg, image/png, image/webp, video/mp4, video/quicktime, video/webm; images up to 10 MB, videos up to 100 MB. Free.

Input Parameters

integer
File size in bytes, to fail fast when it is over the limit
string
required
MIME type of the file: image/jpeg, image/png, image/webp, video/mp4, video/quicktime, video/webm
Slug: MEMELORD_MCP_EDIT_MEMEChange the text of an image meme you already generated. Pass the edit_handle from a generate_caption_meme / generate_ai_meme (or previous edit_meme) result together with a plain-language instruction; use the slot numbers from that result’s caption_slots as target_index to change just one box. Re-renders the image and returns a fresh URL, the updated caption_slots, and a new edit_handle (earlier handles stay valid, so you can branch from any version). Handles only work for the account that created them. Billed against your usage balance.

Input Parameters

string
required
edit_handle from the generate_caption_meme, generate_ai_meme, or edit_meme result being edited
string
required
What to change, e.g. “make the bottom text about JavaScript instead”
integer
slot number (from caption_slots) of the one text box to change. Omit to let the editor decide.
Slug: MEMELORD_MCP_EDIT_VIDEO_MEMERewrite the caption of a video meme and re-render it. Provide the template_id and the current caption from a previous generate_video_meme job plus a plain-language instruction. Starts a new render job — poll check_video_status for the MP4. Billed against your usage balance.

Input Parameters

string
required
Current caption text to edit
string
required
What to change about the caption
string
required
Video template asset id
string ("top" | "tiktok")
Force caption style: “top” (letterbox) or “tiktok” (centered overlay)
Slug: MEMELORD_MCP_GENERATE_AI_MEMEAI-remixed image memes: Jester picks a meme template (or uses template_id), AI-edits the picture itself to fit the joke — swapping subjects, adding objects, or painting in people and products from reference_image_urls — then captions it. Use generate_caption_meme instead when you only want new text on an unchanged classic template. Returns signed image URLs plus template_id, caption_slots, and an edit_handle for edit_meme. Billed against your usage balance.

Input Parameters

integer
Number of memes to generate (default 1, max 10)
string
required
Topic, idea, or joke premise for the meme
string ("trending" | "classic")
Restrict template selection to the trending pool or the classics pool (default: both)
string
Pin a specific image template asset id (from search_memes / get_trending_memes)
boolean
Allow NSFW-tagged templates (default true)
boolean
Allow political-tagged templates (default true)
array
Up to 3 public image URLs (a person, product, logo, or style) for the AI edit to paint into the template; upload local files with upload_media first
Slug: MEMELORD_MCP_GENERATE_CAPTION_MEMEClassic caption memes: Jester picks a real meme template from the library (or uses template_id), writes new text for its caption slots, and renders that text on the unchanged template image. The picture is never AI-edited or repainted — use generate_ai_meme for that. Returns signed image URLs plus template_id, caption_slots, and an edit_handle you can hand to edit_meme to change the wording. Use search_memes or get_trending_memes first if you want to pick the template yourself. Billed against your usage balance.

Input Parameters

integer
Number of memes to generate (default 1, max 10)
string
required
Topic, idea, or joke premise for the meme
string ("classic" | "trending")
Template pool: “classic” (default) draws from classic templates that have real caption slots; “trending” draws from current trending templates
string
Pin a specific image template asset id (from search_memes / get_trending_memes)
boolean
Allow NSFW-tagged templates (default true)
string ("tiktok" | "snapchat")
Style for single-caption renders (one caption on the image): “tiktok” (default, bold centered outlined text) or “snapchat” (translucent strip across the image). Both are drawn on top of the image. Multi-slot templates keep their own text boxes and ignore this.
boolean
Allow political-tagged templates (default true)
boolean
Ground the joke in live web search results about the topic (default true). Disable for faster, purely template-driven output.
Slug: MEMELORD_MCP_GENERATE_VIDEO_MEMEGenerate AI-captioned video memes from a topic. Jester picks video templates (or uses template_id), writes the caption text, and starts render jobs. Rendering is asynchronous: this returns job_ids immediately — poll check_video_status (or list_video_jobs) until status is “completed” to get the MP4 URL. Billed against your usage balance.

Input Parameters

integer
Number of video memes (default 1, max 5)
string
required
Topic or idea for the video meme
string ("trending" | "classic")
Restrict template selection to trending or classics
string
Pin a specific video template asset id (from search_memes with type “video”)
boolean
Allow NSFW-tagged templates (default true)
boolean
Allow political-tagged templates (default true)
string ("top" | "tiktok")
Force the caption-bar path: “top” (letterbox above the clip) or “tiktok” (centered overlay). Omit to let templates with saved compositions use them.
Slug: MEMELORD_MCP_GET_ACCOUNTReturn the authenticated Memelord account: user id, display name, email, usage balance (USD, rounded to cents), whether billable tools can run, where to add credits, and how this MCP session is authenticated (OAuth or API key). Call this to confirm who you are acting as or to check whether billable tools will succeed. Free.
Slug: MEMELORD_MCP_GET_MEME_TEMPLATEFetch one template asset by id: name, type (meme | video | sticker), media URL, description, tags, dimensions, and how many text slots its layout has. Use it to inspect a search result before generating with template_id. Free.

Input Parameters

string
required
Asset id from search_memes or get_trending_memes
Slug: MEMELORD_MCP_LIST_IMAGE_TOOLSCatalog of one-shot image tools you can run with run_image_tool: celebrity face swaps (Trump, Elon, Zuck, Vance, …), filters (Bust Down, Wojakify, GigaChad, Looksmaxxing, mugshot, Windows 95), and text-to-image generators (mascots, logos, Pokémon-style cards). Each entry lists its tool_id, whether it needs an image and/or a prompt, and any extra params. Free.

Input Parameters

string ("image-to-image" | "image-text-to-image" | "text-to-image")
Filter by input contract
Slug: MEMELORD_MCP_LIST_VIDEO_JOBSList your recent video jobs from every video tool, newest first, with status and MP4 URLs. Use it to recover job_ids after a reconnect or to find finished videos without polling each job. Statuses are as last recorded; call check_video_status on an in-progress job to refresh it. Free.

Input Parameters

integer
Max jobs to return (default 10, max 50)
string ("pending" | "processing" | "ready_to_process" | "rendering" | "completed" | "failed")
Only return jobs in this status
Slug: MEMELORD_MCP_LIST_VIDEO_MODELSList the pro AI video models this account can run — Kling 3.0, Kling O3, Seedance, Wan 3.0, Cinema Studio 4.0 (run with run_video_model) — and Genjutsu character transpose (run with run_genjutsu). Each entry lists required and optional inputs, rules, and params (options, ranges, defaults). Call this before run_video_model to pick a model and valid params. Free.
Slug: MEMELORD_MCP_RUN_AGENTHand a natural-language request to Jester, Memelord’s full meme agent — the same brain behind the Memelord chat. Jester decides what to do: search templates, caption a meme, remix a format, edit or generate an image, face-swap, make or caption a video, add text-to-speech or lipsync, convert to GIF, and more. Use this when a request does not map cleanly onto a specific tool (“turn this photo into a 3-panel meme about my cat”, “make a video meme with the drake format about Mondays”, “put my face on Elon”). Pass thread_id from a previous result to continue the conversation. Returns the assistant’s message plus any images; videos come back as job_ids to poll with check_video_status. Billed against your usage balance.

Input Parameters

integer
How many results you want (default 1, max 5)
string
required
What you want, in plain language
string
thread_id from a previous run_agent result to continue that conversation
array
Public image URLs to work with (photos to meme-ify, faces to swap, images to edit); upload local files with upload_media first
Slug: MEMELORD_MCP_RUN_GENJUTSUGenjutsu character transpose: put a person or character into an existing video clip while keeping its motion, choreography, camera, timing, and audio (“put me in this music video”, “swap the dancer for my character”). Needs the source clip (video_url, or video_job_id of a finished video on this account) and 1-8 photos of who to put in (character_image_urls). Both must be real media the user provided — never invent, guess, or substitute URLs. When the user gives you local photos or a local clip, upload each with upload_media first (clips over 3 MB via create_media_upload_url) and pass the returned urls. If anything is missing the call returns status “needs_input” listing everything still needed, with nothing started or charged: ask the user once, then call again. To generate new footage use run_video_model; for meme-template video clips use generate_video_meme. Returns a job_id; poll check_video_status until completed. Billed against your usage balance per second of the source clip, only once the job starts.

Input Parameters

string ("motion-transfer" | "object-swap")
motion-transfer (default, a person into the clip) or object-swap (swap an object / creature)
string
Short title for the saved video
string
Optional short direction in the user’s words (wardrobe, lighting)
string
Public URL of the source clip (4-30 s; longer is trimmed); upload_media returns one for a local file
string ("720p" | "480p")
Output resolution (default 720p)
string
job_id of a finished video on this account, instead of video_url
array
1-8 public photo URLs of the person / character, clear front-facing first; upload local photos with upload_media
Slug: MEMELORD_MCP_RUN_IMAGE_TOOLRun one specific image tool from list_image_tools by tool_id — e.g. “donald-trump-face-swapper” with a face photo, “bust-down-filter” on a portrait, or “mascot-generator” with a prompt. Provide image_url for image-to-image tools, prompt for text-to-image tools, and params for any extra inputs the tool lists. Returns the resulting image URL(s). Prefer this over run_agent when you already know exactly which tool you want. Billed against your usage balance.

Input Parameters

object
Extra tool-specific inputs keyed by the param key from list_image_tools
string
Text input (required by text-to-image tools)
string
required
tool_id from list_image_tools
string
Public URL of the input image (required by image tools); upload a local file with upload_media first
Slug: MEMELORD_MCP_RUN_VIDEO_MODELGenerate new AI video footage with one model from list_video_models: from a prompt alone, a start frame (image_url, optional end_image_url), or reference images / clips / audio. Use this for original footage (“a cinematic drone shot over Tokyo at night”, “animate this photo”). For a meme template turned into a captioned video clip use generate_video_meme; for still images use run_image_tool or generate_ai_meme; to put a person into an existing clip use run_genjutsu. Media must be public URLs the user provided — never invent or guess them; if the user gave you local files, upload them with upload_media and pass the returned url. Invalid requests come back as status “invalid_request” listing every problem, with nothing charged. Returns a job_id; poll check_video_status until completed (usually a few minutes). Billed against your usage balance per generated second, only once the job starts.

Input Parameters

integer
Seed for reproducibility (Wan only)
string
Short title for the saved video
string
required
Scene, action, camera, lighting, and motion
string
Model version / quality tier from list_video_models
integer
Length in seconds, within the model’s range
string ("kling" | "kling-o3" | "seedance" | "wan" | "cinema-studio")
required
model_id from list_video_models
string
Start / first-frame image (models with a start frame)
string
One of the model’s resolution options
string
One of the model’s aspect_ratio options
string
Last-frame image; requires image_url
boolean
Generate a soundtrack, where the model supports it
array
Reference audio (Audio 1, …)
array
Reference images (Image 1, Image 2, … in the prompt)
array
Reference clips for motion / camera (Video 1, …)
Slug: MEMELORD_MCP_SEARCH_MEMESSearch Memelord’s template library of memes, video clips, and stickers. Default method “semantic_context” matches what a meme MEANS or depicts (natural-language queries like “when the deploy works on the first try”). Use “fulltext” for exact names and proper nouns (“drake”, “spongebob”), “fuzzy” for misspellings, “semantic_combined” when visual identity matters, or “semantic_media” with media_url to find templates that look like a given image. Results come best match first and include ids you can pass as template_id to generate_caption_meme / generate_ai_meme / generate_video_meme / get_meme_template. Paging: each response has has_more and next_offset; to get the next page, repeat the exact same call (same query, method, filters, limit, min_score) with offset set to next_offset, and stop when has_more is false (next_offset is null). Pass ids you already have in exclude_ids only when starting a fresh search, not while paging, or the pages shift. Free.

Input Parameters

array
Only assets carrying any of these tags
string ("meme" | "video" | "sticker")
Only return this asset type. Use “video” to find templates for generate_video_meme.
integer
Max results (default 20, max 100)
string
Search text. Required unless method is “semantic_media”.
string ("semantic_context" | "semantic_combined" | "semantic_media" | "fulltext" | "fuzzy")
semantic_context (default) | semantic_combined | semantic_media | fulltext | fuzzy
integer
Results to skip (default 0, max 1000). Pass the previous response’s next_offset to fetch the next page.
string
Image/video URL to search by, for method “semantic_media”
number
Override the per-method relevance floor (0-1). Lower it when a specific query returns nothing.
array
Asset ids to skip (e.g. ones you already used)
boolean
Include NSFW-tagged assets (default true)
boolean
Only templates with a face that can be swapped
boolean
Only curator-approved templates
Slug: MEMELORD_MCP_UPLOAD_MEDIAUpload the user’s own photo or video into their Memelord Uploads and get back an https url to pass to generate_ai_meme reference_image_urls, run_image_tool image_url, run_agent image_urls, run_genjutsu character_image_urls / video_url, or run_video_model image and reference fields. Use it whenever the user gives you a local file or an attachment instead of a public link — never invent or guess media URLs. Send exactly one of: data_base64 (file bytes, up to 3 MB decoded), source_url (an https link to download), file (a host-provided file), or upload_id (after PUTting a larger file to the upload_url from create_media_upload_url). Accepts image/jpeg, image/png, image/webp, video/mp4, video/quicktime, video/webm; images up to 10 MB, videos up to 100 MB. Genjutsu uses 4-30 s of a source clip (longer clips are trimmed to 30 s) and clear, front-facing photos work best for character_image_urls. The url is valid for 7 days; calling upload_media again with the same upload_id returns a fresh one. Free, and limited to 50 uploads per hour.

Input Parameters

object
A file the host attached (ChatGPT passes { download_url, file_id })
string
Original file name, shown in the user’s Uploads
string
upload_id from create_media_upload_url after you PUT the bytes, or from an earlier upload_media result to get a fresh url
string
https URL to download the file from (a link the user shared)
string
File bytes as base64 or a data: URL, up to 3 MB decoded. Larger files: create_media_upload_url.
string
Optional MIME type (image/jpeg, image/png, image/webp, video/mp4, video/quicktime, video/webm); the file’s bytes decide