
PopNow MCP server for ChatGPT, Claude and any MCP client: AI image, video, music and speech
PopNow MCP server for ChatGPT, Claude and any MCP client: AI image, video, music and speech generation with your PopNow account and credits (OAuth). API keys: popnow-ai/popnow-api-mcp.
·
The PopNow MCP Server is a hosted Model Context Protocol server at https://api.popnow.ai/mcp that lets ChatGPT, Claude, Cursor, VS Code and any other MCP client create AI images, videos, songs and voiceovers on PopNow, using your PopNow credits.
PopNow AI (popnow.ai) is the world's first AI studio with automatic price protection. Every generation shows its price before it runs, and under PopNow Protect failed or off-spec runs are refunded automatically, runs slower than the guaranteed time earn 50% back (100% if they take more than twice the guaranteed time), and with the Price bounty, the first person to show the same model with the same settings at a lower standard public price on Higgsfield, Runway or fal gets twice the difference in reward credits, after review and within limits.
Ask in plain words ("turn this photo into a 5-second video", "make an upbeat synth-pop track") and the assistant picks the right PopNow tool, tells you the price, and returns the result in the chat. There is nothing to host: the server is remote, signs you in with OAuth 2.1, and uses the same models, prices and library as popnow.ai. It is also the home of PopNow's free Agent Skills: ask for a style for your launch video, deck or landing page and the assistant shows you presets to pick from. Make it pop.
This repository contains the public setup guide, copy-paste client configs in examples/ and an MCP registry manifest.
Building with an API key (Claude Code, Cursor, Codex or your own code, billed in USD from an API balance)? Use the developer server in popnow-api-mcp. The
@popnow/mcpnpm bridge moved there too.
https://api.popnow.ai/mcpclaude mcp add --transport http popnow https://api.popnow.ai/mcpNo PopNow account yet? Sign up at popnow.ai and pick a credit pack when you need more credits.
| Server URL | https://api.popnow.ai/mcp |
| Transport | Streamable HTTP, stateless (POST only; GET and DELETE return 405) |
| Sign-in | OAuth 2.1 with PKCE and dynamic client registration: you sign in with your PopNow account |
| Scopes | generate (create with your credits) and read (balance, creations, model list) |
| Tools | Generation, account and style-preset tools (listed below) |
| Price | Same credits as popnow.ai (1 credit = $0.001). Up to 300 credits starts at once; anything above waits for your yes. Style presets are free |
| Tool | What it does | Key parameters | Typical cost |
|---|---|---|---|
create_image | Make a new picture from a description | prompt, aspect_ratio (default 1:1), model, max_credits | about 48 credits (default Nano Banana 2.1) |
edit_image | Change a photo with words: new style, outfit, background, add or remove things | prompt, image_url / image, more_image_urls, aspect_ratio, model, max_credits | about 48 credits |
create_video | Make a short video from a description, or bring a photo to life (text-to-video and image-to-video) | prompt, image_url / image, duration_seconds (default 5), aspect_ratio (default 16:9), model, max_credits | about 185 credits for 5 s (default MiniMax H3); 1 to 3 minutes |
create_music | Make an original song or instrumental track | prompt, lyrics, instrumental, voice (female / male), title, max_credits | about 72 credits per song (Suno v6) |
create_speech | Turn text into natural speech in many voices and languages | text, voice (Kore, Puck, Charon, Aoede, Fenrir, Leda ...), style (whisper, empathetic, vocal_smile, newscaster, promo_hype, deadpan), max_credits | priced by length, about 20 credits per minute of audio |
apply_effect | Turn a photo into a trending effect video (Zombie Turn, Flying Car, Tiny Planet, Molten Gold, Hyperdrive ...) or a photo makeover (Clay Figure, Pixel Art ...) | effect (name or id), image_url / image, max_credits | about 125 to 340 credits per video, 30 to 50 per photo makeover; quoted first |
remove_background | Cut out the subject and make the background transparent | image_url / image, max_credits | about 5 credits |
upscale | Make a photo or video sharper and bigger | image_url / image or video_url, size (photos 2k, 4k, 8k; videos 720p, 1080p, 2k, 4k), max_credits | about 12 credits for a photo; videos by length |
get_job | Check on a creation that is still running and return it when ready | job_id, wait_seconds (0 to 50, default 30) | free |
list_my_creations | Show your recent PopNow creations with links | kind (image, video, audio), limit (1 to 20, default 10) | free |
check_balance | Show how many credits you have left (and how many are held for running jobs) | none | free |
list_models | List the image, video and audio models, or every effect, with prices | category (image, video, audio, effects) | free |
find_skills | Find ready-made style presets (Agent Skills) for what you want to make: product launch videos, slide decks, landing pages and websites, editorial images. Each option has a name, a one-line look, a preview video or picture, the PopNow generation it uses and what it needs locally | intent (your words), type (video, image, slides, web), limit (1 to 6, default 4) | free |
use_skill | Get the preset you picked: its full playbook (SKILL.md), a short-lived signed download link for the whole package with install commands for your coding agent, and which PopNow tools run its generation steps | slug (from find_skills), agent (claude-code, codex, cursor, gemini-cli, github-copilot, opencode, or chat without a file system) | free; each generation it runs is quoted first |
model accepts a PopNow model id from list_models, so "use Seedance" or "make it with Wan" just works. Models include Kling, Seedance, Wan, Vidu, MiniMax, Nano Banana, GPT Image, Flux, Suno and more; the live list is always list_models.image_url takes a public https link or a popnow:// link from an earlier result. In ChatGPT, an attached photo arrives as the image file object.popnow:// link you can pass to another tool ("now animate that picture"). Everything is saved in your PopNow library.get_job, list_my_creations, check_balance, list_models, find_skills and use_skill are read-only, and no tool deletes anything.PopNow keeps a catalog of free Agent Skills: named styles for product launch videos, slide decks, landing pages and websites, editorial images and more, each with a preview and a full playbook that an AI agent follows to build the result. Two free tools bring the catalog into any MCP client:
find_skills with what you want to make, in your words (optionally type: video, image, slides or web). It gets up to 6 options (4 by default), best first, each with a name, a one-line description of the look, a preview link, the PopNow generation it uses and its local requirements.use_skill with the chosen slug and agent (claude-code, codex, cursor, gemini-cli, github-copilot, opencode, or chat in apps without a file system). The reply holds the full SKILL.md playbook, a short-lived signed download link to the complete package with the install commands for that agent, and which PopNow tools (create_image, create_video, create_music, create_speech ...) replace the playbook's own generation scripts.Finding, downloading and using a preset is free. Only the images, video, music or voice it generates cost credits, quoted and confirmed like every other PopNow tool. Presets are licensed for your own and client work; please don't republish the packages. In a chat app without a file system the assistant can still follow the playbook's look and make the pictures with create_image; steps that run local scripts need a coding agent.
You: I need a launch video for our note-taking app.
Assistant: (calls find_skills with intent "launch video for a note-taking app", type "video")
Here are three styles:
1. <Preset A> - <its one-line look>. Preview: <link>. Uses PopNow video; needs Node.js.
2. <Preset B> - ...
3. <Preset C> - ...
Which one do you like? The preset is free; only the clips it makes cost credits.
You: The first one.
Assistant: (calls use_skill with that slug and agent "claude-code", installs the package from the
signed link, then follows the playbook)
Installed. The first clip will cost 185 credits. Go ahead?
You: Yes.
Assistant: (calls create_video with max_credits: 185, then get_job, and keeps building the video)You can also browse the catalog and its previews on the website; Use a skill in ChatGPT or Claude walks through it.
Every client below talks to the same remote server and signs in with your PopNow account (OAuth). Ready-made files are in examples/.
Custom connectors are available on Claude plans and workspaces that allow them.
PopNow and paste https://api.popnow.ai/mcp. Leave the advanced OAuth fields empty: Claude registers itself automatically.A connector added on the web also works in the Claude mobile apps. If you do not see Connectors, ask your workspace admin.
Prefer the connector above. If you want PopNow in claude_desktop_config.json instead (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), use the generic mcp-remote stdio bridge, which opens the PopNow sign-in page the first time (examples/claude-desktop-mcp-remote.json):
{
"mcpServers": {
"popnow": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.popnow.ai/mcp"]
}
}
}Restart Claude Desktop after editing the file. mcp-remote needs Node.js 18 or newer.
claude mcp add --transport http popnow https://api.popnow.ai/mcpThen run /mcp inside Claude Code and choose PopNow to sign in.
Add --scope user to make PopNow available in every project, or --scope project to share it through .mcp.json.
Custom MCP servers depend on your ChatGPT plan and workspace settings, and menu names change as ChatGPT updates. The current path:
PopNow, paste https://api.popnow.ai/mcp under Connection and pick OAuth as the sign-in method. Accept the warning, then choose Create as a plugin.@, pick PopNow and ask. Photos you attach are passed to PopNow directly.Add to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects (examples/cursor.mcp.json):
{
"mcpServers": {
"popnow": { "url": "https://api.popnow.ai/mcp" }
}
}Cursor starts the OAuth sign-in when it connects.
Add to .vscode/mcp.json (note the top-level key is servers) (examples/vscode.mcp.json):
{
"servers": {
"popnow": { "type": "http", "url": "https://api.popnow.ai/mcp" }
}
}VS Code opens the sign-in page the first time the server starts.
Open the MCP settings in Windsurf and edit the raw mcp_config.json (its location is in the official Windsurf MCP docs). Remote servers use serverUrl (examples/windsurf.mcp_config.json):
{
"mcpServers": {
"popnow": {
"serverUrl": "https://api.popnow.ai/mcp"
}
}
}Press Refresh in the MCP panel after saving, then sign in when Windsurf asks.
Open MCP Servers → Configure and add PopNow to cline_mcp_settings.json. Set type to streamableHttp explicitly; without it Cline falls back to the legacy SSE transport (examples/cline_mcp_settings.json):
{
"mcpServers": {
"popnow": {
"type": "streamableHttp",
"url": "https://api.popnow.ai/mcp",
"disabled": false,
"autoApprove": []
}
}
}Use Authorize OAuth in Cline (or in the cline mcp wizard of the Cline CLI) to sign in.
To add the hosted server directly from Cline CLI:
cline mcp add popnow https://api.popnow.ai/mcp --transport http --yesThe same steps are summarized in llms-install.md. Once
signed in, call check_balance with {} to check the connection without
spending credits.
This repository is also a portable Agent Plugins v1
package. It declares the hosted server in mcp.json; it does not
start a local executable or require the optional npm bridge.
For Hermes Agent,
use its native MCP configuration so OAuth is explicit. Add to the active
profile's config.yaml:
mcp_servers:
popnow:
url: https://api.popnow.ai/mcp
auth: oauth
trust: untrustedRun hermes mcp login popnow, then start a new session or use /reload-mcp.
The native configuration asks Hermes to require approval before write-capable
calls, including generation. PopNow also enforces its returned price and
confirmation requirements on the server. Reading a balance or listing models
does not spend credits.
For Gemini CLI:
gemini extensions install https://github.com/popnow-ai/popnow-mcpThe root gemini-extension.json uses Streamable HTTP
and OAuth. Run /mcp auth popnow in Gemini CLI to sign in if needed. Tool
approval follows the client's normal policy.
Data and execution disclosure. These manifests connect to
https://api.popnow.ai/mcp. Only the tool arguments and media references sent
by your client are passed to PopNow. Generation creates media in the connected
account and spends its prepaid balance. The portable package has no hooks,
local commands, background processes, or custom credential storage. Review the Privacy Policy
and Terms, or contact [email protected].
Marketplace review is separate from direct installation. These installation commands do not imply approval or endorsement by a client vendor.
codex mcp add popnow --url https://api.popnow.ai/mcp
codex mcp login popnowOr add it to ~/.codex/config.toml (examples/codex.config.toml) and run codex mcp login popnow:
[mcp_servers.popnow]
url = "https://api.popnow.ai/mcp"Any client that speaks Streamable HTTP and supports OAuth sign-in can use the same URL (examples/generic.json). Clients that only run local stdio servers can use mcp-remote, as in the Claude Desktop config.
To call PopNow from your own code, scripts or CI with an API key, use the developer server in popnow-api-mcp or the PopNow REST API.
OAuth 2.1 (default). PopNow is a standard OAuth 2.1 authorization server: authorization code with PKCE (S256), refresh tokens, dynamic client registration (RFC 7591) and client ID metadata documents. Discovery starts from the 401 on /mcp, whose WWW-Authenticate header points to /.well-known/oauth-protected-resource/mcp; server metadata is at /.well-known/oauth-authorization-server. The consent page shows the app's name and the two scopes, generate and read. Access tokens last one hour and refresh automatically; a connection stays signed in until it goes unused for 90 days. The AI app never sees your password or payment details.
API keys are for developers. They are billed in USD from a separate API balance and connect to the developer server at https://api.popnow.ai/api/v1/mcp; see popnow-api-mcp. This address still accepts API keys until 31 January 2027 so existing setups keep working while they move.
Disconnect at any time in Account settings → Devices → Connected AI apps on popnow.ai.
Connecting is free, and so are find_skills and use_skill. Every creation spends the same credits as on popnow.ai, at the same prices, from the same balance: 1 credit = $0.001. PopNow sells credit packs with no subscription, from Starter ($10, 10,000 credits) to Pro ($100, 112,000 credits including bonus), or any amount from $10 to $2,000 at 1,000 credits per $1; see pricing.
Every generation tool quotes first:
max_credits set to the price you accepted.Identical calls from the same account within ten seconds create one job, so an assistant that retries does not pay twice. A tool waits up to about 40 seconds for the result; longer jobs (most videos) return a job_id and the assistant collects the result with get_job.
| Rate limit | Value |
|---|---|
Tool calls per account (including get_job polling) | 240 per minute |
| New creations per account | 20 per minute |
A creation over the limit is not charged; the tool says how many seconds to wait.
A typical exchange:
You: Make a 9:16 video of a vintage car cruising along the coast at golden hour, 10 seconds.
Assistant: (calls create_video → "Needs confirmation … costs 370 credits (the user has 8450)")
That's 370 credits from your PopNow balance. Want me to go ahead?
You: Yes.
Assistant: (calls create_video again with max_credits: 370 → job_id, then get_job)
Here it is. It's saved in your PopNow library too.
You: Now give me an upbeat synth-pop track for it.
Assistant: (calls create_music → about 72 credits, under 300, starts at once)server.json describes the server in the MCP registry format (schema 2025-12-11): the remote Streamable HTTP endpoint with OAuth sign-in.
| You see | Why | Fix |
|---|---|---|
| No Connectors / Add custom MCP server option | Your plan or workspace does not allow custom connectors | Ask the workspace admin |
| "Please connect your PopNow account first." | The client called a tool before sign-in finished | Reconnect from the client's MCP or connector settings |
| "This connection wasn't given permission to do that." | The connection was approved without the generate scope | Disconnect, connect again and press Allow |
| Needs confirmation, nothing started yet | The job costs more than 300 credits | Say yes; the assistant repeats the call with max_credits |
| "Not enough credits ... Nothing was charged." | Balance too low | Buy a credit pack, or pick a cheaper model or a shorter video |
| "Too many creations at once. Nothing was charged." | More than 20 new creations in a minute | Wait the number of seconds in the message |
401 with a WWW-Authenticate header | Not signed in yet, or the sign-in expired | Reconnect from the client's MCP or connector settings and sign in again |
405 Method Not Allowed | GET or DELETE to /mcp; the server is stateless | Use POST (any MCP client does this for you) |
| Cline connects but nothing works | type missing, so Cline used legacy SSE | Set "type": "streamableHttp" |
/plugin marketplace add popnow-ai/popnow-mcp
/plugin install popnow-mcp@popnow-mcpAdd https://api.popnow.ai/mcp as a custom connector (Claude) or custom MCP server (ChatGPT), sign in to PopNow, and ask in plain words. The assistant calls create_image, create_video or another PopNow tool and returns the result in the chat.
Give the assistant a photo (attach it in ChatGPT, or paste a public https link elsewhere) and describe the motion. It calls create_video with image_url, which switches to image-to-video. About 185 credits for 5 seconds on the default model.
Yes. PopNow's create_music makes original songs or instrumentals (Suno v6) and create_speech reads text aloud in many voices, languages and delivery styles.
No. Connecting is free, and each creation costs the same credits as on popnow.ai. Failed creations are refunded automatically, and anything over 300 credits waits for your confirmation.
No. PopNow is a hosted remote MCP server; you only add its URL. Clients that cannot connect to remote servers can use mcp-remote.
API keys belong to the developer server at https://api.popnow.ai/api/v1/mcp, billed in USD from your API balance rather than your website credits. See popnow-api-mcp.
Image, video and audio models including Kling, Seedance, Wan, Vidu, MiniMax, Nano Banana, GPT Image, Flux and Suno, plus one-tap video effects. Ask the assistant to call list_models for the current list with prices, then name a model in your request.
Ask the assistant, for example "find a style for our product launch video". It calls find_skills, shows you a few presets with preview links, and after you pick one calls use_skill to get its playbook and install link. Presets are free; only the generations they run cost credits. You can also browse the catalog at popnow.ai/skills.
You get a link in the chat, and everything is saved in your PopNow library, just like creations made on the website.
Issues and pull requests are welcome. See CONTRIBUTING.md. For security issues, see SECURITY.md.
MIT © PopNow
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add popnow -- npx -y mcp-remote https://api.popnow.ai/mcp{
"mcpServers": {
"popnow": {
"args": [
"-y",
"mcp-remote",
"https://api.popnow.ai/mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"popnow","args":["-y","mcp-remote","https://api.popnow.ai/mcp"],"command":"npx"}'[mcp_servers.popnow]
command = "npx"
args = ["-y", "mcp-remote", "https://api.popnow.ai/mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/popnow-mcp to learn what the "Popnow Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http popnow https://api.popnow.ai/mcpThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/popnow-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "popnow-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.