MCP tools and safe retries

Read and write private product content#

get_workspace returns the available balance, costs, AI availability and connection permissions. list_products and get_product read the connected owner’s private products.

create_product creates a manual draft. save_product updates content using the latest expectedUpdatedAt from get_product. Its content object replaces the prior content object, so include every section and file you intend to keep.

• get_generation_status reads the current content-generation job.
• get_download_links returns signed-in owner download links, not public buyer access links.
• list_assets returns asset status; a completed asset is different from a queued job.

Use paid generation deliberately#

generate_product_step performs one outline, section or launch-kit step. Continue sequentially with a fresh requestId for each new step, and inspect done before claiming completion. stop_generation cancels future content steps while keeping completed work.

revise_product_section asks FiveGen AI to rewrite one section. generate_marketing_asset queues an image or video. sync_marketing_asset checks and saves an existing asset result without starting another generation.

Read live costs through get_workspace rather than hard-coding them. Use confirmSpend and maxCredits for standard paid operations. When the workspace reports unlimited access, the documented tool contract uses maxCredits=0 and confirmSpend=false.

Retry the same operation safely#

For a retry of the exact same write operation, reuse the same requestId and arguments. A different operation or changed input needs a new requestId. Reusing one ID with different arguments is rejected.

If a request says it is still running or its result is uncertain, read the product or generation status before starting again. A stale expectedUpdatedAt means someone edited the product: read the latest content, preserve intended changes and submit a reviewed update.

1. get_workspace
2. create_product with a new requestId
3. get_product to read current updatedAt
4. save_product with expectedUpdatedAt and a new requestId
5. get_product to verify saved content
6. Review and launch in the FiveGen interface

Transport and authorization#

The server endpoint uses POST-based Streamable HTTP with OAuth bearer authorization. A plain GET request is not a connectivity test and returns Method Not Allowed. OAuth discovery metadata is available from the configured app origin.

Missing scopes, expired authorization and an incorrect OAuth resource require the appropriate reconnection or configuration fix. Do not put access tokens in URLs, page text or shared screenshots.

/.well-known/oauth-protected-resource
/.well-known/oauth-authorization-server