MCPサーバー

Brand Design Ltd.

ltd.branddesign/commerce

このMCPでできること

Exposes a brand-design service catalogue and supports creating orders, accepting offers, checking status, and making payments.

accept_offer
Accept the offer on behalf of the buyer. Needs credentials. This locks the billing identity, the offer version and the hash of the terms as they stand at this moment. A later change to the website cannot pass for what was agreed. Errors: OFFER_CHANGED (409) if the offer or the terms changed since you read them; read order_status and use the new values. OFFER_EXPIRED (409) 30 days after the order. MANUAL_OFFER_REQUIRED (409) while a person has not priced the service yet.
冪等
入力スキーマ
{'type': 'object', 'required': ['order', 'accessToken', 'offerVersion', 'termsHash', 'billing'], 'properties': {'order': {'type': 'string', 'description': 'The order id returned by create_order.'}, 'secret': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The secret returned by register_agent.'}, 'billing': {'if': {'properties': {'type': {'const': 'company'}}}, 'then': {'required': ['company', 'registration', 'representative']}, 'type': 'object', 'required': ['type', 'fullName', 'email', 'country', 'city', 'address'], 'properties': {'vat': {'type': 'string', 'maxLength': 40, 'minLength': 4, 'description': 'Company only. Optional VAT number.'}, 'city': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'type': {'enum': ['person', 'company'], 'type': 'string'}, 'email': {'type': 'string', 'maxLength': 254}, 'phone': {'type': 'string', 'maxLength': 40, 'minLength': 5, 'description': 'Optional.'}, 'address': {'type': 'string', 'maxLength': 250, 'minLength': 3}, 'company': {'type': 'string', 'maxLength': 200, 'minLength': 2, 'description': 'Company only. Registered name.'}, 'country': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'ISO 3166-1 alpha-2 code, for example BG.'}, 'fullName': {'type': 'string', 'maxLength': 150, 'minLength': 3, 'description': 'Full name of the buyer, or of the contact person for a company.'}, 'registration': {'type': 'string', 'maxLength': 40, 'minLength': 4, 'description': 'Company only. Company registration number; for country BG the 9- or 13-digit EIK.'}, 'representative': {'type': 'string', 'maxLength': 150, 'minLength': 3, 'description': 'Company only. The person who legally represents the company.'}}, 'description': 'The buyer as it will appear on the invoice and the contract. For type company, company, registration and representative are also required. For type person, leave out company, registration, vat and representative. No other keys are accepted.', 'additionalProperties': False}, 'clientId': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The clientId returned by register_agent.'}, 'termsHash': {'type': 'string', 'description': 'SHA-256 of the terms page in the language of the order: offer.terms.<language>.hash from the order, copied exactly. Sending it confirms that the buyer accepts those terms.'}, 'accessToken': {'type': 'string', 'description': 'The accessToken returned by create_order.'}, 'offerVersion': {'type': 'string', 'description': 'offer.version from the order, copied exactly.'}}, 'additionalProperties': False}
catalog
Read the service catalogue: names, prices, currency and terms. No credentials needed. All amounts are integers in the minor unit; 100000 means 1000.00 EUR.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': False}
create_order
Place an order for a service. Needs credentials. Returns the order id, the offer and an accessToken you must keep for the following calls. The offer is pinned to the hash of the service page; accept_offer needs offer.version and offer.terms.<language>.hash from it. Services without a catalogue price return an offer with no total and wait for a person to price it. Errors: MISSING_<field> when a required brief field is absent, UNEXPECTED_FIELD when the brief has a key the service does not declare.
入力スキーマ
{'type': 'object', 'required': ['service', 'brief'], 'properties': {'brief': {'type': 'object', 'description': 'One string per field the catalogue lists under this service in catalog.services.<service>.fields. Use each field id as the key. Fields with required: true must be present; the max value is the length limit. No other keys are accepted.', 'additionalProperties': {'type': 'string'}}, 'lines': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'qty': {'type': 'integer'}, 'item': {'type': 'string'}, 'note': {'type': 'string', 'maxLength': 500}, 'options': {'type': 'object', 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Only for services that have catalog.services.<service>.configurator. One entry per item: item is an id from configurator.items; qty is the number of designs, or the number of pages when the item has per "page", within item.qty min and max; options maps every option id of the item to one of its value ids; note is free text, required when the item has noteRequired. The price is computed by the seller from the catalogue; never send a price. If any chosen item has price null, the order waits for a person to price it.'}, 'secret': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The secret returned by register_agent.'}, 'service': {'type': 'string', 'description': 'Service id: one of the keys of catalog.services, as returned by the catalog tool.'}, 'clientId': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The clientId returned by register_agent.'}, 'language': {'enum': ['bg', 'en'], 'type': 'string', 'description': 'Language of the offer, the terms and the documents. Defaults to en.'}, 'printQuote': {'type': 'boolean', 'description': 'Only with lines: the buyer would like a print quote once the design work has started. Printing is not part of this order.'}, 'idempotencyKey': {'type': 'string', 'description': 'Your own key, so a repeated call does not create a second order.'}}, 'additionalProperties': False}
manifest
Read the commerce manifest: protocol, endpoints, authentication scheme, payment instrument and limits. No credentials needed.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': False}
order_status
Read the current state of the order, its offer and its payments, including the invoice number once one has been issued. Needs credentials.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['order', 'accessToken'], 'properties': {'order': {'type': 'string', 'description': 'The order id returned by create_order.'}, 'secret': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The secret returned by register_agent.'}, 'clientId': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The clientId returned by register_agent.'}, 'accessToken': {'type': 'string', 'description': 'The accessToken returned by create_order.'}}, 'additionalProperties': False}
register_agent
Register yourself and receive a client identifier and a secret. No approval and no prior arrangement. The secret is returned once and cannot be recovered. Put them in the Authorization header as "Bearer <clientId>:<secret>" for the other tools.
入力スキーマ
{'type': 'object', 'required': ['name', 'contact'], 'properties': {'name': {'type': 'string', 'description': 'Your name, 2 to 80 characters.'}, 'contact': {'type': 'string', 'description': 'A https:// or mailto: URL at which a human can reach whoever runs you.'}}, 'additionalProperties': False}
start_payment
Start payment for a stage. Needs credentials. Without sharedPaymentToken you receive a hosted payment session, which you may complete yourself with a payment instrument issued to you, or hand to the person you act for. With a delegated shared payment token the payment settles directly. A self-registered agent must first have current DNS domain-control KYA for its HTTPS contact domain; read the manifest for challenge, verification and status endpoints. KYA does not grant buyer payment authority. On-chain payment is not accepted. Errors: OFFER_EXPIRED (409) for an advance after 30 days, FINAL_NOT_RELEASED (409) when the final payment is not open yet, PAYMENTS_DISABLED (503).
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['order', 'accessToken'], 'properties': {'order': {'type': 'string', 'description': 'The order id returned by create_order.'}, 'stage': {'enum': ['advance', 'final'], 'type': 'string', 'description': 'advance: the first payment, open after accept_offer. It is 50% of the total, or the whole total when the service is paid at once (paymentPlan single in the catalogue). final: the remaining 50%, open only after the advance is paid and the seller has released the work for final payment. Defaults to advance.'}, 'secret': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The secret returned by register_agent.'}, 'clientId': {'type': 'string', 'description': 'Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The clientId returned by register_agent.'}, 'accessToken': {'type': 'string', 'description': 'The accessToken returned by create_order.'}, 'sharedPaymentToken': {'type': 'string', 'description': 'Only for delegated payment without a hosted page: a Stripe shared payment token granted to the seller profile in manifest.payment.networkBusinessProfile. Leave it out to receive a hosted payment session instead.'}}, 'additionalProperties': False}
変更
start_payment
2026年9月30日2:41
変更
create_order
2026年9月28日2:41
変更
order_status
2026年9月24日2:41
変更
start_payment
2026年9月24日2:41
変更
accept_offer
2026年9月24日2:41
変更
create_order
2026年9月24日2:41
追加
order_status
2026年9月18日2:40
追加
start_payment
2026年9月18日2:40
追加
accept_offer
2026年9月18日2:40
追加
create_order
2026年9月18日2:40
追加
register_agent
2026年9月18日2:40
追加
manifest
2026年9月18日2:40
追加
catalog
2026年9月18日2:40