Connect an AI assistant to OneStockHome
Published · Last updated
OneStockHome Shopping is a connector (an MCP server) that lets an AI assistant such as Claude shop for building materials at OneStockHome with your account: search products, check prices and delivery fees, manage your cart and place orders, with you confirming each one.
Server address
https://www.onestockhome.com/mcpWhat you need
- A OneStockHome account (free at www.onestockhome.com)
- At least one delivery address in Thailand saved in your account, if you want to place orders
- An AI assistant that supports remote MCP servers, such as Claude
How to connect
Claude (web, desktop and mobile)
- Open Settings and choose Connectors.
- Choose Add custom connector, name it OneStockHome Shopping and paste the server address above.
- Press Connect. You are taken to the OneStockHome permission page: sign in, check what the app may do, and press Allow.
- Back in Claude, turn the connector on in a chat and start asking.
Claude Code
Add the server with this command, then type /mcp in Claude Code to sign in.
claude mcp add --transport http onestockhome https://www.onestockhome.com/mcpOther assistants
Any app that supports MCP over Streamable HTTP with OAuth sign-in can use the same address. The details are under Technical details.
What the assistant can do
The connector has ten tools. Before a tool that changes data runs, the assistant asks you to confirm.
search_productsRead onlySearches the catalogue of building materials and home products.
get_itemRead onlyPrice, unit, size, stock and page link of one item.
get_cartRead onlyYour cart, with the quantity and prices of each line.
add_to_cartChanges dataPuts an item in your cart at a quantity. If the item is already there, its quantity is replaced, not added to.
remove_from_cartChanges dataRemoves lines from your cart.
list_addressesRead onlyYour saved delivery addresses and tax invoice addresses.
get_delivery_optionsRead onlyDelivery options and fees for cart lines sent to a saved address.
list_vouchersRead onlyThe discount vouchers you can use, with each one's discount and minimum spend.
preview_orderRead onlyWhat an order would cost before it is placed: items, delivery fee, each discount, VAT and the total.
place_orderChanges dataCreates an order from cart lines. It takes no payment and returns a link to pay.
Things to ask
- Find a 6-foot aluminium ladder and show me the details of the cheapest one.
- Add 20 bags of cement to my cart and tell me how much more I need to spend for the next discount step.
- How much is delivery of my cart to my first address?
- What vouchers do I have? Use the one that saves the most and give me the total.
Orders and payment
- The assistant sums up the lines, the address, the delivery option and the total, and asks you to confirm before it creates the order.
- The connector never takes payment and never sees your card or bank details.
- After the order is created you get a link to its page on onestockhome.com, where you sign in and pay the way you prefer.
- An order that is not paid yet can be viewed and managed in the order history of your account.
Signing in and your data
- You sign in on onestockhome.com only. The AI assistant never sees your password.
- A connected app reaches only what the tools above use: the product catalogue, your cart, your saved addresses, your vouchers and the orders it creates.
- OneStockHome receives only the requests the assistant sends to the tools, not your conversation.
- An order created through the connector is recorded with the app it came from.
Disconnecting
Open the API Access page in your account, find the app under Connected apps and press Disconnect. The app loses access to your account at once.
Limits
- Only addresses already saved can be used. Add a new address from your account on the website.
- Orders are for delivery to an address. Pickup is not supported yet.
- Some items sell only in set quantities, such as full truck loads. When a quantity does not fit, the assistant passes on the store's message.
- Prices, stock and delivery fees are as of the moment you ask, and can change before you order.
Technical details
- Transport: MCP over Streamable HTTP, POST only.
- Authorization: OAuth 2.0 authorization code with PKCE (S256), scope mcp.
- Discovery metadata:
https://www.onestockhome.com/.well-known/oauth-protected-resource,https://www.onestockhome.com/.well-known/oauth-authorization-server - Client registration: Dynamic Client Registration (RFC 7591) at
https://www.onestockhome.com/oauth/register - Redirect URIs must be https, or http on localhost / 127.0.0.1.
- Access tokens last one hour and are renewed with a refresh token.
Help
If you cannot connect, or a tool does not work as described, contact customer service.
