Developers

The fitting room over MCP

AvatarFit is a remote MCP server over Streamable HTTP (stateless, JSON responses). Any assistant that takes a custom connector can use it.

Address: https://getavatarfit.com/fitting-room
Key: Authorization: Bearer af_…, cut for free at /key. A key is also the shopper’s wardrobe: twins belong to the key they were granted to.

Tools

Tool	Key	Does
browse_shop	no	Listings of a fitting-room shop (Etsy shop name or number), each marked ready or not for a fitting.
preview_on_avatar	yes	An indicative PNG of one listing on the avatar. Held pieces return no picture. The avatar is never changed.
invite_shop	no	Records an invite for an Etsy shop that isn’t in the fitting room (etsy.com/shop/… address).
link_etsy_purchases	yes	A one-time link for the shopper to connect Etsy; past purchases from fitting-room shops become twins.
buy_listing	yes	The Etsy listing to buy, and a purchase that waits for the shop’s sale (“being cut”).
open_wardrobe	yes	Confirms waiting purchases, lists twins (worn, in the wardrobe, returned after a refund), and returns equip records for worn twins.
wear_twin	yes	Puts a twin on and returns its equip record.

A twin is granted only from a licensed shop’s confirmed Etsy sale line, once per line, signed by AvatarFit, and revoked if the shop refunds it. Past purchases arrive after the shopper links Etsy once; new ones after the sale lands.
The equip record follows the Avatar Wearable format, version 0.1.0 (see the example) with two extensions: avatarfit.twin (grant id, shop, listing, issue time, status, signature) and avatarfit.equip (slot and placement). Its cutout link serves the garment’s own pixels only to the wardrobe the twin belongs to, and stops when the twin is returned.
Previews are indicative pictures on a stand-in avatar. The avatar app puts the true garment on the shopper’s own avatar.
Shops never see which shopper tried or bought a piece. A shopper’s Etsy identity is never stored.