Memesio MCP Server

Model Context Protocol

Connect one hosted MCP server

Use the hosted MCP endpoint when an LLM agent wants the same creation flow as the HTTP API, but through one MCP server. The server is stateless, uses Streamable HTTP with JSON responses, and keeps the business logic in the existing HTTP routes.

Endpoint

https://memesio.com/api/mcp

Server v1.4.0 · MCP 2025-11-25 · tested 2026-07-07

ConnectHTTP API docsCode examples

Quickstart

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.

Transport

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"
    }
  }
}

Machine-readable manifest: /.well-known/mcp.json

Configuration

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."
    }
  ]
}

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.

generate_gif

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

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

Upload shape

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.

Prompts

Ready-made starters

• caption_template_example
• create_agent_account_example

Resources

Server-owned references

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

Premium

Feedback or premium access

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