Developer docs

Connect your AI agent to Flypify over MCP. This page covers the endpoint, API keys, the client config, and what each tool does.

Connect your agent

Flypify runs an MCP server your agent can call directly: it finds winning TikTok Shop products, researches them, sources them, and pushes them to your Shopify store as drafts. It works with any MCP client that supports remote servers — Claude, Codex, Gemini and others. It is included with Pro and Shipper.

The endpoint is https://api.flypify.com/mcp/ over streamable HTTP. Keep the trailing slash — the no-slash /mcp form redirects there.

Get an API key

Create a key from your account under AI agent access (MCP). Keys start with flypify_live_ and are shown once — we keep only a hashed copy, so store yours in your client config or a password manager.

Send the key on every request in an Authorization: Bearer header — the config below does this for you. The X-Flypify-Key header works too.

Without a valid key on a paid plan the connection still opens, but each tool replies with an upgrade message instead of data.

Add the config to your client

Paste this into your MCP client config (for example claude_desktop_config.json), then replace flypify_live_YOUR_API_KEY with a key you created above.

flypify.mcp.json

{
  "mcpServers": {
    "flypify": {
      "url": "https://api.flypify.com/mcp/",
      "headers": {
        "Authorization": "Bearer flypify_live_YOUR_API_KEY"
      }
    }
  }
}

Then ask your agent to find a winner and push it to your Shopify store.

Tools

The server exposes five tools. Each returns JSON.

`find_winners(niche?, sort?, limit?)`

Find winning products. Returns compact research per item — revenue, margin, saturation, trend with a forecast band, and has_winning_ad / has_source flags. niche filters by category (see list_niches) and defaults to your store’s niche; sort is one of Best, Newest, Profit, LowRisk or Rising (anything else falls back to Best); limit is 1–25.

The exact source URL, buy cost and winning ad are not in this list — use get_winner for those. Each item returned spends one daily product reveal, and the call counts against the daily call cap (see limits below).

`get_winner(opp_id)`

Full sourcing detail for one winner: research, the exact source link, landed cost, margin and forecast band. Spends one daily product reveal. On Shipper it also returns the winning ad — the top video URL, the creator handle and the TikTok video id for embedding — and spends one video reveal. On Pro the winning ad is omitted (winning_ad_locked).

`push_to_shopify(opp_id, title?, price?)`

Add a winner to your Shopify store as a draft product — the same push the app’s one-tap button runs, so a product created by your agent is identical to one created in the app. It is not live to shoppers until you activate it in Shopify. If no store is connected, the response carries the connect URL.

Errors come back as codes: subscription_required, no_store, shopify_not_connected, opportunity_not_found, product_limit_reached, shopify_error.

`account_status()`

Your plan, Shopify connection and store domain, plus your daily product-reveal and video-reveal budgets with their reset times.

`list_niches()`

List the product categories available in Flypify.

Plans and limits

The MCP is included with Pro and Shipper. Free accounts can connect, but every tool answers with an upgrade message instead of data. Shipper appears as agency in server responses — same plan.
Pro: find_winners is capped at 100 calls per account per day, and product reveals at 150 per day. Both reset daily; account_status shows the reveal budget that’s left. A product you already revealed on an earlier day returns free — reveals only charge once per product.
Pro: the winning ad inside get_winner is locked — revealing it through the agent is Shipper-only.
Shipper: no daily caps on calls or reveals.

Questions? Contact support. API and MCP terms are in the terms.