Shopstage with Codex

Setup steps

1. 1

   In the Shopstage dashboard, create an API key under Settings > Integrations. The key is shown only once.

2. 2

   Set the key as an environment variable: export SHOPSTAGE_API_KEY=...

3. 3

   Add the block below to the ~/.codex/config.toml file.

4. 4

   Restart Codex; the vitrin tools become available.

5. 5

   To sign in with your browser instead of a key, delete the bearer_token_env_var line and run codex mcp login vitrin (OAuth).

[mcp_servers.vitrin]
url = "https://shopstage.net/mcp"
bearer_token_env_var = "SHOPSTAGE_API_KEY"

Example requests

• “List products that are waiting for Reels”
• “Create premium Reels and white-background images for my door handle product”

What it can do

• list_products

  Lists and searches products, filters discounted ones

• get_product

  Gets the details of a single product

• list_posts

  Lists posts by status

• create_post

  Creates a post, Reel, carousel or story from a product

• approve_post

  Approves a draft

• reschedule_post

  Changes the publish time

• cancel_post

  Cancels a scheduled post

• publish_now

  Publishes a post right away

• generate_captions

  Writes captions for a product

• plan_week

  Plans the weekly publishing calendar

• get_report

  Gets the performance report

• list_channels

  Lists connected social accounts

• get_store

  Gets the connected store's details

• sync_store

  Re-syncs the store catalog

• get_usage

  Shows plan quota and usage

• generate_ad_creatives

  Generates ad visuals, copy and audience suggestions from products

• get_ad_copy

  Writes ad headlines and copy for a single product

• export_ad_pack

  Returns the Meta Ads Manager CSV and image URLs

• detect_product_category

  Detects a product's category

• list_shot_presets

  Lists shot styles (white background, lifestyle...)

• list_video_motions

  Lists video motions and their cost

• generate_product_media

  Creates AI images and a short video from a product photo

• get_media_job

  Gets the status of a generated output

• list_media_assets

  Lists the AI shoot library

• list_orders

  Lists orders by date, status and source

• get_order

  Gets the details of a single order

• list_whatsapp_leads

  Lists WhatsApp order requests

• mark_lead_sold

  Marks a WhatsApp request as sold

• get_storefront

  Returns the storefront URL and QR code

• creator_generate_ideas

  Generates ideas for creators

• creator_generate_script

  Writes a Reels script

• list_brand_deals

  Lists brand collaborations

• create_brand_deal

  Adds a new brand offer to collaborations

• update_brand_deal_stage

  Updates a collaboration's stage

• get_media_kit

  Gets the media kit

• calculate_rate

  Calculates a price range for posts and Reels

• get_creator_earnings

  Earnings, pending payouts and a per-brand breakdown