Square MCP Server
🚨 더 이상 사용되지 않음: Square MCP 서버(이전 버전)
⚠️ 이 저장소는 더 이상 유지되지 않습니다.
공식 개발은 square/square-mcp-server 로 옮겨졌습니다.
최신 공식 지원되는 Square MCP 서버는 새 저장소를 사용하세요.
보관된 정보(참조용)
Square API 기능에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.
Related MCP server: PostGIS MCP Server
설정
종속성 설치:
지엑스피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서버를 실행합니다:
uv pip install .
square-mcp또는 개발을 위해:
source .venv/bin/activate
mcp dev src/square_mcp/server.py환경 변수
변하기 쉬운 | 필수의 | 기본 | 설명 |
| 예 | - | Square API 액세스 토큰 |
| 아니요 |
| Square API 환경( |
🔗 새로운 서버로 마이그레이션:
Available Tools
12 toolsbookingsC
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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for interacting with the Supabase platform
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.-
- AlicenseBqualityDmaintenanceA server application that provides PostGIS database connection using Model Context Protocol (MCP), enabling spatial database functionality through natural language interactions.2221ISC
- AlicenseNot gradedqualityDmaintenanceA demonstration MCP server that enables read-only SQL queries and schema exploration of a synthetic IaaS database through the Metabase API.MIT

MCP Marketing Analyticsofficial
FlicenseAqualityDmaintenanceA minimal MCP server for marketing analytics data discovery and querying, supporting Google Ads integration with mock fallback and real API access.5-