@textile-designer-ai/mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TD_TOKEN | No | Use this session token instead of the stored one (scripted agents, CI). | |
| TD_API_BASE_URL | No | API origin. Default `https://www.textile-designer.ai`. | https://www.textile-designer.ai |
| TD_SESSION_FILE | No | Where to store the token. Default `~/.textile-designer/mcp-session.json`. | ~/.textile-designer/mcp-session.json |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| loginA | Start the device-code login. Returns a URL and a code; the browser opens automatically unless open_browser is false. The server keeps polling in the background: call whoami to confirm, or set wait_seconds to block until linked. |
| whoamiA | Who is connected: email, organisation, credits, plan access, enabled tools. Reports a pending login if one is in progress. |
| boost_unlimitedA | Truly Unlimited plans: Boost doubles today's budget and starts the runs parked in the slow lane now. It uses one of the designer's free monthly boosts or a purchased team boost. Only call it after the user explicitly says yes to using a boost in this conversation. When a boost is already on today it just starts the parked jobs (no boost spent); run_now: true asks for only that. |
| logoutB | End the session on the server and forget the stored token. |
| job_statusA | Status of a submitted job (processing / completed / failed / cancelled) with progress and result URLs. Optionally wait up to wait_seconds for it to finish. |
| download_resultA | Save a completed job's outputs to disk (images, unpacked zips, PSD, Channeling bundle). Use after job_status reports completed, or to fetch a job's files again. |
| list_toolsA | Every design tool with a one-line description and its credit rule. Use this to answer 'what can you do' or to pick a tool; call describe_tool for a tool's modes. |
| describe_toolA | A tool's best use, how it compares with similar tools, what its settings do to the result, its outputs, its modes with what each option does, its settings (the website controls with ranges and recommended values), its credit rule, required inputs and result kind. Call it before running a tool with modes the user has not chosen, or when the user asks what a mode does. |
| guideA | Answers how-to questions from the website's own documentation: which tool fits a goal (choose_tool), typical chains (workflows), how similar tools differ (compare, optionally for one tool), DPI / repeat / format basics (print_basics), where results go and why they can differ from the original (results), estimates, Truly Unlimited and Boost (credits_and_plans), and what to say about the AI models (models). |
| td_ready_to_printA | Ready to Print: make a design print-ready by enlarging it 1-4x with AI detail. Best for: making a finished design print-ready: enlarging low-res buyer, archive or small-format files 1-4x with AI-filled detail and no pixelation, with your target DPI written into the file. Result files are saved to disk and their paths returned. |
| td_anti_blurA | Anti-Blur: sharpen a blurred design. Pro mode (recommended) or Legacy mode; files over 20 MB run in Legacy automatically. Best for: removing blur, noise and softness from a design or photo: out-of-focus or motion-blurred images, soft smartphone fabric photos, blurry social-media references. Result files are saved to disk and their paths returned. |
| td_super_scalerA | Super Scaler: AI enlargement 2x/4x/8x with detail enhancement. Best for: rescuing low-resolution, blurred, compressed or old images (72 dpi archive JPEGs, small web images) by rebuilding lost detail and enlarging up to 8x for large-format printing. Result files are saved to disk and their paths returned. |
| td_background_removalA | Background Removal: remove the background and replace it with solid white. Precision or Ultra model (Unlimited on Unlimited plans). Best for: isolating a subject or motif from its background: extracting photographed motifs to build a new pattern, clean product shots, or prepping a design for layering. Result files are saved to disk and their paths returned. |
| td_watermark_removalA | Watermark Removal: remove watermarks from a design. Standard or AI Pro model. Best for: cleaning watermarks, logos, stamped branding or overlaid text off images you have the rights to modify, e.g. a residual mark on a licensed stock file or old branding on archive designs. Result files are saved to disk and their paths returned. |
| td_repeat_setA | Repeat Set: turn the design into a seamless repeat. Quick repeat types: block (recommended), half_brick, half_drop, mirror, step. Best for: turning a design into a seamless repeating tile for fabric, wallpaper or rotary printing, laid out as a block, half brick, half drop, mirror or step repeat. Result files are saved to disk and their paths returned. |
| td_design_extensionA | Design Extension: extend the design outward by a gap on each side (0-10; not all four 0). Best for: growing a small swatch or centre motif outward in the same style, colour palette and texture, e.g. a swatch photo to full fabric width or a motif out to the fabric edge. Result files are saved to disk and their paths returned. |
| td_border_outlineA | Border Outline: trace the outline of the design. No settings. Best for: a clean outline-only version of a filled design: outline prints for screen printing or outline drawings for tech packs, without tracing by hand. High-contrast, well-defined art works best. Result files are saved to disk and their paths returned. |
| td_object_layeringA | Object Layering: split the design into a layered PSD, one layer per object. Result is a .psd file. Best for: splitting a design into editable layers by object or motif, e.g. to move flowers apart in Photoshop instead of redrawing. Works best with distinct motifs on a contrasting background. Result files are saved to disk and their paths returned. |
| td_colour_layeringA | Colour Layering: separate the design into colour layers in a PSD. Advanced-Q Mode off (simple, recommended) or on (advanced); 2-30 layers or automatic. Result is a .psd file. Best for: turning flat-colour art into one editable layer per colour. Result files are saved to disk and their paths returned. |
| td_style_transferA | Style Transfer: restyle the design with a library style or with the style of a second image (image_to_image). Best for: giving a finished design a new artistic surface look (e.g. Watercolor, Oil Painting) or the look of a second image, while the design layout stays intact. Result files are saved to disk and their paths returned. |
| td_dress_to_designA | Dress to Design: extract the print from a garment photo as a flat design. Modes: advanced_extraction (recommended), fine_detail, inspired_pattern, all_modes (one output per mode). 1-4 outputs. Best for: getting a flat, printable 2D design from a photo of a garment, mockup or outfit (worn by a person, on a mannequin or flat-lay). Result files are saved to disk and their paths returned. |
| td_channelingA | Channeling: separate the design into print screens (spot channels). Returns a multichannel PSD (one channel per screen) plus a preview PNG. Free for a limited time; priced by the server. Best for: preparing a design for screen or rotary printing. Result files are saved to disk and their paths returned. |
| td_color_transferA | Color Transfer: recolour the source design with the palette of a second image. Best for: recolouring an existing design in the palette of another image, e.g. this season's trend colours or a buyer's brand colours, while keeping its structure and composition. Result files are saved to disk and their paths returned. |
| td_color_matching_extract_colorsA | Color Matching step 0: extract the design's palette as JSON (motif and background colours with hex, pantone and percentage). Pass its task_id as extract_task_id to the suggest, match-reference and swatch-grid tools; use the hexes with td_color_matching_replace. Best for: reading a design's motif and background colours (hex, Pantone TCX... Result files are saved to disk and their paths returned. |
| td_color_matching_suggestA | Color Matching Suggest: five palette suggestions for a market and palette type, from the design's extracted palette (extract_task_id or colors). Returns JSON plus mapping sets ready for td_color_matching_replace. Best for: getting trend-aware palette ideas for a target market and palette type. Result files are saved to disk and their paths returned. |
| td_color_matching_match_referenceA | Color Matching Match from reference: recolour plans that match each reference image, from the design's extracted palette (extract_task_id or colors). Returns JSON plus mapping sets for td_color_matching_replace. Best for: matching the design's colours to the colour style of one or more reference images. Result files are saved to disk and their paths returned. |
| td_color_matching_swatch_gridA | Color Matching Auto step 1: one numbered grid image with num_options colour variants, from the design's extracted palette (extract_task_id or colors). Then call td_color_matching_regenerate with the task_id and the variant numbers you like. Best for: quickly previewing several colour variants of the design side by side (Auto mode). Result files are saved to disk and their paths returned. |
| td_color_matching_regenerateA | Color Matching Auto step 2: full-size images for the chosen cells of a swatch grid. image = the ORIGINAL design used for the grid; give grid_task_id (from td_color_matching_swatch_grid) or grid_image_url, and bg_only as in the grid run. Best for: getting clean, full-size versions of the swatch-grid variants you liked. Result files are saved to disk and their paths returned. |
| td_color_matching_replaceA | Color Matching Replace Color: swap specific colours in the design. mappings = one set of {from, to} hex pairs; sets = several alternative sets, one output each (max 15). Get the current hexes from td_color_matching_extract_colors. Best for: swapping specific design colours for exact new values. Result files are saved to disk and their paths returned. |
| td_vectorizerA | Vectorizer: convert the design to vector. ready_for photoshop (png, tiff or eps = Sharp Edged File) or illustrator (svg with curve options, pdf or eps). Best for: turning flat-colour raster art (e.g. a JPEG logo or print) into vector you can recolour, resize and edit in Illustrator, or scale up for large-format printing without quality loss. Result files are saved to disk and their paths returned. |
| td_3d_effectA | 3D Effect: add depth/relief to the design. similar (1-4 outputs) or same (keeps the design fixed, one output). Best for: turning a flat 2D textile design into a 3D look with depth, shadows and embossing, e.g. showing a buyer embossed printing without a physical sample. Clear, well-defined patterns work best. Result files are saved to disk and their paths returned. |
| td_embroidery_effectA | Embroidery Effect: render the design as embroidery. Stitch types: bandhani, kantha, chikankari, zardozi, phulkari, aari, satin, chain, cross, running, french_knot. 13 credits. Best for: previewing a design as realistic embroidery or Indian craftwork (e.g. Zardozi, Chikankari, Phulkari) before sampling. Result files are saved to disk and their paths returned. |
| td_fabric_texture_removalA | Fabric Texture Removal: flatten the fabric weave/texture out of a photographed design. 1-4 outputs. Best for: turning a flat scan or photo of printed fabric into a clean digital design: removes the weave and surface texture while keeping the artwork and its colours, e.g. digitising an old swatch. Result files are saved to disk and their paths returned. |
| td_sketch_to_designA | Sketch to Design: colour a line sketch into a finished design, optionally in a named style. Best for: turning a sketch, line art or wireframe into a full-colour, detailed design, e.g. rough brainstorm sketches into production art. Clear, simple sketches with well-defined lines work best. Result files are saved to disk and their paths returned. |
| td_foil_separationA | Foil Separation: build the foil layer for the design. Modes outline, foiling (recommended), dot, patch; with or without a vector EPS. Best for: making a foil-ready plate from a flat, high-contrast print design, as clean outlines, distressed foiling line art, dots or accent patches. Result files are saved to disk and their paths returned. |
| td_design_generationA | Design Generation: generate a new design from the source image plus a prompt (text_to_image, recommended), re-imagine it with a texture / colour palette (image_to_image), or repaint a masked area (inpaint). The website's Mood Board is not available here. Best for: creating a new design from your image plus a written prompt. Result files are saved to disk and their paths returned. |
| td_design_creationA | Design Creation: generate design variations from the source image. Variants: prime (recommended, 1-5 outputs), new (1-5), old (1-4), reference (1-5). Best for: generating fresh design variations from a reference image without writing prompts, e.g. filling gaps in a collection, building a style-consistent range or exploring concepts quickly. Result files are saved to disk and their paths returned. |
| td_colourwaysA | Colourways: generate colourway options for the design (6, 12, 24 or 48), optionally keeping up to 8 of its colours. grid true also makes a buyer sheet. Best for: a buyer wants the same print in other colours, or a range needs pastel, deep and dark stories from one bestseller. Result files are saved to disk and their paths returned. |
| td_spec_boardA | Spec Board: build a tech-pack style spec board from a garment photo. Give garment_type, or use Reference mode: a reference_image (an existing spec board) whose layout and sections are mimicked. Best for: turning a garment photo (saree, kurti, suit, lehenga, frock or gown) into a professional specification board for production. Result files are saved to disk and their paths returned. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| print_ready_pipeline | Upscale a design for print, make it a seamless repeat, then separate it into print screens (Ready to Print → Repeat Set → Channeling). |
| garment_to_collection | Extract the print from a garment photo, build colourways from it, then produce a spec board (Dress to Design → Colourways → Spec Board). |
| vector_pack | Vectorize a design for Photoshop or Illustrator, then add a Border Outline drawing (Vectorizer → Border Outline). |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Textile Designer result | Preview of a Textile Designer run: the saved images with their paths and the credits charged. |
| Color Matching swatch grid picker | The numbered swatch grid with clickable cells; returns the chosen variant numbers for regeneration. |
TDQS
Scored across 39 tools
Several overlapping clusters exist—image enhancement (td_ready_to_print, td_super_scaler, td_anti_blur), design generation (td_design_generation, td_design_creation), layering (td_object_layering, td_colour_layering, td_channeling), and colour variant tools—so an agent could misselect. The detailed 'Best for' descriptions help mitigate confusion, but boundaries are not always crisp.
Nearly all tools use snake_case, with a clear td_ prefix for design tools and no prefix for system/account tools. However, spelling is inconsistent between British 'colour' (td_colour_layering, td_colourways) and American 'color' (td_color_transfer, td_color_matching_*), and the naming mixes verb and noun styles.
39 tools is well above the 3–15 range for a well-scoped server and exceeds the 25+ threshold for 'too many'. Although each tool represents a distinct design operation, the sheer breadth creates a heavy selection burden for an agent.
The surface covers a wide range of textile design workflows: generation, enhancement, colour manipulation, layering, separation, print prep, and spec boards, plus auth, job, and documentation tools. Minor gaps exist (e.g., no explicit job cancellation or job listing), but agents can work around these via job_status and other tools.