Base URL

Prepend this to every endpoint path below. Your environment may use a different host — the value shown matches your current deployment.

https://backend.insidermemes.com/v1/

Copy-paste examples

# 1. Log in (get JWT access token)
curl -X POST "https://backend.insidermemes.com/users/api/dj-rest-auth/login/" \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

# 2. Mint API token (use access token from step 1)
curl -X POST "https://backend.insidermemes.com/v1/api/token/" \
  -H "Authorization: Bearer <access-token>"

# 3. List image templates (newest first)
curl "https://backend.insidermemes.com/v1/templates/?type=images&sort=new" \
  -H "Authorization: Token <api-token>"

# 4. Generate 3 image memes from a prompt
curl -X POST "https://backend.insidermemes.com/v1/generate/" \
  -H "Authorization: Token <api-token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Monday morning meetings", "mediaType": "images", "count": 3}'

Step 1: Get a JWT

POST /users/api/dj-rest-auth/login/ with your email and password. Use the access value from the response as a Bearer token.

curl -X POST "https://backend.insidermemes.com/users/api/dj-rest-auth/login/" \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

# Response (200 OK):
# { "access": "<jwt-access-token>", "refresh": "<jwt-refresh-token>", "user": { } }

Step 2: Mint an API token

POST /v1/api/token/ with your JWT, or reveal your key from profile settings. Each user has one API token — calling POST again returns the existing token.

curl -X POST "https://backend.insidermemes.com/v1/api/token/" \
  -H "Authorization: Bearer <jwt-access-token>"

# Response (201 Created or 200 OK):
# { "token": "9944b09199c62bcf9418ad846aa0e4edf6d1", "created": "2026-06-05T12:00:00Z" }

Step 3: Call V1 endpoints

Use your API token on all /v1/ requests. JWT (Bearer) also works on /v1/templates/ and /v1/generate/, but API tokens are intended for programmatic use.

Authorization: Token <api-token>
Content-Type: application/json

Revoke an API token

DELETE /v1/api/token with your JWT. Returns 204 No Content. Call POST /v1/api/token again to create a new token.

curl -X DELETE "https://backend.insidermemes.com/v1/api/token/" \
  -H "Authorization: Bearer <jwt-access-token>"

Plans at a glance

Paid plans also unlock template search, filters, and cursor pagination. Video generation requires a paid plan with video access.

Use Insider Memes inside Claude and other MCP-compatible AI assistants. Browse meme templates and generate ready-to-post memes from a simple text prompt — without leaving the chat.

Requirements

• An Insider Memes account with a paid plan (template browsing and generation require a paid subscription)
• Credits on your account for meme generation — see Credits & Pricing
• For hosted connectors, sign in with Insider Memes during the OAuth browser flow. For local bridge setups, use an API key from profile settings.

The hosted MCP connector uses OAuth, so you do not paste an API key into Claude. Claude opens Insider Memes in your browser, you sign in, approve access, and Claude receives a scoped token for your account.

1. Open claude.ai → Settings → Connectors
2. Choose Add custom connector
3. Name: Insider Memes
4. URL:
   urlCopy

   https://mcp.insidermemes.com/mcp

5. When Claude asks to authenticate, continue to Insider Memes, log in, and approve the requested access.
6. Return to Claude and start a new chat with the Insider Memes connector enabled.

Use an API key for local MCP apps

Claude Desktop, Cursor, and other local MCP clients can also connect with a personal API key. Use this path when your MCP app does not support OAuth connectors yet.

1. Log in at insidermemes.com.
2. Go to profile settings and click Reveal API Key.

Claude Desktop with an API key

Claude Desktop needs a small local bridge so your personal API key is sent securely with each request. Replace YOUR_API_KEY with the key from profile settings above.

1. Install Claude Desktop and Node.js (for npx)
2. Open ~/Library/Application Support/Claude/claude_desktop_config.json on Mac (or %APPDATA%\\Claude\\claude_desktop_config.json on Windows)
3. Add the mcpServers block below (merge with any existing servers):
   jsonCopy

   {
     "mcpServers": {
       "insider-memes": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://mcp.insidermemes.com/mcp",
           "--header",
           "Authorization: Bearer YOUR_API_KEY"
         ]
       }
     }
   }

4. Fully quit Claude (Cmd+Q on Mac), reopen, and start a new chat

Cursor & other MCP apps

In Cursor, open Settings → MCP (or edit ~/.cursor/mcp.json) and add a remote server with your API key in the headers. Replace YOUR_API_KEY with your key from profile settings.

{
  "mcpServers": {
    "insider-memes": {
      "url": "https://mcp.insidermemes.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Other MCP-compatible tools (Windsurf, Zed, etc.) follow a similar pattern: remote URL https://mcp.insidermemes.com/mcp plus Authorization: Bearer YOUR_API_KEY. If your app supports OAuth remote connectors, use the hosted connector URL without a static key instead.

Available tools

Example conversation

Troubleshooting