PopNowAPI Docs
Main content

AI agents and MCP

Use the PopNow API from Claude, ChatGPT, Cursor and other agents today, and what the MCP server will add when it opens.

AI assistants and coding agents can already create images, video and audio with PopNow: give them the API key and point them at the machine-readable docs. A ready-made MCP server — one address you add to Claude, ChatGPT, Cursor and other clients — is being prepared and is not open yet. The MCP page shows the planned tools and will switch on when it launches.

What to give an agent today

ResourceAddressUse
OpenAPI/docs/openapi.yamlEvery endpoint, field and error, for tool generators and agents that read specs
Docs index/docs/llms.txtA short map of these docs and every model, written for language models
Full docs/docs/llms-full.txtAll pages in one Markdown file
One page/docs/markdown/<page>A single page as Markdown — the Copy page button on every page gives you the same

A prompt that works well in coding agents:

Use the PopNow API (OpenAPI: https://popnow.ai/docs/openapi.yaml,
docs: https://popnow.ai/docs/llms.txt). My key is in the POPNOW_API_KEY
environment variable; never print it or write it to a file.
Before you create anything, call POST /api/v1/jobs/quote and tell me the
price in credits (1 credit = $0.01). Send an Idempotency-Key with every
createTask, and wait for the result with ?wait=60 or by polling recordInfo.

Keep the agent safe

  • Give the agent its own key, restricted to the models it needs and with a daily spend cap (Authentication). If something goes wrong, revoke that one key.
  • Ask it to quote before it runs anything expensive, especially video.
  • The key belongs in the environment, not in the conversation: agents sometimes echo what they are told.

When the MCP server opens

The MCP server will use the same API key and the same credits as everything on this site, and its tools will map one-to-one onto the endpoints documented here — choose a model, quote, create, wait for the result, download. Anything you build against the REST API today keeps working unchanged.

On this page