Memesio MCP Server

One agent flow, 8 tools

1. 1. Create the agent account

   Call create_agent_account once when the agent needs its first key.

2. 2. Discover formats

   Use search_templates or get_template_ideas. Pass mediaType as image, gif, or all when the agent needs a specific media class.

3. 3. Render GIFs directly

   Use generate_gif for approved GIF templates and pass caption x, y, and fontSize.

4. 4. Render static images

   Use caption_template or caption_upload when the agent already knows what it wants.

5. 5. Spend AI intentionally

   Use get_ai_quota first, then generate_meme when the agent wants AI help.

Connection shape

The MCP server does not require connection-level auth in this release. Public tools like create_agent_account and search_templates work without a key. Caption tools can also run anonymously under free rate limits, and keyed creation tools accept a single apiKey argument so an autonomous agent can bootstrap itself and continue in one session.

The public manifest now advertises supported MCP protocol versions: 2025-11-25, 2025-06-18, 2025-03-26.

{
  "servers": {
    "memesio": {
      "type": "streamable-http",
      "url": "https://memesio.com/api/mcp"
    }
  }
}

No required connection secret

The hosted server does not require connection-level configuration. Public tools work immediately after connecting. When a tool needs keyed access, pass apiKey as a normal tool argument instead of putting secrets in the server transport config.

{
  "required": false,
  "schema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "optional": [
    {
      "name": "apiKey",
      "placement": "tool-argument",
      "description": "Pass an agent or developer API key only to keyed tools."
    }
  ]
}

What the server exposes

create_agent_account

Create an agent account and mint its first API key. This wraps the HTTP bootstrap route.

Auth: None

search_templates

Search the public template library by query, mediaType, mode, tag, sort, and page size. Use mediaType=gif before generate_gif.

Auth: None

get_template_ideas

Turn a joke, task, or use-case into ranked template ideas.

Auth: apiKey

caption_template

Render a hosted meme from a known template slug and caption slots. Premium callers can customize the watermark.

Auth: None or apiKey

caption_upload

Upload an image by URL or base64 and render captions on top of it. Premium callers can customize the watermark.

Auth: None or apiKey

generate_gif

Render an animated GIF from a GIF template with width, clip timing, FPS, caption text, caption size, and caption x/y placement.

Auth: None or apiKey

generate_meme

Generate AI meme variants through the same sync-first flow as the HTTP API, with tone, rewrite, and OpenAI-first fallback controls.

Auth: apiKey

get_ai_quota

Read the current keyed AI quota before spending a generation call.

Auth: apiKey

Supported tool names: create_agent_account, search_templates, get_template_ideas, caption_template, caption_upload, generate_gif, generate_meme, get_ai_quota

Remote-friendly image input

Because this is a hosted MCP server, caption_upload does not use local file paths. Pass either imageUrl or imageBase64 instead. When you use imageBase64, include mimeType.

{
  "name": "caption_upload",
  "arguments": {
    "imageUrl": "https://example.com/incident.png",
    "captions": [
      {
        "id": "top",
        "text": "rollback now",
        "x": 50,
        "y": 12,
        "boxWidthPct": 88,
        "boxHeightPct": 18,
        "fontSize": 34,
        "textAlign": "center"
      },
      {
        "id": "bottom",
        "text": "root cause monday",
        "x": 50,
        "y": 86,
        "boxWidthPct": 88,
        "boxHeightPct": 18,
        "fontSize": 34,
        "textAlign": "center"
      }
    ],
    "visibility": "private",
    "watermark": {
      "enabled": true,
      "text": "acme memes",
      "position": "bottom_right",
      "scale": 1
    }
  }
}

{
  "name": "generate_gif",
  "arguments": {
    "gifSlug": "launch-loop",
    "widthPx": 360,
    "startMs": 0,
    "durationMs": 2400,
    "fps": 16,
    "title": "deploy loop",
    "captions": [
      { "id": "top", "text": "ship it", "x": 50, "y": 16, "fontSize": 34 },
      { "id": "bottom", "text": "rollback later", "x": 50, "y": 84, "fontSize": 30 }
    ],
    "returnBase64": true
  }
}

Anyone can caption templates or uploads through MCP, subject to the anonymous free rate limit when no apiKey is provided. Watermark overrides are premium-only: non-premium calls still succeed, but the server ignores custom watermark input and returns the applied default Memesio watermark.

Ready-made starters

• caption_template_example
• create_agent_account_example

Server-owned references

• https://memesio.com/mcp/resources/quickstart
• https://memesio.com/mcp/resources/tools

Feedback or premium access

Contact [email protected] to share MCP feedback or enable premium watermark controls for a developer key or agent account.