<div align="center">

<img src="assets/logo.svg" alt="RemixMeme logo" width="88">

# RemixMeme

**Remote MCP, CLI, and REST API for watermark-free AI meme videos.**

Upload 1–2 photos and generate vertical videos from public templates, ready for TikTok and Reels. Agents can list templates without a key, then generate and track videos with an API key.

English · [简体中文](README.zh-CN.md)

[![Website](https://img.shields.io/badge/remixmeme.com-111111?style=flat-square)](https://remixmeme.com)
[![Docs](https://img.shields.io/badge/docs-111111?style=flat-square)](https://remixmeme.com/docs)
[![MCP Registry](https://img.shields.io/badge/MCP_Registry-com.remixmeme%2Fremixmeme-111111?style=flat-square)](https://registry.modelcontextprotocol.io/v0/servers?search=com.remixmeme/remixmeme)
[![Remote MCP](https://img.shields.io/badge/remote_MCP-Streamable_HTTP-111111?style=flat-square)](#mcp)
[![License: MIT](https://img.shields.io/badge/code-MIT-111111?style=flat-square)](LICENSE)

</div>

This repository is the **public integrations pack**: MCP metadata, an Agent Skill, and usage docs. The RemixMeme website itself is not open-sourced here. RemixMeme is a third-party tool and is **not** an official TikTok or CapCut product.

## MCP

The server is `https://remixmeme.com/mcp` (Streamable HTTP).

**Claude Code**

```bash
claude mcp add --transport http remixmeme https://remixmeme.com/mcp
```

**Codex**

```bash
codex mcp add remixmeme --url https://remixmeme.com/mcp
```

**Cursor** (`~/.cursor/mcp.json`)

```json
{ "mcpServers": { "remixmeme": { "url": "https://remixmeme.com/mcp" } } }
```

**VS Code** (`.vscode/mcp.json`)

```json
{ "servers": { "remixmeme": { "type": "http", "url": "https://remixmeme.com/mcp" } } }
```

Claude Desktop, ChatGPT developer mode, and other Streamable HTTP clients can use the same URL. Full guides: [remixmeme.com/docs#mcp](https://remixmeme.com/docs#mcp).

### Tools

| Tool | Auth | What it does |
|---|---|---|
| `list_templates` | none | List public templates (`query`, `category`, `limit`, `offset`) |
| `get_template` | none | Get one template by `slug` |
| `get_credits` | API key | Credit balance for the key owner |
| `generate_video` | API key | Start a generation (`consent` must be `true`) |
| `get_generation` | API key | Poll one of your tasks by `id` |
| `list_generations` | API key | List your generations |

Template listing does not return generation prompts. Send API keys only as `Authorization: Bearer sk_...`, never in tool arguments.

`generate_video` needs `consent: true` (you have rights to the submitted media, and will not generate sexual or exploitative content involving minors). Provide `template_slug` and/or `prompt`. Optional: `image_url`, `aspect_ratio` (defaults to `9:16`), `model`, `duration_seconds`, `resolution`, `count`, `audio`.

Create a key at [Settings → API Keys](https://remixmeme.com/settings/apikeys). Generation uses the same credits as the website.

## CLI

```bash
npx remixmeme --help
npx remixmeme templates chatgpt
```

Or install it:

```bash
npm install -g remixmeme
# same CLI also via:
curl -fsSL https://remixmeme.com/cli/install.sh | bash
```

Docs: [remixmeme.com/cli](https://remixmeme.com/cli).

## REST API

Base URL: `https://remixmeme.com/api/v1`  
OpenAPI: [https://remixmeme.com/api/v1/openapi.json](https://remixmeme.com/api/v1/openapi.json)

```bash
# Public: list templates
curl -sS "https://remixmeme.com/api/v1/templates?query=chatgpt&limit=5"

# Authenticated: check credits, then start a generation
curl -sS https://remixmeme.com/api/v1/me \
  -H "Authorization: Bearer $REMIXMEME_API_KEY"

curl -sS -X POST https://remixmeme.com/api/v1/generations \
  -H "Authorization: Bearer $REMIXMEME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"consent":true,"templateSlug":"if-i-was-chatgpt-trend","imageUrl":"https://example.com/photo.jpg","aspectRatio":"9:16"}'
```

`consent` must be `true`. Successful responses use `{ "code": 0, "message": "ok", "data": ... }`. Docs: [remixmeme.com/docs#rest](https://remixmeme.com/docs#rest).

## Agent Skill

[`skills/remixmeme/SKILL.md`](skills/remixmeme/SKILL.md) teaches an agent to call the public REST API with `curl`.

```bash
npx skills add xianyu110/remixmeme
```

## License

The files in this repository are [MIT](LICENSE).