Help Center

Connect your AI assistant to SwatchFree

SwatchFree supports the Model Context Protocol (MCP). External assistants such as ChatGPT, Claude or Cursor can search our fabric catalogue, save fabrics to your library and check your orders — always on your behalf, after you approve the connection.

1. Connect

Add this MCP server URL in your assistant's connector settings:

https://swatchfree.com/mcp

OAuth settings are discovered automatically from /.well-known/oauth-protected-resource — nothing to fill in manually.

2. Authorise

Start the connection in your assistant.
You are redirected to the SwatchFree sign-in page.
Review the consent screen (“Connect [assistant] to your account”) and click Approve.
The assistant can now reach the public fabric catalogue plus your own favourites and orders — never another user's data.

3. Available tools

`search_fabrics`

Search the fabric catalogue by keyword, category, colour family, pattern or composition.

{
  "query": "cotton poplin",
  "category": "woven",
  "color_family": "blue",
  "pattern": "solid",
  "composition": "cotton",
  "limit": 10
}

query matches fabric name, search text and SKU.
limit: 1–30, default 10.

`get_fabric`

Get the full specification of one fabric by SKU or ID.

{ "sku": "SF-1024" }

Provide either sku or id.

`list_my_favorites`

List the fabrics saved in your personal library.

{ "limit": 20 }

limit: 1–100, default 20.
Returns SKU, name, category, composition, gsm, colour and cut-sample price.

`save_fabric`

Add a fabric to your personal library.

{ "sku": "SF-1024" }

Provide either sku or id.
Saving twice will not create a duplicate.

`list_my_orders`

List your swatch box and cut-sample orders with their shipping status.

{ "limit": 10 }

limit: 1–50, default 10.
Returns order number, type, status, box tier, total, fabrics and tracking info.

4. Example prompts

“Find me 100% cotton wovens suitable for shirting.”
“What is SF-1024?”
“Add SF-1024 to my fabric library.”
“Where is my latest swatch order?”

5. Troubleshooting

Not authenticated — sign in and approve the connection again.
Fabric not found — the SKU or ID does not exist; search again with search_fabrics.
Missing parameter — e.g. get_fabric needs either sku or id.

Still stuck? Email hello@swatchfree.com.