Add our MCP. Your agent puts your store in 3D.
Add TisFile to Claude Code, Codex or another coding agent and sign in, then ask for 3D product pages. Your agent sends each product's photos to TisFile Studio, puts a customiser shoppers can personalise on every page while the models build, and tells you what each shopper configured.
claude mcp add --transport http tisfile https://tisfile.com/api/mcp
That is Claude Code. Then run /mcp and sign in to TisFile in your browser. Every other agent is below.
One line, then sign in.
Claude Code
claude mcp add --transport http tisfile https://tisfile.com/api/mcp
Then run /mcp, choose tisfile and authenticate: TisFile opens in your browser to sign in. No key to copy.
Codex
codex mcp add tisfile --url https://tisfile.com/api/mcpcodex mcp login tisfile
The login opens TisFile in your browser to sign in. No key to copy.
claude.ai and Claude Desktop
https://tisfile.com/api/mcp
Open Customize, Connectors, Add custom connector, paste the URL and sign in to TisFile.
Cursor, VS Code and other editors
https://tisfile.com/api/mcp
Add the URL as a remote MCP server in your editor's settings, then sign in to TisFile when it asks.
Scripts and CI
Nothing to sign in from? Create a key on the API & MCP page of your dashboard. It is shown once, so store it straight away, export it as TISFILE_API_KEY, and add the server with it:
claude mcp add --transport http tisfile https://tisfile.com/api/mcp --header "Authorization: Bearer $TISFILE_API_KEY"
In Codex, name the variable instead, so the key never lands in its config:
codex mcp add tisfile --url https://tisfile.com/api/mcp --bearer-token-env-var TISFILE_API_KEY
Photos in. A customiser on every page.
- 1
Your agent sends the photos
By their public URLs, or from your own disk through an upload link. Each product becomes an item, and its viewer exists at once.
- 2
It embeds the customiser while the model builds
On a site you own the code of, it adds the embed to each product page and your domain to the viewer. On any other store it hands you the snippet to paste.
- 3
It sets up what shoppers may change
Print areas where a logo, text or drawing goes, how each is made (print, embroidery, engraving and more), and the colourways shoppers switch between.
- 4
You choose where a shopper's work goes
A quote request in your inbox, or a line on your own cart carrying what they configured, which your agent can read and claim for the order.
127 tools, by job.
Each one is a call to the TisFile API, run with your own sign-in or key, so it is held to the same limits, the same allowances and the same checks as the dashboard.
Products and 3D builds
Photos in by URL or from your disk, a 3D model out, and a way back when a build goes wrong.
- List items
list_items - Send files from this machine
create_upload_link - See which files arrived on an upload link
list_uploads - Create a 3D item from photos
create_item - Wait for builds
wait_for_items - Read an item
get_item - The images a model was built from
get_item_views - Delete an item
delete_item - Rename an item, set its reference or widen its goal
update_item - Delete several items
delete_items - Rebuild an item (spends a build)
rebuild_item - The designs lifted from an item's photo
list_item_designs - See the product as a shopper does
render_item - The Shopify products an item shows on
list_item_shopify_products
Print areas
Where a shopper's logo, text or drawing goes, how big it is, and how it is made.
- Add print areas placed on the model
add_zones - Draw print areas anywhere on the model
draw_zones - See what a print area holds
get_zone - Change many print areas at once, and their order
update_zones - Size, name, move or restyle a print area
update_zone - Put the merchant's own artwork in a print area
set_zone_artwork - Make a print area's design look like its finish
restyle_zone_artwork - Put a restyled design back to its flat artwork
restore_zone_artwork - Put lettering in a print area
set_zone_lettering - Lift a print area's design from the photo again
re_extract_zone - Put back what a print area showed before its artwork
remove_zone_artwork - Remove a print area
delete_zone - See where the zones sit
preview_zones - Place the zones again
reset_zones - Keep the zones as they are
confirm_zones
Colourways
The colours a shopper switches between, from the product's own colour regions.
- Colour regions and colourways
list_colourways - Add a colourway
create_colourway - Set all of an item's colourways
set_colourways - Hide or show the Original swatch
set_original_hidden - Change a colourway
update_colourway - Delete a colourway
delete_colourway - Read a colourway off the store's photo of that colour
sample_colourway - Run the colour analysis again
run_colour_analysis - See a colourway on the model
preview_colours - Correct the colour regions by name
edit_colour_regions - Colourways from a Shopify product's colours
colourways_from_shopify
Viewers and embeds
The customiser on your page: where it may appear, what shoppers may do, and the snippet.
- One viewer's results
get_viewer_activity - List viewers
list_viewers - Read a viewer
get_viewer - Where a shopper's work goes, and how the viewer looks
update_viewer - Pause a viewer, or serve it again
set_viewer_live - Another viewer of an item
create_viewer - Delete one of an item's viewers
delete_viewer - Allow the sites that embed a viewer
add_viewer_origins - Stop sites embedding a viewer
remove_viewer_origins - Change many viewers at once
bulk_update_viewers - The embed snippet
get_embed - A link anyone can open to design it
create_share_link - Turn a share link off
revoke_share_link - A viewer's labelled share links
list_share_links - Another link to send the product to a place
add_share_link - Stop one labelled share link
remove_share_link
Quotes and orders
What shoppers sent you, and what they configured for your cart.
- Requests shoppers sent
list_quotes - Read one request
get_quote - What to make for one request
get_quote_work_order - Move a request through the inbox
update_quote_status - Remove a request
delete_quote - Anonymise a request
redact_quote - Send a test request
create_test_quote - Designs shoppers saved for their carts
list_configurations - Read what a shopper configured
get_configuration - Save a test design, as a shopper's cart would
create_test_configuration - What to make for one cart line
get_configuration_work_order - Claim a configuration for an order
claim_configuration - Undo a claim
release_configuration - Delete a test or unclaimed configuration
delete_configuration
Webhooks
Be told when a model finishes or a shopper configures, instead of asking.
- List webhooks
list_webhooks - Be told instead of polling
create_webhook - Change or switch a webhook
update_webhook - Rotate a webhook's secret
rotate_webhook_secret - List a webhook's deliveries
list_webhook_deliveries - Send a delivery again
retry_webhook_delivery - Delete a webhook
delete_webhook - Send a test ping
test_webhook
Account
What is left on your plan, and the free trial.
- What is left on the plan
get_account - Start the free trial
start_trial - The account's default origins
update_account_settings
More
- The developer guide
get_guide - A link for the merchant to mint a checkout key
request_checkout_key - Revoke this key or connection
revoke_own_key - The plans
list_plans - A link for the merchant to choose a plan
create_plan_link - Change the monthly overage ceiling
set_overage_ceiling - What a month spent
get_usage - What the customizers did
get_analytics - Where request emails go
get_request_recipients - Send request emails to another address
set_request_recipients - The store at a glance
get_store_summary - Read a product from its page
read_product_page - A product read from its page
get_product_import - Products read from their pages
list_product_imports - Check photos before a build
check_photos - Put a photo into one view before a rebuild
replace_view - Redo one view through a pipeline step
regenerate_view - Make a recolour variant
create_variant - List an item's variants
list_variants - Get the 3D model file
get_model - Read the colours of the product's parts
detect_palette - The merchant's design library
list_assets - One design in the library
get_asset - Add a design to the library
create_asset - Rename or star a design
update_asset - Delete a design from the library
delete_asset - The fonts lettering is made in
list_fonts - Change a print area's lettering
update_lettering - One snippet for every product page
get_store_snippet - Replace the store key
rotate_store_key - The connected Shopify stores
list_shopify_stores - A connected store's products
list_shopify_products - One product of a connected store
get_shopify_product - Sort a store product's photos
sort_shopify_photos - Take an item off a Shopify product page
unlink_shopify_product - Put the item's 3D in a Shopify product's gallery
publish_shopify_3d - A Shopify product's 3D media
get_shopify_3d - Take the item's 3D out of a Shopify product's gallery
remove_shopify_3d - Show an item on a Shopify product page
link_shopify_product - Send one shopper to the hosted customizer
create_portal_session - The event log
list_events - Convert a catalogue as one job
create_batch - A batch and its products
get_batch - The account's batches
list_batches - Stop a batch
cancel_batch - Carry on a paused batch
resume_batch
Your plan, your say.
What it costs
Included on every plan and in the free 7-day trial. Your agent spends the same two allowances as the dashboard: a 3D build per product, and an AI customisation when a shopper uses one. Colourways, print areas, embeds and quotes cost nothing. On a new account it asks you before it starts your free week. The plans and what they include are on the pricing page.
What it may do
When you sign in, you choose: Build and change, or Look only, where nothing is changed and nothing is built. You can disconnect an agent at any time under API & MCP in your dashboard, and revoke a key there too.
Prefer plain HTTP?
Every tool is also a REST call, so your own code can do everything your agent can.
curl https://tisfile.com/api/v1/account \-H "Authorization: Bearer tf_live_..."
The full reference, written to be read by people and coding agents alike, is llms-api.txt. Read it before you start: it names the few choices that cannot be undone, and the ones that cost a rebuild. Embedding by hand instead? The Studio docs have the snippet.
Asked before connecting.
- What is the TisFile MCP server?
- A remote MCP server at https://tisfile.com/api/mcp that gives a coding agent the tools to turn product photos into interactive 3D models shoppers can personalise, and to put that customiser on your store. It speaks Streamable HTTP, so there is nothing to install.
- Which agents can use it?
- Any MCP client that connects to a remote server, including Claude Code, Codex, Cursor, VS Code, claude.ai and Claude Desktop.
- Do I need an API key?
- No. Add the server and sign in through your browser; there is no key to copy. Keys are for scripts and CI, which have no browser to sign in from.
- What does it cost?
- It is included on every plan and in the free 7-day trial. Your agent spends the same two allowances as the dashboard: a 3D build per product, and an AI customisation when a shopper uses one. Colourways, print areas, embeds and quotes cost nothing.
- Can my agent add the customiser to my store?
- Yes, on a site you own the code of: it adds the embed to your product pages and your domain to each viewer. On a store whose code you do not edit, it hands you the embed code to paste.
- What can the agent change on my account?
- What you allow when you sign in: Build and change, or Look only, where nothing is changed and nothing is built. You can disconnect it at any time under API & MCP in your dashboard.
- Is there a REST API as well?
- Yes. Every MCP tool is also a REST call on https://tisfile.com/api/v1, with the same limits, documented at https://tisfile.com/llms-api.txt.
Then ask your agent for 3D product pages.
Paste the line, sign in, and ask. Keys for scripts and CI, and the apps you have connected, are on the API & MCP page of your dashboard.
claude mcp add --transport http tisfile https://tisfile.com/api/mcp