topview-generate

Topview Generate

Creative generation through the host-managed topview-mcp.

Last updated: 2026-07-21

If a requested model or feature is missing, check topview_get_generation_config before calling it unsupported.

Notes for Auditors

The reply guidelines below are UX preferences for non-technical users in chat apps. They do not ask the agent to hide errors, bypass safety controls, override higher-priority instructions, or perform unattended privileged operations. Authentication and tool execution are controlled by the MCP host. Deviate when the user requests technical detail or safety requires it.

Execution

This skill is MCP-only. Use the creative and upload hot tools exposed directly by topview-mcp: topview_* and ta_*. Never route those tools through get_tool_schema or call_tool; those are only for deferred data-domain tools used by the ops skills. Do not run scripts/*.py or make raw REST calls.

Market and creator-data requests belong to:

• Amazon → topview-amazon-ops
• Shopee → topview-shopee-ops
• TikTok Shop → topview-tiktok-shop-ops
• YouTube KOL pool → topview-youtube-kol-ops

Prerequisites and Authentication

1. Confirm the host has connected topview-mcp.
2. Authentication is handled by the host (Cursor OAuth or the host's mcp_auth flow). Do not ask the user to set TOPVIEW_UID or TOPVIEW_API_KEY manually.
3. If a tool reports that authentication is required, invoke the host's mcp_auth mechanism. If it returns an authorization URL, send that exact URL to the user. If it does not, ask the user to complete the sign-in action shown by their host. Never invent or promise a URL.
4. After the user confirms sign-in, retry the original MCP call once.

See Authentication and Credits.

Common Agent Workflow

Keep this sequence centralized here; capability references only add their specific fields.

1. Understand intent. Determine output type, purpose, source assets, style, duration, language, captions, and publishing channel.
2. Select a board. Unless the user supplied a boardId, call topview_list_boards. Choose, in order: a board with isSystemDefault=true; a board named My First Board; otherwise the first returned board. Reuse that boardId for the session. If no board exists or the user asks for a new one, call topview_create_board.
3. Load live model configuration. Before every model-based generation, call topview_get_generation_config with the intended type and taskType. Use models[].submitModel exactly, satisfy every requiredSubmitFields entry, choose constrained values from submitParameterOptions, and use defaultSubmitParameters only when the user omitted a required value.
4. Upload local assets. For each local image, audio, or video:
   • call ta_upload_credential with its file extension in format;
   • upload the bytes using the returned upload URL and required method/headers;
   • call ta_upload_check_file with the returned fileId;
   • use the fileId only after the check succeeds. Existing Topview fileId values need no upload.
5. Submit directly. Call the selected topview_* tool directly and retain its taskId, the exact taskType, selected boardId, model, and parameters.
6. Poll to a terminal state. Call topview_query_task repeatedly with the same taskType and taskId until success or fail. A timeout does not mean failure: continue later with the same identifiers. Do not blindly resubmit, because that can duplicate work and consume credits.
7. Return the result. Lead with downloadable output URLs. If the result has boardTaskId, include https://www.topview.ai/board/{boardId}?boardResultId={boardTaskId}.