MCP server

At a glance

Transport

Streamable HTTP, one JSON-RPC message per request

Protocol revisions

2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

Authentication

OAuth 2.1 authorization code with PKCE, one store per connection

Tools

65 named tools, one for each task

Guides

• Connect an agent

  Add the Sign Customiser connector to Claude, ChatGPT, Codex, Cursor or the MCP Inspector, and approve the scopes it asks for.

• Authentication

  How the connector authenticates: discovery, dynamic registration, PKCE, the resource binding, token lifetimes and revoking a connection.

Permissions

A connection holds only what the merchant approved on the consent screen. Each tool's reference page names the permission it needs, and a tool called without it answers with the name of the permission to approve rather than failing silently.

customisers:readView customisers

See your sign customisers and how they are set up, including their colours, fonts, sizes and other options.

customisers:writeManage customisers

Create sign customisers and change their setup and options. This can change what shoppers see on your storefront.

pricing:readView pricing

See your pricing rules and work out the price of a sign without changing anything.

pricing:writeManage pricing

Change the pricing rules your customisers sell at. This changes the prices shoppers are quoted.

products:readView products

See the products created from your customisers, including their images and design details.

products:writeCreate products

Create products from your customisers, including their product images.

orders:readView orders

See your orders and their design, production and delivery details.

orders:writeCreate orders

Create orders and hand them off for production. Orders can reach your manufacturer.

quotes:readView quotes

See the quotes and design enquiries shoppers have submitted.

webhooks:readView webhooks

See which webhook subscriptions your store sends events to.

webhooks:writeManage webhooks

Add, change and remove webhook subscriptions. A subscription sends order, product or form events from your store to a web address. To add or change a subscription, the connection must also have the view permission for its events: View orders, View products or View quotes.

store:readView store details

See your store profile, currency, units and which integrations are switched on.

analytics:readView analytics

See your sales, product and order totals over time.

ai_sign_designs:readView AI sign designs

See the limits of the AI sign designer, your credit balance and the status of the images that you upload to it.

ai_sign_designs:writeUse the AI sign designer

Upload images to the AI sign designer and start designs from them. Each design that the AI sign designer delivers uses one credit.

• search_docsread

  Look up how Sign Customiser documents something, rather than inferring it from a tool result.

• get_storereadstore:read

  Identify the Store the connection acts for, report which scopes the merchant approved, and read the currency, units, revision and writable integration_id the commerce writes require, before calling anything else.

• get_store_subscriptionreadstore:read

  Tell a merchant whether their plan covers what they are asking for, before suggesting a change that their plan would refuse.

• get_analytics_summaryreadanalytics:read

  Answer "how is the store doing" without reading orders one by one.

• list_customiser_prototypesreadcustomisers:read

  Discover which kinds of sign product this Store can create a customiser for, and get the prototype id that creation takes.

• list_customisersreadcustomisers:read

  Discover what a Store sells and obtain the customiser ids the rest of the customiser surface takes.

• get_customiserreadcustomisers:read

  Read one customiser before changing it, and read its settings or labels document in the same call.

• create_customiserwritecustomisers:write

  Add a new configurable sign product to the Store, starting from a prototype rather than from nothing.

• update_customiserdestructive writecustomisers:write

  Change a customiser name, styling mode, behavioural settings or storefront labels, one section at a time.

• set_customiser_statuswritecustomisers:write

  Publish a customiser to the storefront, withdraw it, or bring a deleted one back.

• delete_customiserdestructive writecustomisers:write

  Remove a customiser from the Store after the merchant has agreed to it.

• list_customiser_optionsreadcustomisers:read

  Discover what a customiser offers in one option family, and obtain the record ids the option read and write tools take.

• get_customiser_optionreadcustomisers:read

  Read the current values of one option record before patching it, and see which of its asset slots are filled.

• create_customiser_optiondestructive writecustomisers:write

  Add one option a shopper can pick from — a colour, a font, a size, a mounting — to one customiser.

• update_customiser_optiondestructive writecustomisers:write

  Change one option a shopper picks from, without touching the rest of its family.

• reorder_customiser_optionsdestructive writecustomisers:write

  Put one option family in the order the merchant wants shoppers to see.

• delete_customiser_optiondestructive writecustomisers:write

  Take one option off a customiser after the merchant has agreed to it.

• create_uploadwritecustomisers:write

  Reserve a staging target for one file, before attaching it to an option image, a font, a backboard shape or the storefront product image.

• get_uploadreadcustomisers:read

  Check whether a staged upload is ready to attach, or why it was rejected.

• attach_customiser_assetdestructive writecustomisers:write

  Put an uploaded file into one asset slot on one option record, or on the customiser labels document.

• delete_customiser_assetdestructive writecustomisers:write

  Take a file out of one asset slot, leaving the record itself in place.

• list_customiser_languagesreadcustomisers:read

  See which languages a customiser offers and how complete each translation is.

• get_customiser_languagereadcustomisers:read

  Read one language record, and read a bounded slice of its translation entries when the strings themselves are needed.

• create_customiser_languagewritecustomisers:write

  Start a new storefront language for a customiser, which the merchant then translates and publishes.

• update_customiser_language_translationsdestructive writecustomisers:write

  Translate a language a page at a time, or correct individual draft values, before the language is published.

• publish_customiser_languagedestructive writecustomisers:write

  Put a translated language live on the storefront after the merchant has reviewed it and agreed.

