# Square MCP for AI Agents AI Agent Connect > Square MCP lets you manage your payments, customers, and inventory through a conversational interface. Connect your Square account to your AI client to handle retail operations, check stock levels, and manage customer data without leaving your chat window. It turns your commerce backend into a searchable, actionable database for your agent. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_1w9mZ0b4ApjhVziheDEcAUYCoYKiSSgUNlb0Omqq/ai-agent-connect - **Tags:** square, payment-processing, point-of-sale, inventory-management, customer-crm, ecommerce-api, order-tracking, financial-tools, mcp ## Description Managing a retail business usually means jumping between different tabs to see if an item is in stock, checking a customer's past orders, or looking up a payment status. You spend a lot of time hunting for data instead of actually running your store. This Connector changes that by putting your Square data directly into your AI client. You can ask your agent to find a specific customer's history or check the inventory count for a product at a specific location. It handles the heavy lifting of navigating your commerce account so you can get answers in seconds. If you're looking for a way to centralize your retail operations, this is a solid addition to the Vinkius catalog. You get a direct line to your payments, orders, and customer profiles. Instead of digging through a dashboard, you just ask a question and get a clear answer. It's about making your business data actually useful during your normal workday. You no longer have to worry about missing a payment update or forgetting a customer's preference because the information is right there in your chat. Whether you're checking a multi-location inventory list or pulling a list of recent sales to see how the day went, your agent does the work for you. You get to focus on the customers in front of you while your commerce data stays organized and accessible. ## Tools ### list_catalog See every item in your product catalog. This helps you keep track of what you sell. ### get_stock_count Check how many items are currently in stock. It prevents overselling by giving real-time numbers. ### get_order_details Pull metadata for a specific order. Use this to see exactly what a customer bought and when. ### get_payment_details Get the specifics of a single payment. It's useful for reconciling accounts or checking transaction types. ### list_customers See a list of all customers in your store. This is the first step to managing your CRM. ### list_store_locations View all the physical and digital locations connected to your account. It helps manage multi-site retail. ### list_payments See a paginated list of recent payments. Use this to get a quick overview of your daily revenue. ### search_customers Find a specific person in your customer database. This makes it easy to look up individual profiles. ### search_orders Find specific orders using location IDs. It helps you track down sales for a particular store. ### create_payment Make a new payment record in your account. This allows your agent to help record new transactions. ### get_customer See the full profile of a specific customer. Use this to get all the details for a single person. ## Prompt Examples **Prompt:** ``` Do we have any 'Espresso Roast' left at the Downtown Cafe? ``` **Response:** ``` I've checked the inventory for the Downtown Cafe location. | Item | Stock Level | Status | | :--- | :--- | :--- | | Espresso Roast | 42 units | In Stock | Would you like me to check any other items for this location? ``` **Prompt:** ``` Show me the last 3 payments from today. ``` **Response:** ``` **Today's Recent Payments:** * **$45.00** - Completed (Credit Card) * **$120.50** - Pending (Apple Pay) * **$12.00** - Completed (Cash) Total processed today: **$177.50**. ``` **Prompt:** ``` Find the order for Jane Doe from last week. ``` **Response:** ``` I found a record for **Jane Doe**. * **Order ID:** #SQ-88291 * **Date:** May 14, 2024 * **Items:** 2x Ceramic Mugs, 1x Latte * **Total:** $34.00 * **Status:** Shipped Would you like me to see her full profile or order history? ``` ## Capabilities ### Check real-time inventory See exactly how many units of a product are left in your catalog. ### Search customer profiles Find specific people in your database to see their history and details. ### Track payment statuses Get a clear view of recent transactions and their current status. ### Monitor multi-location sales View and manage data across all your physical and digital storefronts. ### Retrieve order metadata Pull specific details for past or current orders instantly. ### Create new payment records Let your agent initiate a new payment record for your records. ## Use Cases ### Quick stock verification A retail manager asks the agent if the 'Blue Widget' is available at the 'Main St' shop. The agent uses get_stock_count to confirm availability instantly. ### Customer history lookup A support rep asks for David's history. The agent uses search_customers and get_customer to show his last 5 orders and preferred items. ### Daily sales summary An owner asks for today's total sales. The agent uses list_payments to sum up the daily revenue and list the most common payment methods. ### Multi-location order tracking A staff member needs to find an order from last week at a specific branch. The agent uses search_orders to find the exact transaction. ## Benefits - Get real-time stock levels using get_stock_count to avoid selling items you don't have. - Find customer records instantly with search_customers to provide faster support. - View all your revenue at a glance using list_payments to stay on top of daily sales. - Manage multiple storefronts easily with list_store_locations to see your full footprint. - Access order history quickly with get_order_details to resolve customer issues faster. - Keep your catalog organized by viewing all items with list_catalog in one go. ## How It Works The bottom line is you get a conversational interface for your entire Square commerce backend. 1. Subscribe to this Connector on Vinkius 2. Enter your Square Personal Access Token from your developer dashboard 3. Start managing your commerce operations from Claude, Cursor, or any MCP-compatible client ## Frequently Asked Questions **Can the Square MCP help me manage multiple stores?** Yes, it can. You can use it to list all your business locations and then check stock levels or find orders for specific stores in one place. **Can I use it to check if items are in stock?** Absolutely. You can ask your agent to check the stock count for any product in your catalog to see exactly how many units are available. **How do I see my recent sales?** You can ask your agent to list your recent payments. It will pull the latest transactions, including the amounts and payment methods used. **Can it find specific customer info?** Yes, it can search your customer database. You can find specific people and then ask for their full profile, including their order history. **Does it work for online and physical stores?** Yes, it covers all business locations connected to your Square account, whether they are physical storefronts or online shops. **Can I create a payment record?** Yes, your agent can create new payment records in your account, making it easier to log transactions during your workday. **How do I find my Square Personal Access Token?** Log in to your [**Square Developer Dashboard**](https://developer.squareup.com/apps), create or select an application, and you will find your Personal Access Token in the **Credentials** section. Ensure you use the Production token for live data.