Branding, design and web services you can order and pay for without a human on the seller side.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The order id returned by create_order.
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.
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.
The accessToken returned by create_order.
offer.version from the order, copied exactly.
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.
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.
Natural persons only: true when the buyer expressly asks the work to start within the 14-day withdrawal period and acknowledges losing the right of withdrawal once the service is fully performed.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| order* | string | The order id returned by create_order. |
| secret | string | 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* | object | 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. |
| clientId | string | 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* | string | 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* | string | The accessToken returned by create_order. |
| offerVersion* | string | offer.version from the order, copied exactly. |
| immediateStart | boolean | Natural persons only: true when the buyer expressly asks the work to start within the 14-day withdrawal period and acknowledges losing the right of withdrawal once the service is fully performed. |
{
"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."
},
"immediateStart": {
"type": "boolean",
"description": "Natural persons only: true when the buyer expressly asks the work to start within the 14-day withdrawal period and acknowledges losing the right of withdrawal once the service is fully performed."
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| brief* | object | Required MCP argument: send an object, including {} when the selected service has no required brief fields. Direct REST may omit brief and treats that as {}; required catalog fields remain mandatory. 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. |
| lines | array | 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 | string | 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* | string |
Issue a fresh DNS TXT challenge for your currently authenticated agent identity. Needs commerce.order for OAuth. Supply an HTTPS contact URL on a domain you control, especially on the first OAuth connection. Omitting contact reuses the current contact. This replaces the previous challenge and clears its verification. Publish the returned txtValue at dnsName, then call kya_verify. Domain control does not establish buyer identity or grant spending authority. Do not publish secrets in DNS.
| Argument | Type | Description |
|---|---|---|
| secret | string | 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. |
| contact | string | HTTPS URL on your own public domain. No IP address, credentials, custom port or URL fragment. |
| clientId | string | 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. |
{
"type": "object",
"properties": {
"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."
},
"contact": {
"type": "string",
"pattern": "^https://",
"maxLength": 200,
"minLength": 10,
"description": "HTTPS URL on your own public domain. No IP address, credentials, custom port or URL fragment."
},
"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."
}
},
"additionalProperties": false
}Read DNS domain-control verification for your currently authenticated agent. Needs commerce.read for OAuth. Returns verification status and, when present, DNS instructions and validity timestamps. This does not change the contact, challenge or verification.
| Argument | Type | Description |
|---|---|---|
| secret | string | 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 | string | 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. |
{
"type": "object",
"properties": {
"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."
}
},
"additionalProperties": false
}Check the DNS TXT challenge for your currently authenticated agent and record domain-control verification. Needs commerce.order for OAuth. First call kya_challenge and publish its exact DNS TXT record. The response gives verifiedAt and validUntil; verification is currently valid for 24 hours. This does not authorize a purchase or a payment.
| Argument | Type | Description |
|---|---|---|
| secret | string | 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 | string | 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. |
{
"type": "object",
"properties": {
"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."
}
},
"additionalProperties": false
}Read the commerce manifest: protocol, endpoints, authentication scheme, payment instrument and limits. No credentials needed.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Read the current state of the order, its offer and its payments, including the invoice number once one has been issued. Needs credentials.
| Argument | Type | Description |
|---|---|---|
| order* | string | The order id returned by create_order. |
| secret | string | 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 | string | 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* | string | The accessToken returned by create_order. |
{
"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 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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Your name, 2 to 80 characters. |
| contact* | string | A https:// or mailto: URL at which a human can reach whoever runs you. |
{
"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 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: call kya_challenge with a domain you control, publish its DNS TXT record and call kya_verify; kya_status reads the current verification. 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).
| Argument | Type | Description |
|---|---|---|
| order* | string | The order id returned by create_order. |
| stage | string | 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 | string | 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 | string | 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. |
| Service id: one of the keys of catalog.services, as returned by the catalog tool. |
| clientId | string | 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 | string | Language of the offer, the terms and the documents. This MCP adapter defaults to en; direct REST requires payload.language explicitly. |
| printQuote | boolean | Only with lines: the buyer would like a print quote once the design work has started. Printing is not part of this order. |
| idempotencyKey | string | Your own stable key, 16-100 characters, so a repeated call does not create a second order. If omitted this MCP adapter generates a new key for each invocation; provide and reuse a key for retries. Direct REST always requires idempotencyKey. |
{
"type": "object",
"required": [
"service",
"brief"
],
"properties": {
"brief": {
"type": "object",
"description": "Required MCP argument: send an object, including {} when the selected service has no required brief fields. Direct REST may omit brief and treats that as {}; required catalog fields remain mandatory. 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",
"default": "en",
"description": "Language of the offer, the terms and the documents. This MCP adapter defaults to en; direct REST requires payload.language explicitly."
},
"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 stable key, 16-100 characters, so a repeated call does not create a second order. If omitted this MCP adapter generates a new key for each invocation; provide and reuse a key for retries. Direct REST always requires idempotencyKey."
}
},
"additionalProperties": false
}| accessToken* | string | The accessToken returned by create_order. |
| sharedPaymentToken | string | 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. |
{
"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
}