24 actions ready for your AI
Connect Square to your AI
Connect Square once and every AI you use can list customers, create customers and list customer groups through it.
Needs your API keyWorks today: paste the key from this app and your AI can use it. One-click sign-in is not built yet.
Not verified by us yet. Its actions come from Square's own documented API, and we have not run them here yet.
Use your own Square account. Credentials stay encrypted in ahel.
Tell me when ahel has verified Square
What your AI can do with Square
Choose a task and ask your AI.
Customer
- List customers
GETListCustomers
cursor- A pagination cursor returned by a previous call to this endpoint.
limit- The maximum number of results to return in a single page.
sort_field- Indicates how customers should be sorted.
sort_order- Indicates whether customers should be sorted in ascending (ASC) or descending (DESC) order.
- Create customer
POSTCreateCustomer
address- Represents a postal address in a country.
birthday- The birthday associated with the customer profile, in RFC 3339 format.
company_name- A business name associated with the customer profile.
email_address- The email address associated with the customer profile.
- List customer groups
GETListCustomerGroups
cursor- A pagination cursor returned by a previous call to this endpoint.
limit- The maximum number of results to return in a single page.
- Create customer group
POSTCreateCustomerGroup
grouprequired- Represents a group of customer profiles.
idempotency_key- The idempotency key for the request.
- Search customers
POSTSearchCustomers
cursor- Include the pagination cursor in subsequent calls to this endpoint to retrieve the next set of results associated with the original query.
limit- The maximum number of results to return in a single page.
query- Represents a query (including filtering criteria, sorting criteria, or both) used to search for customer profiles.
- List customer segments
GETListCustomerSegments
cursor- A pagination cursor returned by previous calls to ListCustomerSegments.
limit- The maximum number of results to return in a single page.
- Create customer card
POSTCreateCustomerCard
customer_idrequired- The Square ID of the customer profile the card is linked to.
card_noncerequired- A card nonce representing the credit card to link to the customer.
billing_address- Represents a postal address in a country.
cardholder_name- The full name printed on the credit card.
- Retrieve customer
GETRetrieveCustomer
customer_idrequired- The ID of the customer to retrieve.
- Retrieve customer group
GETRetrieveCustomerGroup
group_idrequired- The ID of the customer group to retrieve.
- Retrieve customer segment
GETRetrieveCustomerSegment
segment_idrequired- The Square-issued ID of the customer segment.
Loyalty
- Create loyalty account
POSTCreateLoyaltyAccount
idempotency_keyrequired- A unique string that identifies this CreateLoyaltyAccount request.
loyalty_accountrequired- Describes a loyalty account.
- List loyalty programs
GETListLoyaltyPrograms
- Create loyalty reward
POSTCreateLoyaltyReward
idempotency_keyrequired- A unique string that identifies this CreateLoyaltyReward request.
rewardrequired- Represents a contract to redeem loyalty points for a reward tier discount.
Break
- List break types
GETListBreakTypes
location_id- Filter the returned BreakType results to only those that are associated with the specified location.
limit- The maximum number of BreakType results to return per page.
cursor- A pointer to the next page of BreakType results to fetch.
- Create break type
POSTCreateBreakType
break_typerequired- A defined break template that sets an expectation for possible Break instances on a Shift.
idempotency_key- A unique string value to ensure the idempotency of the operation.
Location
- List locations
GETListLocations
- Create location
POSTCreateLocation
Show 6 more groups
Shift
- Create shift
POSTCreateShift
shiftrequired- A record of the hourly rate, start, and end times for a single work shift for an employee.
idempotency_key- A unique string value to ensure the idempotency of the operation.
- Search shifts
POSTSearchShifts
cursor- An opaque cursor for fetching the next page.
limit- The number of resources in a page (200 by default).
query- The parameters of a Shift search query, which includes filter and sort options.
Employee
- List employee wages
GETListEmployeeWages
employee_id- Filter the returned wages to only those that are associated with the specified employee.
limit- The maximum number of EmployeeWage results to return per page.
cursor- A pointer to the next page of EmployeeWage results to fetch.
Gift
- List gift cards
GETListGiftCards
type- If a type is provided, gift cards of this type are returned (see GiftCardType).
state- If the state is provided, it returns the gift cards in the specified state (see GiftCardStatus).
limit- If a value is provided, it returns only that number of results per page.
cursor- A pagination cursor returned by a previous call to this endpoint.
Order
- Create order
POSTCreateOrder
idempotency_key- A value you specify that uniquely identifies this order among orders you have created.
order- Contains all information related to a single order to process with Square, including line items that specify the products to purchase.
Team Member
- List team member wages
GETListTeamMemberWages
team_member_id- Filter the returned wages to only those that are associated with the specified team member.
limit- The maximum number of TeamMemberWage results to return per page.
cursor- A pointer to the next page of EmployeeWage results to fetch.
Workweek
- List workweek configs
GETListWorkweekConfigs
limit- The maximum number of WorkweekConfigs results to return per page.
cursor- A pointer to the next page of WorkweekConfig results to fetch.
Ask your AI
Try one of these requests with a connected AI.
- List my customers in Square
- Create a customer in Square
- List my customer groups in Square
- Create a customer group in Square
- Find customers in Square
- List my customer segments in Square
Published servers for Square
Built by the community and served through your gateway with the same key. A curated pick is one ahel has checked.
Square MCP server, hosted by ahel
One hosted endpoint serves Square. There is nothing to install and no local server to run.
Connect Square to Claude, Claude Code, Cursor or Codex
- Add your Square key. ahel stores it encrypted.
- Paste one link into your AI:
https://mcp.ahel.ai(once, for every app). - Ask for the work. Your AI picks the action and ahel runs it with your key.
Documentation
- Square API docssquareup.com
- Where to find your Square keyon the vendor's side; paste it into ahel after sign-in
About Square
Square is a payments service. Connect your own Square account, by signing in or with a key, and ahel holds it sealed and signs your AI's calls with it.
Square over MCP: ahel serves Square to Claude, Claude Code, Cursor and Codex as one hosted MCP endpoint. There is no local server to run. Add your Square key once, paste one link into your AI, and the actions above are there.
Questions
Is my Square key safe?
Your Square key is sealed in ahel and added to the request server-side when your AI calls Square. It never crosses the MCP link, no tool can read it back, and you can turn the app off or remove the key at any time.
Which AIs can use Square through ahel?
Any MCP-capable AI: Claude, Claude Code, Codex, Cursor, VS Code and others. Paste one link, https://mcp.ahel.ai, into the AI once and everything in your gateway arrives through it.
What can my AI do with Square?
24 actions today, covering customers, loyalties and breaks. Ask in plain language; your AI picks the action and ahel runs it with your key.
Does connecting Square cost anything?
Connecting apps is free during ahel's early access. Free, Pro and Team all cost nothing today, and the pricing page lists what each one includes. Square may bill you for API use under its own terms.