• set_default_customiser_languagedestructive writecustomisers:write

  Change which language the storefront falls back to, after the merchant has agreed to it.

• cancel_customiser_language_translationdestructive writecustomisers:write

  Stop a running AI translation, usually so the language can be published or deleted, after the merchant has agreed to it.

• delete_customiser_languagedestructive writecustomisers:write

  Remove a language from a customiser after the merchant has agreed to it.

• get_customiser_pricingreadpricing:read

  Read the pricing rules a customiser applies, in the exact document shape a pricing replacement takes back.

• update_customiser_pricingdestructive writepricing:write

  Change what a customiser charges: its rates, modifiers, minimums and rounding rules.

• preview_pricereadpricing:read

  Answer "what would this cost?" for one design, at the price the customiser itself would charge.

• list_customiser_font_tiersreadpricing:read

  Find the font tiers a simple_letter customiser prices its fonts by, and obtain the tier ids the other font tier tools take.

• get_customiser_font_tierreadpricing:read

  Read the prices one font tier charges, in the shape update_customiser_font_tier takes back.

• create_customiser_font_tierdestructive writepricing:write

  Add a price list that a simple_letter customiser can charge its fonts by.

• update_customiser_font_tierdestructive writepricing:write

  Change the name, letter pricing mode or prices of one font tier.

• delete_customiser_font_tierdestructive writepricing:write

  Remove a font tier that no font prices by any more, after the merchant has agreed to it.

• list_customiser_length_pricingsreadpricing:read

  Find the length pricings an advanced_letter or frame_fit customiser charges by, and obtain the ids the other length pricing tools take.

• get_customiser_length_pricingreadpricing:read

  Read the prices and shipping settings of one length pricing, in the shape update_customiser_length_pricing takes back.

• create_customiser_length_pricingdestructive writepricing:write

  Add a price list that an advanced_letter or frame_fit customiser can charge signs by.

• update_customiser_length_pricingdestructive writepricing:write

  Change the name, letter pricing, shipping settings or boundary rows of one length pricing.

• delete_customiser_length_pricingdestructive writepricing:write

  Remove a length pricing that nothing prices by any more, after the merchant has agreed to it.

• list_integration_productsreadproducts:read

  See what customers have bought or configured, and obtain the product ids get_integration_product takes.

• get_integration_productreadproducts:read

  Read one product in full, and resolve the option ids its design captured back to the customiser configuration.

• create_integration_productwriteproducts:write

  Record a product bought through a custom integration against the customiser that designed it, so Sign Customiser can hand it to production.

• list_ordersreadorders:read

  Survey a Store trading activity and obtain the order ids get_order takes, without pulling customer data into the answer.

• get_orderreadorders:read

  Read one order end to end when the line items, totals or the customer snapshot are what the merchant asked about.

• create_orderdestructive writeorders:write

  Record an order bought through a custom integration, so Sign Customiser hands its designs to production.

• export_ordersdestructive writeorders:write

  Send the merchant a spreadsheet of the Store orders in a date range, in the same CSV format the merchant admin export uses.

• resend_order_emaildestructive writeorders:write

  Send the production hand-off for an existing order to its manufacturer again.

• list_quotesreadquotes:read

  Count and locate shopper submissions, and obtain the ids get_quote takes, without pulling shopper free text into the answer.

• get_quotereadquotes:read

  Read what a shopper actually submitted when the merchant asks about one enquiry.

• list_webhook_event_typesreadwebhooks:read

  Find the exact topic string a webhook subscription needs, rather than guessing its spelling.

• list_webhook_subscriptionsreadwebhooks:read

  See where a Store already sends events, and obtain the subscription ids the update and delete tools take.

• get_webhook_subscriptionreadwebhooks:read

  Confirm where one subscription delivers and which topic it carries, before changing or deleting it.

• create_webhook_subscriptionwritewebhooks:write

  Point one Sign Customiser event topic at an endpoint the merchant runs.

• update_webhook_subscriptiondestructive writewebhooks:write

  Move a subscription to another endpoint, or point it at a different event topic.

• delete_webhook_subscriptiondestructive writewebhooks:write

  Stop Sign Customiser delivering one event topic to one endpoint.

• get_ai_sign_design_capabilitiesreadai_sign_designs:read

  Check that the AI sign designer is available and that the image meets its limits before declaring a source.

• create_ai_sign_design_sourcewriteai_sign_designs:write

  Reserve a private upload target for the image, SVG or PDF an AI sign design starts from.

• get_ai_sign_design_sourcereadai_sign_designs:read

  Confirm that the bytes of a source arrived, or find out why verification rejected them.

• create_ai_sign_design_jobdestructive writeai_sign_designs:write

  Turn an uploaded logo or artwork image into a sign design with SVG and optional EPS and Illustrator-compatible PDF files.

• get_ai_sign_design_jobreadai_sign_designs:read

  Poll a job until it is delivered or failed, then collect the links to its files.

• list_ai_sign_design_jobsreadai_sign_designs:read

  Find a job whose id was lost, or see which designs are still running.

• retry_ai_sign_design_job_exportswriteai_sign_designs:write

  Repair a failed manufacturing file of a delivered design without buying another design.

Machine-readable resources

• Tool manifest · every tool's schemas, annotations, error cases and examples, as one JSON document.
• OpenAPI JSON · the public API contract these tools call.
• Sign Customiser Agent Skill · the generated Agent Skills file for Sign Customiser documentation and terminology.