# MemeLord MCP > MemeLord generates viral memes and humorous visual content programmatically. Connect your AI agent to create shareable images instantly by adding custom text, resizing, cropping, or applying effects like 'deep-fry.' It gives you access to a massive library of classic meme templates and tracks the latest trending formats so you don't have to start from scratch. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** meme-generation, image-manipulation, content-creation, visual-marketing, template-library, automated-design ## Description You connect MemeLord to your AI client and start generating viral memes using plain conversation. You don't need Photoshop or any fancy design software; you just talk to it, and it builds the jokes for you. **Generating Visual Content:** When you want a brand-new visual joke, you use `generate_ai_meme`. This tool takes your AI prompts and merges them with templates to instantly create customizable meme images. For bigger projects, if you need an entire captioned video meme, you call `generate_video_meme`, and the server delivers that content asynchronously via a webhook. **Modifying Existing Memes:** If you've got a draft but it ain't quite right, you use `edit_meme_with_ai`. You just tell your agent what to change—like swapping out a caption or tweaking the style—and it modifies the existing meme using detailed natural language instructions. For technical touch-ups on any generated piece, you can manipulate image assets by resizing, cropping, or applying filters like 'deep-fry.' **Searching and Accessing Templates:** You never gotta start from scratch; MemeLord's got a massive catalog. You use `list_meme_templates` to see all the classic base meme templates available, pulled up by name and ID. To narrow your search, you check `list_meme_categories`, which groups major styles—you might find 'Programming' or 'Relationships' there. If you wanna dig into what's hot right now, run `list_trending_memes`; it shows the top viral formats and how many times they’ve been used in the last 24 hours. **Managing Your Assets:** You can keep all your best work safe by using `list_my_collections` to retrieve a list of saved meme collections for later use. You also get basic account info with `get_user_account_profile`, and you can see exactly what webhooks are active on your setup through `list_configured_webhooks`. **Monitoring Status:** Before you drop all that creative energy, you gotta check the numbers. Use `get_api_credit_usage` to see precisely how many API credits you've got left for content generation. You can also verify the connection health anytime by running `check_api_health`. For technical peace of mind, `get_api_version_info` retrieves all the nitty-gritty details about the current MemeLord API version and what features are available. This whole setup lets you get a full picture of your account status while giving you powerful tools to build content fast. You're running on an open standard, so connecting it to your preferred AI agent is simple. It’s pure power in your chat window. ## Tools ### check_api_health Verifies if the MemeLord API is currently connected and running correctly. ### generate_ai_meme Creates a brand new, customizable meme image based on AI prompts and selected templates. ### generate_video_meme Generates an entire captioned video meme, which is delivered asynchronously via webhook. ### edit_meme_with_ai Modifies an existing meme using detailed natural language instructions from your agent. ### get_user_account_profile Fetches basic information about the user account connected to the server. ### get_api_credit_usage Checks exactly how many API credits you have remaining for content generation. ### get_api_version_info Retrieves technical details about the current MemeLord API version and available features. ### list_meme_categories Lists major meme categories, such as Programming or Relationships, to help you narrow down templates. ### list_my_collections Retrieves a list of saved meme collections you have stored within your account for later use. ### list_meme_templates Provides a list of classic and available base meme templates by name and ID. ### list_trending_memes Shows the top, currently viral meme formats and how often they've been used in the last 24 hours. ### list_configured_webhooks Shows a list of all webhook endpoints that are currently active for your account. ## Prompt Examples **Prompt:** ``` Search for the 'Distracted Boyfriend' meme template. ``` **Response:** ``` Found templates matching 'Distracted Boyfriend': 1) Distracted Boyfriend (ID: 112126428, Text boxes: 3). 2) Distracted Girlfriend (ID: 142232). Template URL: https://img.memelord.com/112126428.jpg. ``` **Prompt:** ``` Generate a meme using the 'Drake' template. ``` **Response:** ``` Meme generated! ✅ Template: Drake Hotline Bling. Top text: 'Writing documentation'. Bottom text: 'Asking AI to write it'. URL: https://memelord.com/m/abc123xyz.jpg. Size: 800x800px. ``` **Prompt:** ``` Show the top 5 trending meme formats right now. ``` **Response:** ``` Trending Memes (24h): 1) 'Two Buttons' (Used 12K times today). 2) 'Change My Mind' (8K uses). 3) 'Expanding Brain' (6.5K uses). 4) 'Mocking Spongebob' (5K uses). 5) 'Disaster Girl' (4.2K uses). ``` ## Capabilities ### Generate Visual Content Creates a new meme image by combining AI-written text with selected templates. ### Modify Existing Memes Takes an existing meme and changes its content or style using natural language instructions. ### Search & Access Templates Browses the full catalog of classic and trending meme formats by name or category. ### Manipulate Image Assets Performs technical image edits like resizing, cropping, or applying filters to a generated meme. ### Monitor Account Status Checks your current API credit usage and verifies the connection health of the MemeLord server. ## Use Cases ### Need an instant reaction meme? The dev team needs a quick, funny visual for the weekly sync. They ask their agent: 'Generate a meme using the 'Two Buttons' template about our meeting length.' The agent calls `generate_ai_meme`, and they get an 800x800px image URL instantly. Problem solved in seconds. ### Running out of content ideas for Discord. The community manager realizes they need a fresh hit of engagement. They ask their agent to run `list_trending_memes`. Seeing 'Expanding Brain' is high, they then use the template ID found to generate several variation memes using `generate_ai_meme`. ### A client needs an old meme updated for a new topic. The marketing specialist finds a great, classic 'Distracted Boyfriend' image but the text is outdated. They use `edit_meme_with_ai`, instructing it to change the captions and update the whole concept without losing the original template structure. ### Building content automation into an app. The developer wants to build a bot that posts memes automatically. They use `list_meme_categories` to map out all available types, then implement calls to `generate_ai_meme` and check credit limits with `get_api_credit_usage`. ## Benefits - Stop manually searching for templates. Use `list_trending_memes` to see exactly what's viral today, ensuring your content feels timely and relevant. - You don't just generate memes; you can edit them with context. The `edit_meme_with_ai` tool lets you fine-tune an image after the first pass—no need to regenerate from scratch. - The full library is yours. Instead of guessing, use `list_meme_templates` or `list_meme_categories` to browse and select a perfect base format every time. - It handles scale. For high volume posting, rely on the direct generation tool, `generate_ai_meme`, which takes prompts and spits out usable assets fast. - Track your usage right away. Use `get_api_credit_usage` to avoid running into dead ends halfway through a large content batch run. ## How It Works The bottom line is that your AI client handles all the API calls; you just talk to it like normal. 1. Subscribe to the MemeLord server and enter your personal API Key into your AI client. 2. Tell your agent what you want. For example: 'Generate a meme using the 'Drake' template, with top text: Write documentation, bottom text: Ask for help.' 3. Your agent calls the necessary tools (like `generate_ai_meme`), and MemeLord returns the final image URL or file. ## Frequently Asked Questions **How do I check if MemeLord is working before running large batches?** Run the `check_api_health` tool. This quickly verifies that your API connection and credentials are good to go, saving you time if there's an outage. **Can I see what memes are currently popular using list_trending_memes?** Yes, running `list_trending_memes` shows the top viral formats and how many times they’ve been used in the last 24 hours. This helps you stay relevant. **What if I want to change text on an old meme?** Use `edit_meme_with_ai`. You feed it the existing meme and a new set of instructions, and it modifies the image without needing the original source files. **How do I get the list of all possible templates to choose from?** The `list_meme_templates` tool gives you a comprehensive list of classic meme formats available for use with the generation tools. **How do I check my usage limits using the `get_api_credit_usage` tool?** The tool reports your remaining credits instantly. Running `get_api_credit_usage` shows exactly how many credits you have left and when they reset. This prevents unexpected failures due to running out of quota. **What does the output mean when I run `generate_video_meme`?** Generating video memes is an asynchronous process, meaning it runs in the background. The tool doesn't return the finished file immediately; instead, it triggers a webhook to notify you when the captioned video is ready. **How do I view or manage my existing saved work using `list_my_collections`?** This function pulls up all your previously generated and manually saved meme collections. It lets you organize, browse, and retrieve assets without needing to regenerate them. **Before creating a meme, how can I see the available themes using `list_meme_categories`?** You run `list_meme_categories` to see all the domain types—like 'Sports' or 'Programming.' This helps narrow down your search and ensures you pick a template that fits your content goal. **Can I search for specific meme templates?** Yes. Search the library by keywords (e.g., 'Drake Hotline Bling', 'Distracted Boyfriend') to find template IDs. **How does MemeLord authentication work?** MemeLord uses Bearer authentication against `www.memelord.com/api/v1` using your API Key. **Can I add custom positioned text?** Yes. You can add standard top/bottom text or specify exact X/Y coordinates for text boxes.