Skip to main content
Glama
block

Square MCP Server

by block
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SQUARE_ENVIRONMENTNoSquare API environment ('sandbox' or 'production')sandbox
SQUARE_ACCESS_TOKENYesYour Square API access token

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription
paymentsC

Manage payment operations using Square API

Args:
    operation: The operation to perform. Valid operations:
        Payments:
            - list_payments
            - create_payment
            - get_payment
            - update_payment
            - cancel_payment
        Refunds:
            - refund_payment
            - list_refunds
            - get_refund
        Disputes:
            - list_disputes
            - retrieve_dispute
            - accept_dispute
            - create_dispute_evidence
        Gift Cards:
            - create_gift_card
            - link_customer_to_gift_card
            - retrieve_gift_card
            - list_gift_cards
        Bank Accounts:
            - list_bank_accounts
            - get_bank_account
    params: Dictionary of parameters for the specific operation
terminalB

Manage Square Terminal operations

Args:
    operation: The operation to perform. Valid operations:
        Checkout:
            - create_terminal_checkout
            - search_terminal_checkouts
            - get_terminal_checkout
            - cancel_terminal_checkout
        Devices:
            - create_terminal_device
            - get_terminal_device
            - search_terminal_devices
        Refunds:
            - create_terminal_refund
            - search_terminal_refunds
            - get_terminal_refund
            - cancel_terminal_refund
    params: Dictionary of parameters for the specific operation
ordersC

Manage orders and checkout operations

Args:
    operation: The operation to perform. Valid operations:
        Orders:
            - create_order
            - batch_retrieve_orders
            - calculate_order
            - clone_order
            - search_orders
            - pay_order
            - update_order
        Checkout:
            - create_checkout
            - create_payment_link
        Custom Attributes:
            - upsert_order_custom_attribute
            - list_order_custom_attribute_definitions
    params: Dictionary of parameters for the specific operation
catalogC

Manage catalog operations

Args:
    operation: The operation to perform. Valid operations:
        - create_catalog_object
        - batch_delete_catalog_objects
        - batch_retrieve_catalog_objects
        - batch_upsert_catalog_objects
        - create_catalog_image
        - delete_catalog_object
        - retrieve_catalog_object
        - search_catalog_objects
        - update_catalog_object
        - update_item_modifier_lists
        - update_item_taxes
    params: Dictionary of parameters for the specific operation
inventoryC

Manage inventory operations

Args:
    operation: The operation to perform. Valid operations:
        - batch_change_inventory
        - batch_retrieve_inventory_changes
        - batch_retrieve_inventory_counts
        - retrieve_inventory_adjustment
        - retrieve_inventory_changes
        - retrieve_inventory_count
        - retrieve_inventory_physical_count
        - retrieve_inventory_transfer
    params: Dictionary of parameters for the specific operation
subscriptionsB

Manage subscription operations

Args:
    operation: The operation to perform. Valid operations:
        - create_subscription
        - search_subscriptions
        - retrieve_subscription
        - update_subscription
        - cancel_subscription
        - list_subscription_events
        - pause_subscription
        - resume_subscription
        - swap_plan
    params: Dictionary of parameters for the specific operation
invoicesC

Manage invoice operations

Args:
    operation: The operation to perform. Valid operations:
        - create_invoice
        - search_invoices
        - get_invoice
        - update_invoice
        - cancel_invoice
        - publish_invoice
        - delete_invoice
    params: Dictionary of parameters for the specific operation
teamC

Manage team operations

Args:
    operation: The operation to perform. Valid operations:
        Team Members:
            - create_team_member
            - bulk_create_team_members
            - update_team_member
            - retrieve_team_member
            - search_team_members
        Wages:
            - retrieve_wage_setting
            - update_wage_setting
        Labor:
            - create_break_type
            - create_shift
            - search_shifts
            - update_shift
            - create_workweek_config
        Cash Drawers:
            - list_cash_drawer_shifts
            - retrieve_cash_drawer_shift
    params: Dictionary of parameters for the specific operation
customersC

Manage customer operations

Args:
    operation: The operation to perform. Valid operations:
        Customers:
            - list_customers
            - create_customer
            - delete_customer
            - retrieve_customer
            - update_customer
            - search_customers
        Groups:
            - create_customer_group
            - delete_customer_group
            - list_customer_groups
            - retrieve_customer_group
            - update_customer_group
        Segments:
            - list_customer_segments
            - retrieve_customer_segment
        Custom Attributes:
            - create_customer_custom_attribute_definition
            - delete_customer_custom_attribute_definition
            - list_customer_custom_attribute_definitions
    params: Dictionary of parameters for the specific operation
loyaltyC

Manage loyalty operations

Args:
    operation: The operation to perform. Valid operations:
        Programs:
            - create_loyalty_program
            - retrieve_loyalty_program
        Accounts:
            - create_loyalty_account
            - search_loyalty_accounts
            - retrieve_loyalty_account
            - accumulate_loyalty_points
            - adjust_loyalty_points
            - search_loyalty_events
        Promotions:
            - create_loyalty_promotion
            - cancel_loyalty_promotion
    params: Dictionary of parameters for the specific operation
bookingsC

Manage booking operations

Args:
    operation: The operation to perform. Valid operations:
        Bookings:
            - create_booking
            - search_bookings
            - retrieve_booking
            - update_booking
            - cancel_booking
        Team Member Bookings:
            - bulk_retrieve_team_member_bookings
            - retrieve_team_member_booking_profile
        Location Profiles:
            - list_location_booking_profiles
            - retrieve_location_booking_profile
        Custom Attributes:
            - create_booking_custom_attribute_definition
            - update_booking_custom_attribute_definition
    params: Dictionary of parameters for the specific operation
businessC

Manage business operations

Args:
    operation: The operation to perform. Valid operations:
        Merchants:
            - list_merchants
            - retrieve_merchant
        Locations:
            - list_locations
            - create_location
            - retrieve_location
            - update_location
        Vendors:
            - bulk_create_vendors
            - bulk_retrieve_vendors
            - create_vendor
            - search_vendors
            - update_vendor
        Sites:
            - list_sites
    params: Dictionary of parameters for the specific operation

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.3/5.0

Scored across 12 tools

Disambiguation4/5

The tools are organized into clear domains (bookings, business, catalog, etc.), each with distinct purposes, reducing overlap. However, within some domains, operations like 'create' and 'update' across different resources might be conceptually similar, but the structured categorization helps differentiate them. There is minor potential for confusion in operations like 'search' vs 'list' across tools, but overall, the separation is effective.

Naming Consistency5/5

The tool names follow a highly consistent pattern: all are simple nouns (e.g., bookings, business, catalog) that correspond to Square API domains. Within each tool, operations use a consistent verb_noun format (e.g., create_booking, list_locations), with no mixing of conventions like camelCase or snake_case deviations. This uniformity makes the set predictable and easy to navigate.

Tool Count5/5

With 12 tools, the server is well-scoped for a comprehensive Square API integration, covering key business areas like payments, orders, inventory, and more. Each tool represents a distinct domain, and the count is appropriate for the broad functionality offered, avoiding both excessive fragmentation and insufficient coverage. It aligns with typical MCP server ranges for such APIs.

Completeness5/5

The tool set provides extensive coverage of Square's API domains, including CRUD operations for resources like bookings, customers, orders, and payments, as well as lifecycle management for subscriptions and invoices. There are no obvious gaps; each domain includes create, retrieve, update, delete, and search/list operations, ensuring agents can handle full workflows without dead ends.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources