How to Use Arditi Collection categories in Windsurf
Returns the furniture collections published by Arditi. Use it to discover the store's category structure before requesting products from a specific collection.
Prompts to try with Arditi Collection categories in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Arditi Collection categories to populate this project's Arditi category navigation with the returned collection names.
Use Arditi Collection categories to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Arditi Collection categories and tell me what changed since last week.
Check Arditi Collection categories and summarize what you find in three bullet points.
Pull the newest data from Arditi Collection categories and give me the result as a table.
How to set up Arditi Collection categories in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Arditi Collection categories
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "arditicollection-com/products/list_collections", "input": { "page": 1 } }'
Then paste one of the prompts above: Windsurf finds Arditi Collection categories on Spiral, shows the price and runs it.
Arditi Collection categories providers and prices
Spiral runs Arditi Collection categories through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 100 | 1 | 1-based page; follow next_page until it is null. |
| Limit | 1 to 250 | 250 | Items per page, Shopify caps at 250. |
Every API field of Arditi Collection · List collections is on its tool page: open its card above.
What can you do with Arditi Collection categories in Windsurf?
Build an Arditi furniture comparison view that puts published dimensions and materials beside each selected design. Use the catalog data to populate category navigation, search results, and product specification views in your project.
Dining room shortlist
Find the dining categories, browse tables and seating, search for walnut designs, and inspect specifications. Add storefront recommendations as extra candidates for the room.
Material comparison
Compare Arditi's wood, resin, glass, and metal descriptions across catalog listings and selected categories. Read individual specifications to distinguish material combinations that look similar in photographs.
Furniture research application
Build a project browser with Arditi categories, catalog browsing, keyword search, product specification views, and storefront recommendations. Link each selection to its original product page.
Weekly catalog review
Compare successive Arditi catalog and category observations to identify added listings, removed listings, and changed product descriptions. Read product details for the pieces that changed.
Project category map
Map Arditi's published categories to dining, living, and office research tasks. Browse the category contents and use catalog listings and keyword searches to find pieces for each project area.
Design presentation preparation
Organize a presentation around Arditi's categories, selected product specifications, and recommended alternatives. Prepare a comparison of dimensions and materials with links to the original listings.
More on Arditi Collection categories and Windsurf
Overview
Arditi Collection categories in other agents
Questions about Arditi Collection categories in Windsurf
Can Windsurf use Arditi Collection categories?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Arditi Collection categories like any built-in tool.
How much does Arditi Collection categories cost in Windsurf?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need an Alexandria account to use Arditi Collection categories in Windsurf?
No. Spiral runs Arditi Collection categories on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Arditi Collection categories in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Arditi Collection categories runs?
Arditi Collection categories runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.
What does the Arditi data cover?
It covers Arditi's public Shopify furniture storefront: collections, product listings, specifications, predictive search, and recommendations. Its documented scope is the public catalog.
Can I tell when Arditi last updated a product?
The provider's Black Atrani Dining Chair example has a null product update timestamp. That example cannot establish the date of Arditi's last product edit.
Does a product search show every matching piece?
Shopify predictive search returns no more than 10 suggestions per request type. Use catalog or category browsing when you need a broader inventory of Arditi furniture.
How are Arditi's product recommendations selected?
The underlying Shopify system can automatically generate similar-product recommendations. Recommendations for accompanying pieces require manual configuration, so their coverage depends on what the store has configured.
Are the published dimensions the only sizes available?
No. Arditi says many pieces can have custom length, width, height, top thickness, seating capacity, and proportions, depending on the product.
Start using Arditi Collection categories in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


