Gwiksoft
Shop independent Indian businesses: find stores, compare products and prices, get checkout links.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"shopping": {
"url": "https://mcp.gwiksoft.com/mcp"
}
}
}Remote endpoints
https://mcp.gwiksoft.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢find_businesses(query, city)
Finds Gwiksoft businesses that sell what the customer is looking for, optionally in a city, with a few matching products from each. Each result’s business id works with the other tools. Online stores deliver beyond their city.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"description": "What the customer wants, e.g. \"lab-grown diamond ring\" or \"wall-hung basin\". Empty lists businesses."
},
"city": {
"description": "A city, e.g. \"Hyderabad\", to keep to businesses there and online stores.",
"type": "string",
"maxLength": 60
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"businesses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"business": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"catalogue": {
"type": "string"
},
"sells": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"online_checkout": {
"type": "boolean"
},
"takes_visits": {
"type": "boolean"
},
"chat_url": {
"type": "string"
},
"matching_products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price_label": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"price_label",
"url",
"image"
],
"additionalProperties": false
}
}
},
"required": [
"business",
"name",
"description",
"catalogue",
"sells",
"location",
"online_checkout",
"takes_visits",
"chat_url",
"matching_products"
],
"additionalProperties": false
}
},
"note": {
"type": "string"
}
},
"required": [
"businesses"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_business(business)
The business’s profile: what it sells, where it is, opening hours, how it sells (showroom, online store, bulk), whether it takes visits and has an online checkout, and its WhatsApp and chat links.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
}
},
"required": [
"business"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"catalogue": {
"type": "string"
},
"sells": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"hours": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"whatsapp_url": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"chat_url": {
"type": "string"
},
"google_maps_url": {
"type": [
"string",
"null"
]
},
"instagram_url": {
"type": [
"string",
"null"
]
},
"logo_url": {
"type": [
"string",
"null"
]
},
"takes_visits": {
"type": "boolean"
},
"online_checkout": {
"type": "boolean"
}
},
"required": [
"name",
"description",
"catalogue",
"sells",
"location",
"hours",
"phone",
"whatsapp_url",
"website",
"chat_url",
"google_maps_url",
"instagram_url",
"logo_url",
"takes_visits",
"online_checkout"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_products(business, query, collection, min_price, max_price, ...)
Searches the business’s whole catalogue by the customer’s words, a budget, or both. Returns each product’s current price in INR, options, stock and link, plus the business’s live offers. next_cursor gives the next page.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"query": {
"description": "What the customer wants, in their words, e.g. \"oval solitaire ring\". Empty lists everything.",
"type": "string",
"maxLength": 200
},
"collection": {
"description": "A collection from list_collections, to narrow the search.",
"type": "string",
"maxLength": 100
},
"min_price": {
"description": "Lowest price in INR (rupees, not paise).",
"type": "number",
"minimum": 0
},
"max_price": {
"description": "Highest price in INR.",
"type": "number",
"minimum": 0
},
"in_stock_only": {
"description": "Leave out sold-out products.",
"type": "boolean"
},
"limit": {
"description": "Products per page, 10 if not given.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"cursor": {
"description": "next_cursor from the previous page.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"business"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"price_max": {
"type": [
"number",
"null"
]
},
"compare_at_price": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"in_stock": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
}
},
"required": [
"id",
"title",
"price",
"price_max",
"compare_at_price",
"currency",
"price_label",
"in_stock",
"url",
"image",
"description"
],
"additionalProperties": {}
}
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"discount": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"code": {
"type": [
"string",
"null"
]
},
"applies_to": {
"type": "string"
},
"terms": {
"type": [
"string",
"null"
]
},
"ends_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"discount",
"description",
"code",
"applies_to",
"terms",
"ends_at"
],
"additionalProperties": false
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"products",
"offers",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_collections(business)
The catalogue’s collections or categories, each with how many products it has, the lowest price and a photo.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
}
},
"required": [
"business"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"collections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"products": {
"type": "number"
},
"from_price": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"products",
"from_price",
"image"
],
"additionalProperties": false
}
},
"note": {
"type": "string"
}
},
"required": [
"collections",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_product(business, id, options)
One product in full: photos, every option with its choices, and, for online stores, the variant for the chosen options with its id, price and stock. The variant id works with start_checkout.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"id": {
"type": "string",
"maxLength": 120,
"description": "The product id from search_products."
},
"options": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 60
},
"additionalProperties": {
"type": "string",
"maxLength": 100
},
"description": "The customer’s choices, e.g. {\"Color\": \"Rose Gold\", \"Ring size\": \"12\"}."
}
},
"required": [
"business",
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"product": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"price_max": {
"type": [
"number",
"null"
]
},
"compare_at_price": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"in_stock": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
}
},
"required": [
"id",
"title",
"price",
"price_max",
"compare_at_price",
"currency",
"price_label",
"in_stock",
"url",
"image",
"description"
],
"additionalProperties": {}
}
},
"required": [
"product"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_offers(business)
The business’s offers running now, with their end dates and terms. This is the complete list of its current offers.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
}
},
"required": [
"business"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"discount": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"code": {
"type": [
"string",
"null"
]
},
"applies_to": {
"type": "string"
},
"terms": {
"type": [
"string",
"null"
]
},
"ends_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"discount",
"description",
"code",
"applies_to",
"terms",
"ends_at"
],
"additionalProperties": false
}
}
},
"required": [
"offers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢ask_business(business, question)
Answers delivery, returns, exchange, payment, warranty and care questions from what the business published: its FAQs, its website and, for Shopify stores, the store’s own policies. Says how to reach the team when it has no answer.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"question": {
"type": "string",
"minLength": 3,
"maxLength": 300,
"description": "The customer’s question, e.g. \"Do you deliver to Delhi?\""
}
},
"required": [
"business",
"question"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"answers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
},
"source": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"question",
"answer",
"source"
],
"additionalProperties": false
}
},
"note": {
"type": "string"
}
},
"required": [
"answers",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢start_checkout(business, items)
For online stores on Shopify: a link that opens the store’s own cart with the chosen products in the customer’s browser, with the total. The store confirms stock and the final price at checkout; nothing is ordered or charged by this tool. Other businesses answer with how to buy.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"items": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"variant_id": {
"description": "A variant id from get_product.",
"type": "string",
"maxLength": 120
},
"product_id": {
"description": "Or a product id, with the customer’s choices in options.",
"type": "string",
"maxLength": 120
},
"options": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 60
},
"additionalProperties": {
"type": "string",
"maxLength": 100
},
"description": "The customer’s choices, e.g. {\"Color\": \"Rose Gold\", \"Ring size\": \"12\"}."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 50
}
}
}
}
},
"required": [
"business",
"items"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"checkout_url": {
"type": [
"string",
"null"
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variant_id": {
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "number"
},
"price": {
"type": [
"number",
"null"
]
}
},
"required": [
"variant_id",
"title",
"quantity",
"price"
],
"additionalProperties": false
}
},
"total": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
},
"reason": {
"type": "string"
},
"how_to_buy": {
"type": "string"
},
"whatsapp_url": {
"type": [
"string",
"null"
]
},
"chat_url": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"checkout_url",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_lead(business, name, phone, email, message, ...)
Sends the customer’s enquiry or call-back request, with their name and phone, to the business’s team, who contact them on WhatsApp or by phone. For when the customer has asked to be contacted. Only for businesses that take requests through AI assistants; others answer with their WhatsApp and chat links.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"name": {
"type": "string",
"maxLength": 120
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s()-]{8,20}$",
"description": "The customer’s phone or WhatsApp number with country code, e.g. +91 98765 43210, shared by the customer to be contacted."
},
"email": {
"type": "string",
"maxLength": 200,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"message": {
"type": "string",
"minLength": 2,
"maxLength": 2000,
"description": "What the customer wants, in a sentence or two."
},
"product_id": {
"type": "string",
"maxLength": 120
},
"product_title": {
"type": "string",
"maxLength": 200
},
"call_back": {
"description": "The customer asked to be called.",
"type": "boolean"
}
},
"required": [
"business",
"phone",
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"next_step": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"status",
"next_step"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪request_visit(business, name, phone, day, time, ...)
Requests a store visit or appointment on the day and time the customer chose. It reaches the business’s Appointments board as pending, and the team confirms it with the customer. Not for online-only stores. Only for businesses that take requests through AI assistants; others answer with their WhatsApp and chat links.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s()-]{8,20}$",
"description": "The customer’s phone or WhatsApp number with country code, e.g. +91 98765 43210, shared by the customer to be contacted."
},
"day": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD, today or later."
},
"time": {
"description": "\"morning\", \"afternoon\", \"evening\", or a time like \"17:30\".",
"type": "string",
"pattern": "^(morning|afternoon|evening|([01]?\\d|2[0-3]):[0-5]\\d)$"
},
"product_id": {
"type": "string",
"maxLength": 120
},
"product_title": {
"type": "string",
"maxLength": 200
},
"note": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"business",
"name",
"phone",
"day"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"next_step": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"status",
"next_step"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪hand_off_to_team(business, name, phone, summary)
Passes the customer, with a short summary of what they need, to a person on the business’s team, who contacts them on WhatsApp or by phone. For when the customer asks for a person. Only for businesses that take requests through AI assistants; others answer with their WhatsApp and chat links.
Input Schema
{
"type": "object",
"properties": {
"business": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[a-z0-9-]+$",
"description": "The business id from find_businesses, e.g. \"carat-story\"."
},
"name": {
"type": "string",
"maxLength": 120
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s()-]{8,20}$",
"description": "The customer’s phone or WhatsApp number with country code, e.g. +91 98765 43210, shared by the customer to be contacted."
},
"summary": {
"type": "string",
"minLength": 5,
"maxLength": 2000,
"description": "What the customer needs, in a few sentences."
}
},
"required": [
"business",
"phone",
"summary"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"next_step": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"status",
"next_step"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence