Skip to main content

Getting Started

The NativeAds headless platform gives you programmatic control over the full creative-generation pipeline: creating and managing brands, extracting Brand DNA, uploading assets or pulling them off a web page, and generating images and video. Two integration paths share the same authentication and permission model:

  • REST API — call the HTTP endpoints directly from any language. Start with the REST API Guide, then the API Reference for schemas.
  • MCP server — expose the same capabilities as callable tools to any MCP client, from standard MCP clients like Claude, Cursor, and ChatGPT to your own custom integration. See MCP Guide.

Next steps​

  • REST API Guide — plain-English platform flow (brand → DNA → image/video, then an optional upscale on Pro and Ultra) with links into the API Reference. Scene Forge create accepts adverteyesScoring (default false) to have AdverEyes score a generation, which takes one Creative Optimization from the plan's allowance, and transparentBackground (default false) to render the subject alone on a transparent background (PNG with an alpha channel).
  • API Reference — full per-endpoint schemas for every key-callable route.
  • MCP Guide — wire up Claude, Cursor, ChatGPT, or another MCP client.
  • MCP Tool Catalog — all 18 tools and 42 actions. An action is not in your client's tool list: find_actions finds it and returns its schema, and a run_*_action tool runs it. A brand's media (renders, assets, backgrounds, logo, resize and upscale results) is shown with show_media and its Brand DNA with show_brand_dna, each taking a view; the readers behind them are read actions too, for a lookup that shows the user nothing. edit_brand_dna changes a Brand DNA version. ask_user asks the user in a panel: which brand, the Brand DNA offer, or which extraction candidates to save. generative_resize resizes one image to many sizes at once, and download_generative_resize_group then returns one link to a zip with an image per size, valid for 4 to 8 hours. With exactly one size it also takes a frame, the part of the image to show, and fills the rest. On a client that shows panels, open_resize_options lets the user pick several sizes, or frame one size, and submit it, and a Resize button under each finished image in the gallery and in a generation panel's results offers the same. Every resize, framed or not, shows its results on one resize card. On the Pro and Ultra plans, upscale_image enlarges one image to 1 to 4 larger sizes, each a factor of 2, 3 or 4 or a long edge up to 16,384 px, and get_upscale_group reads the results; on a client that shows panels, open_upscale_options lets the user pick the sizes and submit, and an Upscale button sits beside Resize in the gallery. On Starter, starting an upscale is refused with upgrade_required.
  • Prompt starters — the three starters an MCP client offers in its own menu, with autocompleting brand, industry, model, length and ratio arguments.

Getting images and video in​

You do not have to upload files. Three ways to put media on a brand:

  • Upload the bytes — reserve, PUT, confirm. See Upload assets.
  • Fetch a direct file link — hand the platform a URL to the file itself and it fetches it server-side.
  • Extract from a page — hand it a page URL (a product page, a property listing) and it scrapes the images, ranks them by how central each is to the page's subject, and returns candidates for review. Nothing lands on the brand until you commit the ones you want. See Extract assets from a product page for REST, or the MCP tool catalog for the tool equivalents.

Questions? Contact support@nativeads.ai.