Skip to main content
Glama
JOY Automart MCP Server

JOY Automart MCP Server

Official

Bangladesh buying terms

get_buying_guide
Read-onlyIdempotent

Identify retail terms covering payment, delivery, and buyer contact for automotive parts in Bangladesh. Read purchase guidelines before making a commitment.

Instructions

Read published Bangladesh retail-parts payment, delivery and human-contact terms before explaining a purchase.

  • Call {}. These terms come from the public retail-marketplace configuration, not a product, address or buyer account. Product choice cannot personalize this call: get_part supplies item eligibility and prepare_part_handoff prepares the enquiry.

  • Apply the returned zones after learning the buyer's area; confirm quantity/fitment separately from get_part. Retail checkout terms do not establish vehicle, auction or trade-credit terms; route car questions through prepare_vehicle_handoff.

  • Anonymous live read. Money objects separate major BDT from minor paisa; vat_bps uses basis points. If live_terms_unavailable=true, ask the human team rather than invent fees. The result is guidance, not an accepted quote; no payment or message starts.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_buying_guide"
  }
}

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.0.2
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "error": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "error": {
      +          "minLength": 1,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    },
      +    "money": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "amount_minor": {
      +          "description": "Minor currency units: 100 paisa = 1 BDT.",
      +          "type": "integer"
      +        },
      +        "currency": {
      +          "type": "string"
      +        },
      +        "major": {
      +          "description": "Decimal amount in major currency units, formatted as text.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "amount_minor",
      +        "currency",
      +        "major"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "oneOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "currency": {
      +          "const": "BDT",
      +          "type": "string"
      +        },
      +        "delivery_zones": {
      +          "items": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        "fitment_policy": {
      +          "type": "string"
      +        },
      +        "free_delivery_threshold": {
      +          "anyOf": [
      +            {
      +              "$ref": "#/$defs/money"
      +            },
      +            {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          ]
      +        },
      +        "how_to_buy": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "human_sales_contact": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "whatsapp": {
      +              "type": "string"
      +            },
      +            "whatsapp_url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "whatsapp",
      +            "whatsapp_url"
      +          ],
      +          "type": "object"
      +        },
      +        "languages": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "live_terms_unavailable": {
      +          "type": "boolean"
      +        },
      +        "market": {
      +          "const": "Bangladesh",
      +          "type": "string"
      +        },
      +        "minimum_order": {
      +          "anyOf": [
      +            {
      +              "$ref": "#/$defs/money"
      +            },
      +            {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          ]
      +        },
      +        "payment_methods": {
      +          "items": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        "vat_bps": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "market",
      +        "currency",
      +        "languages",
      +        "human_sales_contact",
      +        "how_to_buy",
      +        "fitment_policy"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "$ref": "#/$defs/error"
      +    }
      +  ],
      +  "type": "object"
      +}
  2. First observedv1.0.0

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare a safe, idempotent, closed-world read; the description adds genuinely new context: it is an anonymous live read, it is configuration-level rather than account/product personalized, and it names the live_terms_unavailable failure mode with an explicit instruction to escalate rather than invent fees. It also clarifies the result is guidance, not an accepted quote, and that no payment or message is initiated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The leading sentence is well front-loaded and each bullet carries distinct information about scope, sequencing and failure handling. It is somewhat dense and the literal '- Call {}.' placeholder is an unfilled template artifact that adds no meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter read with an output schema, the description supplies everything an agent still needs: where the terms come from, what is out of scope, currency/vat encoding, and the escalation path on unavailable live terms. Nothing required to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is nothing parameter-level to document and the schema coverage is trivially 100%. The description instead explains returned value conventions (major BDT vs minor paisa, vat_bps as basis points), which is useful but lives in a different dimension.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Read published Bangladesh retail-parts payment, delivery and human-contact terms') and even scopes the timing ('before explaining a purchase'). It is clearly distinguishable from sibling reads such as get_part and prepare_part_handoff, which it names.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use routing: call before explaining a purchase, apply returned zones only after learning the buyer's area, confirm quantity/fitment via get_part, and route vehicle/auction/trade-credit questions through prepare_vehicle_handoff. Alternatives and exclusions are both spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.