Square MCP. Manage Payments and Inventory from Chat.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Square connects your payments, customer data, and inventory into one chat interface. Use your AI client to automate commerce tasks that usually require jumping between separate apps.
Check real-time stock counts (`get_stock_count`), find specific customers by name or ID (`search_customers`), list recent transactions (`list_payments`), and even create new payments with a single command.
What your AI agents can do
Create payment
Generates a new payment record in your Square account.
Get customer
Retrieves specific profile details for one customer by ID.
List catalog
Shows every available product in your entire store's product list.
Run a new transaction using create_payment.
Retrieve specific details about any listed customer via get_customer or search_customers.
Pull metadata for a full order lifecycle using get_order_details.
Retrieve deep metadata on completed or pending payments with get_payment_details.
Get the current count for any catalog item using get_stock_count.
List all your business sites (list_store_locations) or view the full list of available products (list_catalog).
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 CompatibleWaiting for input…
Square: 11 Tools for E-commerce Operations
These tools let your AI client interact with every core function of Square—from creating new payments to checking stock counts and listing customer records.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Square on Vinkius019dd166create payment
Generates a new payment record in your Square account.
019dd166get customer
Retrieves specific profile details for one customer by ID.
019dd166list catalog
Shows every available product in your entire store's product list.
019dd166get stock count
Returns the current inventory level for a specific catalog item SKU.
019dd166get order details
Pulls metadata for a specific order, including line items and totals.
019dd166get payment details
Gets detailed transaction information about a payment record.
019dd166list customers
Returns a list of all customer profiles stored in Square.
019dd166list store locations
Retrieves a list of all physical and online business locations you manage.
019dd166list payments
Lists recent payments made at your store, with support for filtering by dates or types.
019dd166search customers
Finds specific customers by name or other identifying details.
019dd166search orders
Searches for store orders, requiring you to specify which location IDs to look through.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Square, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Square. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Reconciling daily sales takes hours of clicking through dashboards.
Right now, if you need to reconcile a day's worth of sales, you open the Square dashboard. You check payments for date ranges, then switch tabs to view location data, and maybe download separate reports for credit cards versus cash. It’s clicking through 4–5 different pages just to get one summary.
With this server, you ask your agent: 'Show me all sales from today.' The system runs the necessary tools (`list_payments`, `search_orders`) and gives you a consolidated report in chat—total revenue, breakdowns by payment type, and location performance. It saves you the dashboard navigation entirely.
The Square MCP Server: Manage Payments, Customers & Inventory
Previously, checking customer purchase history meant using one tool to find the client ID and then running a completely different query or report generation feature just to see their past orders. It was always a multi-step manual process that often missed data points.
Now, you simply ask your agent: 'Show me David Chen's full order history.' The system uses `search_customers` first, and then pulls all relevant details using `get_order_details`. You get the whole picture—purchase dates, item names, total value—in one clean response. It’s immediate.
What you can do with this MCP connector
Square MCP Server - Payments, Inventory & CRM Tools
Your AI client connects directly to your full Square account. You use this server to automate commerce tasks that usually mean jumping through a dozen different apps. It lets you manage everything from processing sales to checking stock counts without ever leaving your chat window.
Processing Transactions and Financial Data
To run a new sale, simply call create_payment, which generates a complete payment record right in your Square account. You can pull a list of recent payments using list_payments; this tool even lets you filter by date ranges or payment types to narrow down the data. If you need deep metadata on any completed or pending transaction, use get_payment_details to grab all the specifics about that payment record.
Managing Customers and Leads
You don't gotta guess who bought what; your AI client handles it. You can search for specific customer profiles by name or other identifying details using search_customers. If you know the ID, get_customer retrieves all the specific profile information for that one person. For a full roster of everyone in your database, use list_customers to return a list of every single customer profile stored in Square.
Tracking Orders and Store Activity
You can pull metadata for an entire order lifecycle using get_order_details, which includes line items and the grand totals. To check historical sales across your business, you search for store orders with search_orders; this function requires you to specify which location IDs you want it to look through.
Inventory and Product Catalog Management
When you need to know what you've got on hand, use the tools. To get the current inventory level for any specific catalog item SKU, just run get_stock_count. For a complete view of every product available in your store, list_catalog shows you the entire product list across all categories. You can also check out all the physical and online business sites you manage by calling list_store_locations, which returns a comprehensive list of all your locations.
Putting It All Together
The server lets you combine these functions into complex workflows. For example, if you need to know how many widgets you have in stock (get_stock_count) and want to verify the purchase history for a client named Bob (search_customers), your AI client executes both steps sequentially within one conversation thread. You can also pull up all orders associated with a specific location ID that you just pulled from list_store_locations, giving you a complete view of operations without switching tabs.
This setup lets you run complex business logic—like checking stock levels across multiple locations or reviewing a customer's entire order history while simultaneously processing a new payment—all using natural conversation. It’s built to handle the whole commerce stack, making sure your AI agent has all the data it needs right where it is.
019dd166-e139-7252-b11f-3cdf1410aba9 How Square MCP Works
- 1 1. Subscribe to this server and enter your Square Personal Access Token from your developer dashboard.
- 2 2. Tell your AI client what you need—for example, 'What were my payments last week?' or 'Check stock for SKU 456.'
- 3 3. Your agent uses the relevant tool (like
list_paymentsorget_stock_count) and delivers a plain-language summary of the results.
The bottom line is, you talk to your AI client like talking to an employee who has full access to every business dashboard.
Who Is Square MCP For?
Retail owners and operations managers using this server. You're the person who gets paid to keep track of inventory across five different physical locations, and you’re sick of spending half your day switching between Square Dashboard, Excel sheets, and email threads just to reconcile a single sale.
Monitors multi-location data. They use this server to track payment statuses across all sites or check stock levels from a central chat.
Quickly checks recent sales figures or inventory counts without opening the main Square web portal.
Automates pulling customer order history and profile details for support, minimizing time spent navigating multiple screens.
What Changes When You Connect
- Stop switching apps. Instead of logging into the dashboard to check inventory, just ask your agent to run
get_stock_countfor a SKU and get an immediate number. - Deep visibility on sales. You don't have to manually sift through reports; running
list_paymentsgives you transaction totals, statuses (Pending/Failed), and methods used—all in one go. - Customer history at your fingertips. Need to know what David Chen bought last year? Use
search_customersfollowed byget_order_details. It pulls the whole timeline instantly. - Location overview without clicking through menus. You can run
list_store_locationsand see metadata for every site you manage, keeping your multi-branch operations synced. - Streamlined payment reconciliation. Instead of downloading PDFs to check revenue, use
get_payment_detailsto verify specific amounts and methods used on any given transaction.
Real-World Use Cases
Checking last-minute stock counts
A store associate needs to know if an item is available for a walk-in customer. Instead of walking to the back room or checking inventory software, they ask their agent to run get_stock_count. The agent replies with the real-time count, letting them close the sale instantly.
Reconciling cash receipts
An operations manager needs to confirm all payments from a specific date. They tell their agent to run list_payments. The response shows total amounts, how many were processed by credit card vs. cash, and the average transaction value, eliminating manual spreadsheet work.
Investigating a customer complaint
A support agent needs to know why a high-value customer hasn't bought anything in months. They use search_customers to find the profile and then run get_order_details to show the last order date, total lifetime value, and favorite products.
Auditing multi-location sales
A manager needs a quick snapshot of all their sites. They ask to use list_store_locations. The agent returns a list with associated metadata for every location, confirming which ones are active and where the business operates.
The Tradeoffs
Over-relying on screenshots
Taking a picture of the payments dashboard and sending it to accounting. They then have to manually type out dates, totals, and methods for reconciliation.
→
Don't screenshot. Use list_payments or get_payment_details. The agent gives you structured data—dates, amounts, status, method—ready for a spreadsheet.
Assuming inventory is always up to date
A customer asks about product X, and the store employee says 'Yeah, we have plenty.' Only to find out later they were wrong because no one checked the backend system.
→
Always check first. Use get_stock_count before confirming availability. It pulls the actual, real-time count from Square.
Searching for customers by memory
Trying to remember if a customer used Visa or Apple Pay last time they bought something and having to manually check transaction logs page by page.
→
Use search_customers to pull the profile. It aggregates payment methods on file, so you get that info instantly.
When It Fits, When It Doesn't
Use this server if your job requires looking at interconnected business data: payments + inventory + people. You need a single source of truth for commerce operations. If you only ever need to write a simple transaction or just check one piece of information (like checking the current weather), don't use it; that's overkill. Don't use this if your primary task is generating reports outside of Square, like complex marketing funnels—you'll still need dedicated CRM tools for those. However, if you are managing multiple locations and need to keep payment records synced with stock levels, this server connects the dots using tools like list_store_locations, list_payments, and get_stock_count simultaneously.
Common Questions About Square MCP
How do I list payments for specific date ranges using list_payments? +
The agent handles the filtering by accepting start and end dates as parameters when you call list_payments. You just need to tell it the time window you're interested in.
Can I search for customers by phone number using search_customers? +
Yes. The search_customers tool lets you query customer records using various identifiers, including phone numbers and names. It finds the ID first, then retrieves the full profile.
What tools do I use to check inventory across multiple locations? +
You start by running list_store_locations to confirm your site IDs. Then, you pass those IDs and specific SKUs to get_stock_count for a comprehensive count.
Which tool do I use if I want to know the total revenue from today? +
You should ask your agent to run list_payments. It aggregates all transactions for that period, giving you the grand total and status breakdown immediately.
What credentials do I need to use list_store_locations? +
You must provide a Square Personal Access Token (PAT) with read permissions. This token is generated in your developer dashboard and grants your AI client the necessary access rights for location data.
If I use get_order_details, what specific metadata can I retrieve? +
The tool gathers comprehensive order metadata. You get details like item lists, associated customer IDs, and confirmation of which payment method was used for that purchase.
When running list_payments, how do I identify transactions that failed or are pending? +
The results contain a distinct 'status' field. You can filter the output by looking for statuses like 'FAILED', 'PENDING', or 'COMPLETED' to triage your revenue immediately.
How do I use list_catalog to see every product we sell? +
This tool returns a master list of all catalog items. It provides item names, descriptions, and unique SKUs—perfect for building out an inventory manifest before checking current stock levels.
How do I find my Square Personal Access Token? +
Log in to your Square Developer Dashboard, 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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.