# Square MCP for AI Agents AI Agent Connect > Square MCP for AI Agents. Manage your Square business through natural conversation. Track payments, orders, catalog, customers, inventory, and team members directly through your AI client. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_GDy72INcPM9RV3RjZhDapqmLtt9g9XeoHRKWNwVk/ai-agent-connect - **Tags:** square, payment-processing, point-of-sale, inventory-management, customer-crm, ecommerce-api, order-tracking, financial-tools, mcp ## Description The Square MCP connects your commerce data to any AI agent. It lets you manage your business without constant tab switching or digging through menus. Instead of logging into a dashboard to see if you're low on stock or checking a CRM to find a regular's last order, you just ask your agent. You can pull up sales data, look up customer spend, or check team roles without ever leaving your chat interface. It brings your commerce data into one place. Because Vinkius hosts this Connector, you can plug it into your favorite AI client and start managing your entire Square shop with just a few words. It's about getting answers faster so you can spend more time running the actual business. ## Tools ### create_payment Create a new payment ### get_stock_count Retrieve stock levels ### get_order_details Get metadata for an order ### get_payment_details Get metadata for a payment ### list_customers List store customers ### list_store_locations List your business locations ### search_orders Requires location_ids. Search for store orders ### list_payments See a list of recent payments to track daily intake. This is great for checking your daily revenue at a glance. ### list_catalog Browse your entire product list and menu items. Use it to see everything you have for sale. ### search_customers Find customer profiles including visit history and total spend. It provides a quick look at your regular shoppers. ### get_customer View the full profile and notes for a specific customer. This helps you see personal details and visit history. ## Prompt Examples **Prompt:** ``` Show me today's payments and total tips collected ``` **Response:** ``` 🟦 **Today's Payments — Oct 18** 💰 **Total**: $4,230 (67 transactions) 💳 **Card**: $3,890 | 💵 **Cash**: $340 💝 **Tips**: $487 (11.5% avg) 📊 **Breakdown**: Dine-in 72% | Takeout 18% | Delivery 10% ``` **Prompt:** ``` What is the current stock level for medium T-shirts downtown? ``` **Response:** ``` 📦 **Inventory Check: Downtown Location** Item: Logo T-Shirt (Medium) Current Quantity: **14 units** Status: Low stock alert (minimum threshold is 15) ``` **Prompt:** ``` Show me a list of my top 5 customers by total spend. ``` **Response:** ``` 🏆 **Top 5 Customers by Lifetime Spend** 1. Elena Rodriguez — $4,250 (32 visits) 2. Marcus Chen — $3,890 (24 visits) 3. Sarah Jenkins — $3,100 (15 visits) 4. David Smith — $2,750 (18 visits) 5. Liam O'Connor — $2,420 (12 visits) ``` ## Capabilities ### Track daily sales This Connector pulls your recent payment history so you can see exactly how much money came in today. ### Check real-time stock levels This Connector lets you see current inventory counts across all your different business locations. ### Look up customer loyalty and spend This Connector retrieves customer profiles including their total spend and visit history for better service. ### Manage product menus and pricing This Connector lets you view your entire product catalog to keep your offerings up to date. ### View order fulfillments and discounts This Connector shows you the details of your sales history including line items and applied discounts. ### See employee roles and locations This Connector lists your team members and their specific roles across your various locations. ## Use Cases ### Checking stock levels A manager asks for the count of medium shirts downtown and gets a low-stock alert instantly. ### Sales recap A cafe owner asks for today's total tips and gets a breakdown of cash vs card payments. ### Customer lookup A server wants to see a regular's total spend to offer a loyalty discount during a busy lunch. ### Team check An owner needs to see who is working at the second location during the morning rush. ## Benefits - Get instant sales summaries without opening the Square dashboard by pulling recent payment data. - Prevent stockouts by checking real-time counts across all your locations from a single chat. - Identify your best shoppers by quickly pulling spend history and loyalty notes. - Keep your menu current by viewing your entire product list and pricing in seconds. - Track fulfillment progress on every sale to ensure your customers get their orders on time. - Manage your workforce more easily by viewing employee roles and locations from any device. ## How It Works The bottom line is you get a conversational interface for your entire Square business backend. 1. Connect your Square account to the Connector through the Vinkius dashboard. 2. Authorize your AI client to access your specific commerce and inventory data. 3. Ask questions about your sales, stock, or customers in plain English. ## Frequently Asked Questions **Can the Square MCP help me manage my retail inventory?** Yes. It allows your AI agent to pull real-time stock counts from your Square account so you can check availability without opening the dashboard. **How do I use the Square MCP to see my daily sales?** You can simply ask your AI client for a summary of your recent payments. It will pull the data and show you your total intake and payment types. **Can the Square MCP find my regular customers?** Yes, it can search your customer profiles to find visit history, total spend, and loyalty notes, making it easier to provide personalized service. **Does the Square MCP work with my team's roles?** It can list your team members and their assigned roles across all your business locations, helping you manage your staff more efficiently. **Can I use the Square MCP to check my product catalog?** Absolutely. You can ask your agent to list your products or look up specific details for any item in your menu or inventory. **What businesses use Square?** Square serves millions of merchants worldwide — restaurants, retail, services, and online businesses. From food trucks to multi-location restaurant groups. **Does Square support inventory management across multiple locations?** Yes, Square allows you to track and manage inventory levels across various locations in real-time. **Can I track employee hours and roles?** Yes, you can manage team members, assign specific roles, and track their shifts and performance. **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.