![\"A](\"https://blog.madabina.com/assets/images/start-online-store-algeria-b7b06e66e16b7347ab9cc1b900d57b7e.avif\")
Madabina provides an MCP server for compatible clients to interact with a merchant’s authorized store data. A connection uses Streamable HTTP and OAuth, so the client must support the authorization flow and protected-resource discovery.
\nThe MCP endpoint is https://mcp.madabina.com/mcp. The server publishes protected-resource metadata at https://mcp.madabina.com/.well-known/oauth-protected-resource, and the authorization server is https://madabina.com.
Configure a client that supports Streamable HTTP and OAuth discovery. The merchant completes authorization through the client flow. Do not paste a merchant token into shared configuration or treat an endpoint URL by itself as authorization.
\nMadabina’s documented scopes separate read access, product writes, order writes, and destructive actions. Select only the scopes needed for the feature. Product deletion and order cancellation require the destructive scope, so a read-only integration should not request it.
\nAccess remains tied to the authorized merchant account and selected store. Keep the store context visible in your integration and avoid assuming that a merchant has only one store.
\nMCP write operations require a UUID idempotency key. If a mutation times out, do not retry it with a new key automatically: follow the server’s current guidance and reuse the same key when retrying the same operation. This helps avoid accidentally applying a repeated action.
\nKeep tokens out of logs and source control. If authorization fails, use the client’s OAuth discovery flow and the official documentation to diagnose the connection instead of embedding credentials manually.
\nThe available tools and permissions can evolve. Before shipping an integration, review the Madabina MCP server guide for the current endpoint metadata, scope descriptions, and mutation behavior.
", "url": "https://blog.madabina.com/articles/developers/mcp-client", "title": "Connect an MCP Client to Madabina: OAuth and Permission Scopes", "summary": "Learn the verified connection details, OAuth requirement, and permission model for Madabina’s MCP server.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "Madabina Editorial Team", "url": "https://madabina.com" }, "tags": [ "For developers" ] }, { "id": "https://blog.madabina.com/articles/sellers/product-page-checklist", "content_html": "A product page should help a customer understand what is being offered before ordering. Clear product information also makes a store easier to maintain: the merchant can review the same key details whenever an item changes.
\nUse this checklist when adding or updating a product in your Madabina store.
\nName the item in the words customers are likely to recognize. Include a useful model, material, or size when it distinguishes the product. Avoid filling the name with repeated search phrases; put extra detail in the description instead.
\nChoose clear images that match the actual product and show the details a customer needs to assess it. Keep image backgrounds and framing consistent across similar items. If a color or variant differs, use imagery that makes that difference visible.
\nDescribe the product in plain language. Include the material, dimensions, compatibility, care instructions, or other facts that matter for that item. Separate confirmed product details from estimates or recommendations, and remove information that no longer applies.
\nReview the displayed price and the available stock before making the product visible. If the item has variants, check the price, stock, and visibility for each relevant option. Update the listing when the product is temporarily unavailable or its details change.
\nMadabina supports product text in French, English, and Arabic. Add the versions you want customers to see and review them in the public store. Choose the category that best describes the item so customers can browse related products.
\nOpen the listing as a customer would. Confirm that the name, images, description, price, and availability are easy to find on a phone. Check the order form and make sure the information presented matches the product you intend to sell.
\nFor the exact merchant workflow, see the Madabina product and stock guide. When you are ready, create your Madabina store.
", "url": "https://blog.madabina.com/articles/sellers/product-page-checklist", "title": "Online Store Product Page Checklist: Names, Images, Price, and Stock", "summary": "Use this practical checklist to make product information clear and consistent in your online store.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "Madabina Editorial Team", "url": "https://madabina.com" }, "tags": [ "For sellers" ] }, { "id": "https://blog.madabina.com/articles/developers/rest-api-integration", "content_html": "Madabina’s versioned REST API lets an authenticated merchant integration work with store resources such as products and orders. Start with the published API contract before writing requests: it defines the current fields, responses, and validation rules.
\nThe production API base URL is https://madabina.com/api/v1. The interactive API reference and OpenAPI document are the source of truth for available routes and request schemas.
The API documentation describes merchant authentication and the resources available to an authenticated account. Private routes require a valid Bearer token, and resources are scoped to stores the authenticated merchant is allowed to manage.
\nUse the documented authentication flow to obtain a token. Send access tokens in the Authorization: Bearer … header over HTTPS. Keep credentials and tokens in an appropriate secret store on the server side; do not commit them to source control, expose them in a browser bundle, or write them to logs.
Before implementing token refresh, logout, or a mutation, follow the current API reference for its exact fields and behavior. These details are part of the API contract and can change as the service evolves.
\nChoose one read operation from the API reference and implement it with a test merchant account. Parse the documented success and error responses, handle expired or invalid credentials, and avoid assuming that every response has the same shape. Add write operations only after confirming their validation requirements and side effects.
\nDesign your integration around the merchant and store context returned by the API. Before automating a status change, cancellation, or stock update, review the operation’s documented effects. For example, the current merchant guide notes that cancelling an order can restore stock when applicable and does not hard-delete its record.
\nThe blog explains the integration path; use the API reference for exact endpoint, parameter, and response contracts.
", "url": "https://blog.madabina.com/articles/developers/rest-api-integration", "title": "Madabina REST API: A First Integration Guide for Developers", "summary": "Find the Madabina REST API base URL, authentication references, and a safe path to your first integration.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "Madabina Editorial Team", "url": "https://madabina.com" }, "tags": [ "For developers" ] }, { "id": "https://blog.madabina.com/articles/sellers/start-online-store-algeria", "content_html": "
Starting an online store means planning more than a website. Before you invite customers, make sure they can understand what you sell, place an order, and see what delivery choices are available to them.
\nThis checklist focuses on the store setup and customer journey. Business registration, taxes, carrier coverage, and other legal or commercial obligations depend on your situation; check current guidance from the relevant authorities and service providers.
\nWrite down who the products are for, what problem they solve, and which items you will launch with. A focused first catalog is easier to explain and maintain than a large collection with incomplete details.
\nDecide how you will set prices, monitor availability, answer customer questions, and handle an order that cannot be fulfilled. These decisions help you prepare the information that customers need before they submit an order.
\nFor each item, prepare a name, price, useful description, product images, and current availability. Explain meaningful choices such as size or color when they apply. If customers use more than one language, prepare the product text in the languages you intend to show.
\nMadabina merchants can manage product details, translations, stock, and visibility in their store. See the product and stock guide for the current workflow.
\nCheck the public store as a customer would. Product details should be easy to find, the order form should ask for the information needed to process the order, and the total should be clear before submission.
\nPlace a test order with your own store workflow before sharing the link. Confirm that the order appears in the right merchant workspace and that the confirmation shown to the customer is understandable.
\nConfigure the destinations and delivery methods your business is prepared to serve. Review the fee and the choices shown for each destination. Availability depends on the store’s own delivery settings, so test more than one destination if your store serves different areas.
\nUse the store and delivery setup guide to review the merchant-side settings.
\nShare the store with a small audience first. Watch where customers ask questions or abandon the process, then improve the product information, order instructions, or delivery details that caused confusion. Keep inventory and delivery settings current as the business changes.
\nCreate a Madabina merchant account to start preparing your store.
", "url": "https://blog.madabina.com/articles/sellers/start-online-store-algeria", "title": "How to Set Up an Online Store in Algeria with Madabina", "summary": "Prepare a Madabina store in Algeria with a clear catalog, order journey, and delivery settings.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "Madabina Editorial Team", "url": "https://madabina.com" }, "tags": [ "For sellers" ] } ] }