Skip to main content
Glama
Square MCP Server

Square MCP Server

by block

🚨 已弃用:Square MCP 服务器(旧版本)

⚠️ 此存储库不再维护。
官方开发已转移到square/square-mcp-server 。
请使用新的存储库来获取最新的、官方支持的 Square MCP Server。


存档信息(供参考)

提供对 Square API 功能访问的模型上下文协议 (MCP) 服务器。

Related MCP server: PostGIS MCP Server

设置

  1. 安装依赖项:

uv sync
  1. 设置环境变量:

# Required
export SQUARE_ACCESS_TOKEN=your_access_token_here

# Optional - defaults to 'sandbox' if not set
export SQUARE_ENVIRONMENT=sandbox  # or 'production' for production environment
  1. 运行服务器:

uv pip install .
square-mcp

或者用于开发:

source .venv/bin/activate
mcp dev src/square_mcp/server.py

环境变量

多变的

必需的

默认

描述

SQUARE_ACCESS_TOKEN

是的

-

您的 Square API 访问令牌

SQUARE_ENVIRONMENT

不

sandbox

Square API 环境( sandbox或production )


🔗 迁移到新服务器:

Available Tools

12 tools
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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

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

Inputs: operation (required), params (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.
      -
    • A
      license
      B
      quality
      D
      maintenance
      A server application that provides PostGIS database connection using Model Context Protocol (MCP), enabling spatial database functionality through natural language interactions.
      22
      21
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      A demonstration MCP server that enables read-only SQL queries and schema exploration of a synthetic IaaS database through the Metabase API.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A minimal MCP server for marketing analytics data discovery and querying, supporting Google Ads integration with mock fallback and real API access.
      5
      -