install
AEKO Shop runs as an MCP server inside your AI client. One install, one consent, and your agent can browse brands, save preferences, and draft orders on your behalf. No accounts to manage on AEKO Shop itself.
Edit your claude_desktop_config.json and restart Claude. The first call opens a browser consent screen.
{
"mcpServers": {
"aeko-shop-personal": {
"command": "npx",
"args": ["-y", "aeko-shop-mcp", "personal"]
}
}
}One command from your terminal. The next tool call opens a browser consent screen.
claude mcp add --transport stdio aeko-shop-personal \
-- npx -y aeko-shop-mcp personalOne command from your terminal. Or paste the equivalent [mcp_servers] block into ~/.codex/config.toml.
codex mcp add aeko-shop-personal \
-- npx -y aeko-shop-mcp personalDrop the same mcpServers block into ~/.gemini/settings.json and run /mcp reload.
{
"mcpServers": {
"aeko-shop-personal": {
"command": "npx",
"args": ["-y", "aeko-shop-mcp", "personal"]
}
}
}early access
The aeko-shop-mcp package is built and being QA'd before its first npm release. Early testers can install from source — see the repo README for npm link and npm pack instructions. The configs above are the final shape — once published, paste and go.
Drop the snippet into your AI client's MCP config (Claude Desktop / Codex / ChatGPT custom GPT).
The client picks up the new server and opens a one-time browser consent screen.
AEKO shows a plain-language list of what your agent can do (browse, save preferences, draft orders). Click Approve.
That's it. Ask your assistant to find brands, build a cart, or draft an order. AEKO Shop only sees the agent — never you.
are you a brand?
AEKO Brand Agent updates your Featured Products, Hot Deals, and order queue on your brand page. It needs to verify you control your brand's website first.
Connect your brand