Skip to main content
Glama

Brand Design Ltd.

by ltd.branddesign
OverviewDiscussionsAdmin

accept_offer

Idempotent

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
orderYesThe order id returned by create_order.
secretNoRequired 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.
billingYesThe 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.
clientIdNoRequired 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.
termsHashYesSHA-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.
accessTokenYesThe accessToken returned by create_order.
offerVersionYesoffer.version from the order, copied exactly.
immediateStartNoNatural 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.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / immediateStart
      Added value: +{
+  "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.",
+  "type": "boolean"
+}
  2. Changed12 schema fields changed
    • addedInput schema / properties / accessToken / description
      Added value: +"The accessToken returned by create_order."
    • addedInput schema / properties / billing / additionalProperties
      Added value: +false
    • changedInput schema / properties / billing / description
      Previous value: -"type (person or company), fullName or company with eik, email, country, city, address, phone."New value: +"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."
    • addedInput schema / properties / billing / if
      Added value: +{
+  "properties": {
+    "type": {
+      "const": "company"
+    }
+  }
+}
    • addedInput schema / properties / billing / properties
      Added value: +{
+  "address": {
+    "maxLength": 250,
+    "minLength": 3,
+    "type": "string"
+  },
+  "city": {
+    "maxLength": 100,
+    "minLength": 1,
+    "type": "string"
+  },
+  "company": {
+    "description": "Company only. Registered name.",
+    "maxLength": 200,
+    "minLength": 2,
+    "type": "string"
+  },
+  "country": {
+    "description": "ISO 3166-1 alpha-2 code, for example BG.",
+    "pattern": "^[A-Za-z]{2}$",
+    "type": "string"
+  },
+  "email": {
+    "maxLength": 254,
+    "type": "string"
+  },
+  "fullName": {
+    "description": "Full name of the buyer, or of the contact person for a company.",
+    "maxLength": 150,
+    "minLength": 3,
+    "type": "string"
+  },
+  "phone": {
+    "description": "Optional.",
+    "maxLength": 40,
+    "minLength": 5,
+    "type": "string"
+  },
+  "registration": {
+    "description": "Company only. Company registration number; for country BG the 9- or 13-digit EIK.",
+    "maxLength": 40,
+    "minLength": 4,
+    "type": "string"
+  },
+  "representative": {
+    "description": "Company only. The person who legally represents the company.",
+    "maxLength": 150,
+    "minLength": 3,
+    "type": "string"
+  },
+  "type": {
+    "enum": [
+      "person",
+      "company"
+    ],
+    "type": "string"
+  },
+  "vat": {
+    "description": "Company only. Optional VAT number.",
+    "maxLength": 40,
+    "minLength": 4,
+    "type": "string"
+  }
+}
    • addedInput schema / properties / billing / required
      Added value: +[
+  "type",
+  "fullName",
+  "email",
+  "country",
+  "city",
+  "address"
+]
    • addedInput schema / properties / billing / then
      Added value: +{
+  "required": [
+    "company",
+    "registration",
+    "representative"
+  ]
+}
    • changedInput schema / properties / clientId / description
      Previous value: -"Your client identifier, if not sent in the Authorization header."New value: +"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."
    • addedInput schema / properties / offerVersion / description
      Added value: +"offer.version from the order, copied exactly."
    • addedInput schema / properties / order / description
      Added value: +"The order id returned by create_order."
    • changedInput schema / properties / secret / description
      Previous value: -"Your secret, if not sent in the Authorization header."New value: +"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."
    • addedInput schema / properties / termsHash / description
      Added value: +"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."
  3. First observed

TDQS

Score is being calculated.

All Brand Design Ltd. toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources