Back to Home
tisfile mcp server

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.

connect

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/mcp
codex 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
what it does

Photos in. A customiser on every page.

  1. 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. 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. 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. 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.

tools

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 itemslist_items
  • Send files from this machinecreate_upload_link
  • See which files arrived on an upload linklist_uploads
  • Create a 3D item from photoscreate_item
  • Wait for buildswait_for_items
  • Read an itemget_item
  • The images a model was built fromget_item_views
  • Delete an itemdelete_item
  • Rename an item, set its reference or widen its goalupdate_item
  • Delete several itemsdelete_items
  • Rebuild an item (spends a build)rebuild_item
  • The designs lifted from an item's photolist_item_designs
  • See the product as a shopper doesrender_item
  • The Shopify products an item shows onlist_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 modeladd_zones
  • Draw print areas anywhere on the modeldraw_zones
  • See what a print area holdsget_zone
  • Change many print areas at once, and their orderupdate_zones
  • Size, name, move or restyle a print areaupdate_zone
  • Put the merchant's own artwork in a print areaset_zone_artwork
  • Make a print area's design look like its finishrestyle_zone_artwork
  • Put a restyled design back to its flat artworkrestore_zone_artwork
  • Put lettering in a print areaset_zone_lettering
  • Lift a print area's design from the photo againre_extract_zone
  • Put back what a print area showed before its artworkremove_zone_artwork
  • Remove a print areadelete_zone
  • See where the zones sitpreview_zones
  • Place the zones againreset_zones
  • Keep the zones as they areconfirm_zones

Colourways

The colours a shopper switches between, from the product's own colour regions.

  • Colour regions and colourwayslist_colourways
  • Add a colourwaycreate_colourway
  • Set all of an item's colourwaysset_colourways
  • Hide or show the Original swatchset_original_hidden
  • Change a colourwayupdate_colourway
  • Delete a colourwaydelete_colourway
  • Read a colourway off the store's photo of that coloursample_colourway
  • Run the colour analysis againrun_colour_analysis
  • See a colourway on the modelpreview_colours
  • Correct the colour regions by nameedit_colour_regions
  • Colourways from a Shopify product's colourscolourways_from_shopify

Viewers and embeds

The customiser on your page: where it may appear, what shoppers may do, and the snippet.

  • One viewer's resultsget_viewer_activity
  • List viewerslist_viewers
  • Read a viewerget_viewer
  • Where a shopper's work goes, and how the viewer looksupdate_viewer
  • Pause a viewer, or serve it againset_viewer_live
  • Another viewer of an itemcreate_viewer
  • Delete one of an item's viewersdelete_viewer
  • Allow the sites that embed a vieweradd_viewer_origins
  • Stop sites embedding a viewerremove_viewer_origins
  • Change many viewers at oncebulk_update_viewers
  • The embed snippetget_embed
  • A link anyone can open to design itcreate_share_link
  • Turn a share link offrevoke_share_link
  • A viewer's labelled share linkslist_share_links
  • Another link to send the product to a placeadd_share_link
  • Stop one labelled share linkremove_share_link

Quotes and orders

What shoppers sent you, and what they configured for your cart.

  • Requests shoppers sentlist_quotes
  • Read one requestget_quote
  • What to make for one requestget_quote_work_order
  • Move a request through the inboxupdate_quote_status
  • Remove a requestdelete_quote
  • Anonymise a requestredact_quote
  • Send a test requestcreate_test_quote
  • Designs shoppers saved for their cartslist_configurations
  • Read what a shopper configuredget_configuration
  • Save a test design, as a shopper's cart wouldcreate_test_configuration
  • What to make for one cart lineget_configuration_work_order
  • Claim a configuration for an orderclaim_configuration
  • Undo a claimrelease_configuration
  • Delete a test or unclaimed configurationdelete_configuration

Webhooks

Be told when a model finishes or a shopper configures, instead of asking.

  • List webhookslist_webhooks
  • Be told instead of pollingcreate_webhook
  • Change or switch a webhookupdate_webhook
  • Rotate a webhook's secretrotate_webhook_secret
  • List a webhook's deliverieslist_webhook_deliveries
  • Send a delivery againretry_webhook_delivery
  • Delete a webhookdelete_webhook
  • Send a test pingtest_webhook

Account

What is left on your plan, and the free trial.

  • What is left on the planget_account
  • Start the free trialstart_trial
  • The account's default originsupdate_account_settings

More

  • The developer guideget_guide
  • A link for the merchant to mint a checkout keyrequest_checkout_key
  • Revoke this key or connectionrevoke_own_key
  • The planslist_plans
  • A link for the merchant to choose a plancreate_plan_link
  • Change the monthly overage ceilingset_overage_ceiling
  • What a month spentget_usage
  • What the customizers didget_analytics
  • Where request emails goget_request_recipients
  • Send request emails to another addressset_request_recipients
  • The store at a glanceget_store_summary
  • Read a product from its pageread_product_page
  • A product read from its pageget_product_import
  • Products read from their pageslist_product_imports
  • Check photos before a buildcheck_photos
  • Put a photo into one view before a rebuildreplace_view
  • Redo one view through a pipeline stepregenerate_view
  • Make a recolour variantcreate_variant
  • List an item's variantslist_variants
  • Get the 3D model fileget_model
  • Read the colours of the product's partsdetect_palette
  • The merchant's design librarylist_assets
  • One design in the libraryget_asset
  • Add a design to the librarycreate_asset
  • Rename or star a designupdate_asset
  • Delete a design from the librarydelete_asset
  • The fonts lettering is made inlist_fonts
  • Change a print area's letteringupdate_lettering
  • One snippet for every product pageget_store_snippet
  • Replace the store keyrotate_store_key
  • The connected Shopify storeslist_shopify_stores
  • A connected store's productslist_shopify_products
  • One product of a connected storeget_shopify_product
  • Sort a store product's photossort_shopify_photos
  • Take an item off a Shopify product pageunlink_shopify_product
  • Put the item's 3D in a Shopify product's gallerypublish_shopify_3d
  • A Shopify product's 3D mediaget_shopify_3d
  • Take the item's 3D out of a Shopify product's galleryremove_shopify_3d
  • Show an item on a Shopify product pagelink_shopify_product
  • Send one shopper to the hosted customizercreate_portal_session
  • The event loglist_events
  • Convert a catalogue as one jobcreate_batch
  • A batch and its productsget_batch
  • The account's batcheslist_batches
  • Stop a batchcancel_batch
  • Carry on a paused batchresume_batch
cost and access

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.

rest api

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.

questions

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.
start

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