Memelord MCP

Check 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.

Start 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.

Change 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.

Rewrite 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.

AI-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.

Classic 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.

Generate 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.

Return 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.

Fetch 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.

What's trending right now: the most recent curated trending templates with a short cultural-context blurb explaining the format. Use it to pick timely templates for generate_caption_meme / generate_ai_meme / generate_video_meme, or to answer "what memes are hot this week". NSFW drops are never included. Free.

Catalog 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.

List 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.

List 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.

Hand 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.

Genjutsu 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.

Run 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.

Generate 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.

Search 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.

Upload 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.