# mcp-runware

Create high-quality images and videos fast from text or reference images. Personalize subjects, upscale, remove backgrounds, generate captions, and auto-mask faces, hands, and people. Upload local fi…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add elijahdev0/mcp-runware

# Browse available tools
npx -y @smithery/cli@latest tool list elijahdev0/mcp-runware

# Get full schema for a tool
npx -y @smithery/cli@latest tool get elijahdev0/mcp-runware imageInference

# Call a tool
npx -y @smithery/cli@latest tool call elijahdev0/mcp-runware imageInference '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-runware--elijahdev0.run.tools`

**Required config:**
- `RUNWARE_API_KEY` (query) — API key from https://my.runware.ai used to authenticate image/video generation requests.

**Optional config:**
- `DEBUG` (query) — Toggle verbose logging when running the MCP server.
- `RUNWARE_BASE_URL` (query) — Optional override for the Runware API endpoint.

## Tools (11)

- `imageInference`
- `photoMaker`
- `imageUpscale`
- `imageBackgroundRemoval`
- `imageCaption`
- `imageMasking`
- `modelSearch`
- `videoInference`
- `listVideoModels`
- `getVideoModelInfo`
- `imageUpload`

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get elijahdev0/mcp-runware <tool-name>
```

---

Source: https://github.com/elijahdev0/MCP-Runware