AI assistants (MCP)

Codebeans Wishlyst runs a Model Context Protocol server. Connect an AI assistant to it and ask questions about your wishlists in plain language:

“Which 10 products are wishlisted most this month?”
“Export my wishlist customers as CSV.”
“Which wishlisted products are about to sell out?”
“How much revenue came from wishlists last week?”

Assistants get read-only access. They cannot change wishlists, settings or emails.

Requires a plan that includes AI / MCP Access.

Create an access token

AI / MCP Access (right) and the Automations page (left)

Open AI / MCP Access

Go to Wishlist Settings → AI / MCP Access.

Fill in the form

Token name: something you will recognize, e.g. Claude Desktop.
Access scopes: untick anything the assistant does not need (see below).
Expiry: Never expires, 30 days, 90 days or 1 year.

Copy the token

Tokens start with wsl_. You can view and copy a token again later from Your access tokens.

Scopes

Scope	Label	Gives access to
`read:customers`	Customers	List and search wishlist customers and their wishlists
`read:wishlists`	Wishlists	List wishlists, wishlist items and recent activity
`read:analytics`	Analytics	Dashboard stats, top products, low stock and conversion revenue
`read:billing`	Plan & usage	Current plan, limits and monthly usage
`export`	CSV export	Lets tools return CSV exports

Manage tokens

The Your access tokens table shows each token’s scopes, status (Active, Disabled, Expired, Revoked), when it was last used and when it expires.

Disable pauses a token. Enable turns it back on.
Revoke removes a token permanently. Use it if a token may have leaked.

Connect your assistant

Your MCP endpoint URL is shown under How to connect on the same page. Replace <MCP_URL> and <your-token> below with your values.

Claude Code
Claude Desktop
Other MCP clients

claude mcp add --transport http wishlyst <MCP_URL> \
  --header "Authorization: Bearer <your-token>"

Add this to claude_desktop_config.json (Settings → Developer → Edit config). It uses mcp-remote, so you need Node.js installed.

{
  "mcpServers": {
    "wishlyst": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "<MCP_URL>",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }
  }
}

For Antigravity, Cursor and any client that supports remote HTTP servers:

{
  "mcpServers": {
    "wishlyst": {
      "url": "<MCP_URL>",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

The server uses the Streamable HTTP transport (POST only). Each token can make up to 60 requests per minute. When the limit is reached, the server answers 429 with a Retry-After header.

Tools

The assistant only sees the tools its token has scopes for. Dates use YYYY-MM-DD.

list_customers — read:customers

Paginated wishlist customers, like the Customers page.

Parameter	Default	Notes
`page`	`1`
`pageSize`	`20`	1–100
`search`	—	Name or email, up to 100 characters
`customerType`	`all`	`signon`, `guest` or `all`
`startDate`, `endDate`	—	Filter by wishlist creation date
`format`	`json`	`csv` needs the `export` scope
`includeEmpty`	`false`	Include empty wishlists in CSV

get_customer_wishlists — read:customers

One customer’s wishlists with their items. query (required) is a name, email or numeric customer ID. Also accepts format and includeEmpty.

list_wishlists — read:wishlists

Every wishlist with its customer, product count and total value. Accepts page, pageSize (20), search, includeGuests (true), startDate, endDate, format, includeEmpty.

list_wishlist_items — read:wishlists

Items in one wishlist (wishlistId) or across the whole store. Accepts page, pageSize (50), search, startDate, endDate, format.

get_top_wishlists — read:wishlists

Wishlists with the most items. limit 1–50 (default 10). Also accepts format and includeEmpty.

get_recent_wishlists — read:wishlists

Latest products added to wishlists. limit 1–50 (default 20).

get_dashboard_stats — read:analytics

Signed-in vs guest shoppers, total wishlists, items, unique products and wishlist revenue. Optional startDate, endDate.

get_top_products — read:analytics

Most-wishlisted products with counts. limit (default 10).

get_low_stock_products — read:analytics

Wishlisted products below an inventory threshold. limit (default 10), threshold 1–1000 (default 10).

get_conversion_revenue — read:analytics

Orders and revenue per currency from wishlist orders (tagged cbwishlist-order), with the 20 most recent orders. Optional startDate, endDate.

get_plan_usage — read:billing

Current plan, feature limits (-1 means unlimited) and this billing period’s usage.

CSV exports

With the export scope, tools that accept format: "csv" return CSV with the same columns as the admin Excel export. Output is capped at 10,000 rows. For bigger exports, use Customers → Export → Share With Email in the app.

Security

The app stores only a hash and an encrypted copy of each token.
Give each assistant its own token so you can revoke one without affecting the others.
Pick the fewest scopes the assistant needs, and an expiry when you can.

Theme integration

Integrations

Create an access token

Scopes

Manage tokens

Connect your assistant

Tools

CSV exports

Security

​Create an access token

​Scopes

​Manage tokens

​Connect your assistant

​Tools

​CSV exports

​Security

Create an access token

Scopes

Manage tokens

Connect your assistant

Tools

CSV exports

Security