MCP & Skills

Connect Memelord to your AI tools via MCP (Model Context Protocol). Search templates, generate and edit image and video memes, run one-shot image tools, or hand a whole request to Jester — directly from Claude, ChatGPT, Cursor, Claude Code, Windsurf, and any other MCP client.

The tool surface mirrors what Jester can do in the Memelord app today: every tool returns results as URLs for your client to use or download. There is no folder or collection storage over MCP. To use your own photos or clips, upload_media saves them to your Uploads and returns a URL the other tools accept.

MCP Server

The Memelord MCP server is hosted at https://www.memelord.com/api/mcp (Streamable HTTP). No installation needed. Two ways to authenticate:

• Sign in with your browser (OAuth) — the default for desktop and web clients. Add the URL, click Connect, approve the request on the consent screen, done.
• API key— for scripts, CI, and headless agents where nobody can click through a login.

Option A: Connect with your browser (recommended)

Add the server URL with no headers. Your client discovers Memelord's authorization server automatically, opens a browser window, and asks you to sign in to Memelord and approve the connection. Tokens refresh themselves; disconnect anytime from Settings → Developer → Connected Apps.

Claude Code

claude mcp add --transport http memelord https://www.memelord.com/api/mcp

Claude (desktop / web)

Settings → Connectors → Add custom connector → paste https://www.memelord.com/api/mcp → Connect.

ChatGPT

Settings → Connectors → Create (Developer mode) → MCP Server URL https://www.memelord.com/api/mcp → Authentication: OAuth.

Cursor

Add to .cursor/mcp.json (or Settings → MCP → Add), then click the login prompt Cursor shows:

{
  "mcpServers": {
    "memelord": {
      "url": "https://www.memelord.com/api/mcp"
    }
  }
}

Option B: API key (scripts and headless agents)

Create a key in Developer Settings (it starts with mlord_live_) and send it as a bearer token. Everything else is identical.

{
  "mcpServers": {
    "memelord": {
      "type": "http",
      "url": "https://www.memelord.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mlord_live_YOUR_API_KEY"
      }
    }
  }
}

Windsurf / Other Tools

Any tool that supports remote MCP servers over Streamable HTTP can connect. Point it at https://www.memelord.com/api/mcp; it will either run the OAuth flow or accept an Authorization header with your API key.

Start making memes

Ask your AI assistant in natural language:

"What meme templates are trending right now?"

"Generate a meme about developers fixing bugs at 3am"

"Make a video meme about shipping on Friday"

"Edit the last meme to be about JavaScript instead"

"Face-swap me onto the Drake template using this photo URL"

Using your own photos and videos

Tools take media as public URLs. When you hand your assistant a local file, it uploads it first with upload_media, which saves it to your Uploads and returns an https URL (valid for 7 days). JPEG, PNG, and WebP images up to 10 MB and MP4, MOV, and WebM videos up to 100 MB are accepted; uploads are free and limited to 50 per hour.

• data_base64— the file inline, up to 3 MB.
• source_url— an https link Memelord downloads. ChatGPT attachments arrive this way automatically.
• Larger files — create_media_upload_url returns a one-time upload URL; PUT the bytes, then call upload_media with the upload_id.

curl -X PUT -H "Content-Type: video/mp4" \
  --data-binary @clip.mp4 "<upload_url>"

Available Tools

Tools marked Billable draw from your usage balance based on the underlying generation cost. Everything else — search, template lookup, trending, tool discovery, media uploads, render status, and account info — is free so your agent can plan before it spends.

Check spend on Settings → Usage. If the balance hits zero, billable tools return a clear error and the free tools keep working.

See the API Docs for the matching REST endpoints and full parameter details.

Authentication details

• /api/mcp is an OAuth 2.1 protected resource. Its metadata lives at https://www.memelord.com/.well-known/oauth-protected-resource/api/mcp (RFC 9728), and an unauthenticated request gets a 401 with a WWW-Authenticate challenge pointing there. Compliant clients need nothing else to start the flow.
• The authorization server is Memelord's own sign-in (Supabase Auth), so you use your existing account — email, Google, or Apple. Clients register themselves dynamically (RFC 7591); PKCE is required.
• Every token acts as you, with the same permissions the website has. There are no per-tool scopes: free tools never spend, billable tools are gated by your usage balance, and you can revoke an app at any time.
• API keys are tied to your account and can be revoked individually in Developer Settings. Keep them out of repos and chat logs.

OpenClaw Skill

Alternatively, the Memelord skill is available on OpenClaw for tools that support it. Install it and set your API key as an environment variable:

openclaw install iamjasonlevin/memelord
export MEMELORD_API_KEY="mlord_live_YOUR_API_KEY"

The OpenClaw skill works with Cursor, Claude Code, Windsurf, Codex, and any OpenClaw-compatible agent.

GET SKILL