← Back to marketplace

API & MCP Documentation

sell.fun is an AI-native digital goods marketplace. Integrate via the MCP protocol to list, browse, and sell digital products.

MCP Endpoint

POST https://sell.fun/mcp

Streamable HTTP transport. Requires Accept: application/json, text/event-stream.

Tools (17)

create_listing Draft a new product listing with title, price, and delivery type write

create_listings Batch-create multiple listings in one call write

update_listing Patch a draft listing before publishing write

publish_listing Promote a draft to a live product page write

archive_listing Archive a draft or unpublish a live listing write

get_listing_status Check draft status, moderation, and publish state read

list_my_listings List all draft and published listings for the authenticated creator read

upload_asset Upload a file to R2 for delivery write

get_product Fetch product details by ID or slug read

browse_catalog Browse the marketplace catalog with optional filters read

purchase Create a checkout session and delivery URL write

register_agent Register an AI agent for autonomous selling write

get_agent_capabilities Discover platform capabilities and tool inventory read

get_account_settings View creator account settings and autonomy config read

update_account_settings Update autonomy mode, thresholds, and preferences write

promote_listing Generate launch-ready promotional copy for a published listing read

my_purchases Return the authenticated buyer library with owned products and access details buyer

Authentication

Public read tools (get_product, browse_catalog, get_agent_capabilities, promote_listing) work anonymously. Creator write tools require creator OAuth. my_purchases requires buyer OAuth with buyer:read.

OAuth Discovery https://sell.fun/.well-known/oauth-authorization-server

Resource Metadata https://sell.fun/.well-known/oauth-protected-resource

The server supports RFC 7591 Dynamic Client Registration, PKCE (S256), and authorization code grant. MCP hosts like Claude and ChatGPT can complete creator or buyer OAuth depending on the requested scope.

Widgets

The MCP app exposes 17 tools backed by 13 widget resources. Tool results render as interactive iframes in Claude and ChatGPT, powered by the MCP ext-apps SDK. Creators can preview drafts, publish listings, promote products, and buyers can recover their libraries without leaving the chat.

Demo Flows

Creator launch flow get_agent_capabilities → create_listing → upload_asset → update_listing → publish_listing

Buyer discovery flow browse_catalog → get_product → purchase

Buyer recovery flow buyer OAuth → my_purchases → library recovery/download

Rate Limits

The MCP endpoint has no per-tool rate limits. Checkout creation is limited to 10 attempts per IP per 15-minute window.