MCP App Store
by KeenEthics
Gentoo icon

Gentoo MCP Server for ChatGPT

By Waddle Labs Inc.

Overview

Gentoo is a growth agent for Shopify merchants. It finds conversion blockers on your storefront and product pages, prepares fixes as Actions with before and after previews, and measures results against your Store Goal. With this plugin you can review your current Goal and propose a new one, browse Opportunities, preview and approve Actions, see how your Goal metric and funnel are moving, and chat with Gentoo, which remembers your store. Every change to your live store shows a preview first and needs your explicit approval. Requires a Shopify store with the Gentoo app installed and a store connection key from Shopify Admin > Gentoo > Settings > Connectors.

How to connect

  1. ChatGPT: Open the Gentoo listing in the ChatGPT app directory and choose Connect. ChatGPT listing Gentoo exposes 33 tools here.

Tools

gentoo_action_approve

ChatGPT
Approve and publish an Action to the live store. Requires expectedReviewFingerprint (or approvalViewFingerprint) from gentoo_action_preview and explicit user confirmation.

gentoo_action_get

ChatGPT
Get the version state, version history, and revision progress of one Action.

gentoo_action_list

ChatGPT
List Actions as short summaries (name, status, credits, dates, linked opportunities), 25 per page; pass nextCursor for more. statusCounts gives the count of every status, so counting needs no paging. Cancelled Actions are hidden unless status asks for them. Use gentoo_action_preview for the Before/After change, credit cost and approval fingerprint, and gentoo_action_get for version history.

gentoo_action_pause

ChatGPT
Decline a pending Action so it is not published. Confirm with the merchant first.

gentoo_action_preview

ChatGPT
Inspect the Before/After preview comparison, capture URLs, credit cost, approvalViewFingerprint (reviewFingerprint), and live preview URL for an Action before approval.

gentoo_action_restore

ChatGPT
Restore an Action to the revision before the latest merchant correction. This replaces the current draft.

gentoo_action_rollback

ChatGPT
Roll back a deployed Action on the live store (mode defaults to safe_only).

gentoo_action_rollback_preview

ChatGPT
Preview what rolling back a deployed Action on the live store would restore (clean, already_restored, drifted, unverifiable).

gentoo_chat_ask

ChatGPT
Send a message to the Gentoo chat. Each call sends a new message, so a retry sends it again. Returns turn_id and session_id right away, not the answer: Gentoo replies in the background, so read the reply with gentoo_chat_sessions(sessionId, turnId, waitSeconds: 20), repeating if it is not there yet. To attach an image or file (at most 5), upload it first with gentoo_chat_attachment_prepare_upload and pass the returned s3Key in attachments. A key can be reused across ordinary conversations. An Action's conversation (sessionId starting with action-) shares keys with no other conversation; if Gentoo says the attachment belongs to a different conversation, upload the file again.

gentoo_chat_attachment_get

ChatGPT
Show a chat image or file by its s3_key (from gentoo_chat_sessions history). Returns the image inline when it is under 5MB, plus a 5-minute download URL.

gentoo_chat_attachment_prepare_upload

ChatGPT
Prepare an upload of a local file for the Gentoo chat (images: png, jpeg, webp, gif; also pdf, csv, txt). This tool does not upload the file: it returns an s3Key and a curl command that is valid for 5 minutes. Run the curl command with the local file path from a shell, then pass {s3Key, mediaType, filename} in gentoo_chat_ask attachments. Without a shell, ask the merchant to attach the file in the Gentoo app instead.

gentoo_chat_inbox

ChatGPT
Get Home inbox items, recommendations, and recent activity from Gentoo.

gentoo_chat_sessions

ChatGPT
List Gentoo conversation sessions, or fetch the messages of one sessionId as the merchant sees them in the chat (text, attachments, cards, errors). Images appear as s3_key; show them with gentoo_chat_attachment_get.

gentoo_credit_history

ChatGPT
List credit ledger transactions (charges, refunds, grants).

gentoo_credit_status

ChatGPT
Get current billing cycle credit balance, plan allowance, and status.

gentoo_credit_usage

ChatGPT
Get credit usage breakdown for the current cycle.

gentoo_goal_current

ChatGPT
Get the current active Store Goal including objective, metric, direction, scope, and rationale.

gentoo_goal_history

ChatGPT
List historical Store Goals for the current store.

gentoo_goal_metric_select

ChatGPT
Choose the metric a new Store Goal should target. Required before gentoo_goal_propose; it does not change the current Goal. Replaces any metric chosen earlier for the next proposal. Metrics: sessions (organic search sessions), add_to_cart_rate, checkout_start_rate, purchase_conversion_rate, online_aov (average order value), bounce_rate.

gentoo_goal_proposal

ChatGPT
Poll or retrieve a generated Store Goal proposal by generationId.

gentoo_goal_propose

ChatGPT
Start a Store Goal proposal generation based on merchant input. Call gentoo_goal_metric_select first with the same expectedGoalId; without a chosen metric this fails with 409. Returns generationId; generation usually takes 1 to 3 minutes, so call gentoo_goal_proposal with waitSeconds: 20 until it is no longer running. Nothing changes until gentoo_goal_select.

gentoo_goal_select

ChatGPT
Confirm and activate a proposed Store Goal candidate. Replaces the current Goal and resets open Opportunities.

gentoo_opportunity_comment

ChatGPT
Post a merchant comment or revision request on one Opportunity. Gentoo reads it and may revise the draft change for that Opportunity; nothing is published without approval. Each call posts a new comment, so a retry posts it again.

gentoo_opportunity_comments

ChatGPT
List the merchant comments and revision requests on one Opportunity, with Gentoo replies.

gentoo_opportunity_decline

ChatGPT
Decline an Opportunity so Gentoo stops preparing changes for it. Confirm with the merchant first.

gentoo_opportunity_get

ChatGPT
Get full detail for one Opportunity: the issue found, the linked Actions, version history, and preparation progress.

gentoo_opportunity_list

ChatGPT
List Gentoo-initiated Opportunities and summary counts (active, published, closed).

gentoo_performance_summary

ChatGPT
Read the Performance tab for the current Goal or an earlier Goal period: Overall (the Goal metric and funnel since the Goal started, compared with the weeks before), notes on these numbers, Changes during this Goal, and Week by week for each funnel metric. These are observed store-level numbers: say how a metric moved and whether that is in the Goal direction, but never say an action or Gentoo caused a change, never estimate the share of one action, and do not call the Goal achieved or failed. Without goalId it reads the current Goal; pass an id from goals to read an earlier Goal period. Each Week by week row shows the Goal's own scope and lists its other scopes; pass one scope key to include that scope's weekly series.

gentoo_shop_deploy_mode_get

ChatGPT
Get the current store deploy mode (manual or auto).

gentoo_shop_deploy_mode_set

ChatGPT
Switch the store between manual and auto deploy mode. In manual mode every Action waits for the merchant's approval. In auto mode Gentoo publishes eligible Actions to the live store without a separate approval for each one, and this also applies to Actions that are already waiting. Only call this after the merchant explicitly confirms the change in the current conversation.

gentoo_shop_email_prefs_get

ChatGPT
Get recurring approval reminder email preferences and delivery timezone.

gentoo_shop_email_prefs_set

ChatGPT
Update the approval reminder email preference or its delivery timezone (IANA). This replaces the current setting.

gentoo_shop_info

ChatGPT
Get store profile, subscription status, and notification recipient info.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/gentoo"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/gentoo)