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.
Paste this into ~/.codex/config.toml. Same config works for the Codex desktop app and the Codex CLI — restart Codex (or start a new Codex CLI session) after saving.
[mcp_servers.aeko-shop-personal]
command = "npx"
args = ["-y", "aeko-shop-mcp", "personal"]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 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, Codex, Gemini, or any MCP-compatible agent).
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