# Serasa ClearSale Partners Reseller Onboarding MCP. AI Agent Connect > Serasa ClearSale Partners Reseller Onboarding MCP automates the manual reseller workflow in the ClearSale portal. Your agent can now quote new stores, provision entities using transaction codes, retrieve sensitive API credentials, and manage store deactivations. It handles the heavy lifting of matching products to market segments so you can move from signup to handoff without touching the portal. ## Overview - **Category:** finance - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_E7eNev5YssV0S6XBsFYY00IuNserWLUOHBb5U68y/ai-agent-connect - **Tags:** clearsale, partners, reseller, onboarding, provisioning, brazil, marketplace ## Description This MCP replaces the manual clicking required in the ClearSale partner portal. Instead of navigating through catalogs and forms, you tell your AI client what the new store looks like. The agent checks available products and segments, generates a quote, and uses the resulting transaction code to provision the entity. It keeps the onboarding sequence intact by linking the priced profile directly to the created store. Once the entity is live, your agent pulls the necessary API credentials and presents them to you, ready to be handed off to the client. When a store churns or needs to be suspended, you simply tell your agent to deactivate it using the client ID. It turns a multi-step administrative process into a direct conversation with your agent. ## Tools ### create_entity_quote Quotes the price for onboarding a new store. Your agent provides the store profile, and the tool returns a transaction code used to link the price to the entity. ### deactivate_entity Deactivates a store in ClearSale. You provide the client ID to suspend or remove an entity when it churns. ### get_entity_credentials Retrieves the API credentials for a specific store. Use this to get the integration details needed for the client's setup. ### list_client_products Lists the anti-fraud products available to your partner account. These IDs are required for the quoting process. ### list_segments Shows the market segments available for ClearSale entities. This helps your agent pick the right category for a quote. ### create_entity Provisions a new store in ClearSale. It requires the transaction code from a previous quote to finalize the setup. ### list_products_with_segments Maps products to the specific segments they support. This prevents errors during the quoting phase by ensuring valid pairs. ## Prompt Examples **Prompt:** ``` Onboard the store Loja Exemplo, CNPJ 02.668.127/0001-09, average ticket BRL 105, about 10 orders a month. They sell shoes online. ``` **Response:** ``` The agent will list valid product and segment pairs, generate a quote, create the entity using the transaction code, and then retrieve the API credentials for the store. ``` **Prompt:** ``` Store store-42 churned, please deactivate it. ``` **Response:** ``` The agent will call the deactivation tool for client ID store-42 and confirm when the entity is disabled. ``` **Prompt:** ``` What products can I resell and which segments do they support? ``` **Response:** ``` The agent will pull the list of available products and their compatible market segments. ``` ## Capabilities ### Automated Quoting Your agent calculates prices based on store volume and ticket size. ### Entity Provisioning The MCP creates new store profiles in ClearSale using validated transaction codes. ### Credential Retrieval Your agent fetches the sensitive API keys needed for client integration. ### Catalog Management The agent identifies which products and segments are available for your specific partner account. ### Churn Management You can deactivate stores instantly through your AI client. ## Use Cases ### New Client Onboarding Convert a sales lead into a live ClearSale entity by providing their profile to your agent. ### Product Catalog Audits Check which anti-fraud products and segments your partner account is currently authorized to sell. ### Client Offboarding Deactivate stores immediately when they churn to manage your portfolio accurately. ### Integration Support Get the specific API credentials a client needs to finish their setup. ## Benefits - Eliminates manual data entry in the ClearSale partner portal. - Prevents errors by validating product and segment compatibility before quoting. - Speeds up client handoff by centralizing credential retrieval. - Maintains strict data integrity by linking quotes to entities via transaction codes. ## How It Works Connect your AI client to Vinkius to access these tools instantly. 1. Connect your MCP-compatible client to the Vinkius hosted connector. 2. Tell your agent to list available products and segments. 3. Provide the store profile to generate a quote and receive a transaction code. 4. Use the code to provision the new entity in ClearSale. 5. Retrieve the API credentials to complete the client handoff. ## Frequently Asked Questions **How do I know the price of a new store quote?** The tool returns a transaction code. You can view the actual priced amount within the ClearSale portal. **What happens if I pick a segment a product doesn't support?** The API will return a 400 error. Use the list_products_with_segments tool to ensure your agent picks a valid pair. **Do I need to manually enter the transaction code?** No. Your agent handles the flow by taking the code from the quote and passing it to the creation tool. **Can I use this to manage multiple stores?** Yes. You can use the client IDs to manage, provision, or deactivate any number of entities in your portfolio. **Is the credential data secure?** The MCP provides the credentials, but you should manage how your agent handles or logs this sensitive information. **What is the correct order to onboard a store?** list_products_with_segments to pick a product/segment pair, then create_entity_quote, then create_entity with the returned transactionCode, then get_entity_credentials to read the keys the store configures. Skipping the quote leaves the created entity unlinked to a priced profile. **Why did the quote come back as a percentage instead of a fixed price?** ClearSale answers with either a fixed value (priceType 1) or a percentage of the analyzed volume (priceType 2), depending on the product and the store profile you sent. The rendered quote says which one it is. Both are valid; a percentage is common for marketplace sellers. **What happens when I deactivate a store?** The entity stops analyzing immediately. It is reversible only through ClearSale support, so use it for churn or suspension, not for testing. The clientID you deactivate is the one you set at creation time.