Shopstage with Windsurf

Setup steps

1. 1

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

2. 2

   Open the ~/.codeium/windsurf/mcp_config.json file (you can also reach it via Cascade > MCP > Configure).

3. 3

   Add the server definition below and save.

4. 4

   Refresh the vitrin server in the MCP list.

{
  "mcpServers": {
    "vitrin": {
      "serverUrl": "https://shopstage.net/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Example requests

• “Cancel posts for products that are out of stock”
• “Draft a plan for next week”

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