# PopNow API

> PopNow API is a paid MCP server for design and media. Hosted MCP for running image, video, music and speech models by API key, billed in USD. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://popnow.ai/api/mcp
- **Repository:** https://github.com/popnow-ai/popnow-api-mcp
- **MCP Registry name:** io.github.popnow-ai/popnow-api-mcp
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Model access goes through one remote endpoint, with the key's model allow-list, IP allow-list and spend caps enforced as on the REST API. Requests are limited to 240 a minute and 20 new tasks a minute.

Paid calls work in two steps. A call without max_usd returns a quote with cost_usd and available_usd and charges nothing; after you agree, the agent repeats the call with max_usd set to the quoted cost. Failed tasks release the held amount.

Beyond named media tools there is create_task for any model by its exact ID, plus helpers for editing, upscaling, composing videos, listing recent tasks and installing skill packages. The website lists 245 models.

## Features

- **Quote then approve:** Every paid call returns a USD quote first and runs only with max_usd.
- **Any model by ID:** create_task runs any listed model with its own input fields.
- **Named media tools:** Image, video, music and speech tools come with sensible defaults.
- **Editing helpers:** Background removal, upscaling, effects and sound can be added to results.
- **Task and balance tracking:** Follow tasks, list recent ones and check wallet balance.
- **Stdio bridge:** An npm bridge lets local-only clients reach the hosted endpoint.

## Good for

- Generate an image or clip from a coding agent after approving the price
- Compare model prices before running a batch
- Stitch earlier results into one MP4 with music and captions
- Run saved recipes from an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http popnow-api-mcp https://api.popnow.ai/api/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.popnow.ai/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "popnow-api-mcp": {
      "url": "https://api.popnow.ai/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "popnow-api-mcp": {
      "type": "http",
      "url": "https://api.popnow.ai/api/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "popnow-api-mcp": {
      "serverUrl": "https://api.popnow.ai/api/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "popnow-api-mcp": {
      "type": "http",
      "url": "https://api.popnow.ai/api/v1/mcp"
    }
  }
}
```

## Tools

- `create_task`: Runs any model by its exact API ID.
- `create_image`: Creates an image with default settings.
- `create_video`: Creates a video with default settings.
- `create_music`: Creates music.
- `create_speech`: Creates speech audio.
- `edit_image`: Edits an image.
- `apply_effect`: Applies an effect.
- `remove_background`: Removes an image background.
- `upscale`: Upscales media.
- `add_sound`: Adds sound to a video.
- `extend_video`: Extends a video.
- `relight_photo`: Relights a photo.
- `list_models`: Lists model IDs, inputs and USD prices.
- `get_task`: Follows a task.
- `list_tasks`: Lists recent tasks made with the key.
- `check_balance`: Shows available and held USD.
- `compose_video`: Cuts earlier results into one MP4 with music, voice and captions.
- `find_skills`: Finds a skill package.
- `install_skill`: Returns a skill playbook, download link and install commands.
- `run_my_recipe`: Runs a saved recipe.
- `get_recipe_run`: Reads a recipe run.
- `resume_recipe_run`: Resumes a recipe run.

## FAQ

### How do I authenticate?

With a PopNow API key sent as a Bearer token; there is no OAuth sign-in on this endpoint.

### Am I charged for failed tasks?

No. The pricing page says the held amount is released if a task fails.

### Does it work in Claude Code?

Yes; a single claude mcp add command with the key header connects it.

### What is the rate limit?

240 requests and 20 new tasks a minute.

### Is PopNow API free?

No. PopNow API is a paid product.

### How do I add PopNow API to Claude Code?

Run this command in your terminal: claude mcp add --transport http popnow-api-mcp https://api.popnow.ai/api/v1/mcp

### What are the best alternatives to PopNow API?

The closest alternatives to PopNow API are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/popnow-api
