# Imgflip

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Enable agents to create memes with Imgflip."
  author="Arcade"
  authType="API Key"
  versions={["0.1.0"]}
/>

<Badges repo="arcadeai/arcade_imgflip" />

The Arcade Imgflip MCP Server provides a pre-built set of tools for interacting with Imgflip. These tools make it easy to build agents and AI apps that can:

- Create memes
- Search for memes
- Get popular meme templates

## Available Tools

These tools are currently available in the Arcade Imgflip MCP Sever.

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "Imgflip.SearchMemes",
      "Search for meme templates by query (Premium feature)",
    ],
    ["Imgflip.GetPopularMemes", "Get popular meme templates from Imgflip"],
    ["Imgflip.CreateMeme", "Create a custom meme using an Imgflip template"],
  ]}
/>

<Callout>
  If you need to perform an action that's not listed here, you can [get in touch
  with us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

## Imgflip.SearchMemes

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool with User Authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/imgflip/search_memes_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/imgflip/search_memes_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Search for meme templates by query (Premium feature)

This tool searches through Imgflip's database of over 1 million meme templates
to find ones that match your search query. This is a Premium feature that
requires a paid Imgflip subscription.

**Parameters**

- `query` _(string, required)_ Search query to find meme templates. Be specific for better results.
- `include_nsfw` _(boolean, optional)_ Include not-safe-for-work memes in search results. Defaults to False.
- `limit` _(integer, optional)_ Maximum number of meme templates to return. Defaults to 20.

---

## Imgflip.GetPopularMemes

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool with User Authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/imgflip/get_popular_memes_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/imgflip/get_popular_memes_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Get popular meme templates from Imgflip

This tool retrieves a list of popular meme templates that can be used
to create custom memes. These templates are ordered by popularity
based on how many times they've been captioned.

**Parameters**

- `limit` _(integer, optional)_ Maximum number of meme templates to return. Defaults to 20.

---

## Imgflip.CreateMeme

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool with User Authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/imgflip/create_meme_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/imgflip/create_meme_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Create a custom meme using an Imgflip template

This tool creates a custom meme by adding your text to an existing
meme template. You can specify top and bottom text, choose fonts,
and control text sizing.

**Parameters**

- `template_id` _(string, required)_ The meme template ID to use for creation. You can get this from get_popular_memes.
- `top_text` _(string, optional)_ Text to display at the top of the meme. Leave empty if not needed.
- `bottom_text` _(string, optional)_ Text to display at the bottom of the meme. Leave empty if not needed.
- `font` _(Font, optional)_ Font family to use for the text. Defaults to IMPACT.
- `max_font_size` _(integer, optional)_ Maximum font size for the text. Defaults to 50.
- `no_watermark` _(boolean, optional)_ Remove the Imgflip watermark (Premium feature). Defaults to False.

<ToolFooter pipPackageName="arcade_imgflip" />