MCP Server LogoMCP Server
HomeCategoriesDirectorySubmit
Submit
HomeCategoriesDirectorySubmit
Submit

MCP Servers

A curated list of MCP Servers, featuring Awesome MCP Servers and Claude MCP integration.

Contact Us

[email protected]

About

Privacy PolicyTerms of Service

Resources

Model Context ProtocolMCP Starter GuideClaude MCP Servers

Community

GitHub

© 2025 mcpserver.cc © 2025 MCP Server. All rights reserved.

Privacy PolicyTerms of Service
  1. Home
  2. /Categories
  3. /Developer Tools
  4. /Square Mcp Server
Square Mcp Server

Square Mcp Server

Created by square•2 days ago
Visit Website

A Model Context Protocol (MCP) server for square

Developer Tools
MCPModel Context Protocolserver

Square Model Context Protocol Server (Beta)

This project follows the Model Context Protocol standard, allowing AI assistants to interact with Square’s connect API.

Quick Start

Get up and running with the Square MCP server using npx:

## Basic startup
npx square-mcp-server start

## With environment configuration
ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start

## local runs
npx /path/to/project/square-mcp-server

Replace YOUR_SQUARE_ACCESS_TOKEN with your actual Square access token. You can obtain your access token by following the guide at Square Access Tokens. You can also set environment variables before running the command.

Remote MCP Server

Square now offers a hosted remote MCP server at:

https://mcp.squareup.com/sse

The remote MCP is recommended as it uses OAuth authentication, allowing you to log in with your Square account directly without having to create or manage access tokens manually.

Configuration Options

Environment Variable Purpose Example
ACCESS_TOKEN Your Square API access token ACCESS_TOKEN=sq0atp-...
SANDBOX Use Square sandbox environment SANDBOX=true
PRODUCTION Use Square production environment PRODUCTION=true
DISALLOW_WRITES Restrict to read-only operations DISALLOW_WRITES=true
SQUARE_VERSION Specify Square API version SQUARE_VERSION=2025-04-16

Integration with AI Assistants

Goose Integration

To configure the Square MCP Server with Goose:

Remote MCP

To install the Square remote MCP in Goose, click this URL on a computer where Goose is installed:

goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fmcp.squareup.com%2Fsse&id=square_mcp_production_remote&name=Square%20MCP%20Remote&description=Square%20Production%20MCP%20Remote

Or copy and paste the URL into your browser’s address bar.

## Automatic installation
npx square-mcp-server install

## Get URL for manual installation
npx square-mcp-server get-goose-url

The install command automatically updates your Goose configuration.

Claude Desktop Integration

For Claude Desktop integration, see the Model Context Protocol Quickstart Guide. Add this configuration to your claude_desktop_config.json:

Remote MCP

{
  "mcpServers": {
    "mcp_square_api": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.squareup.com/sse"]
    }
  }
}

This approach allows you to authenticate directly with your Square account credentials without needing to manage access tokens.

Local MCP

{
  "mcpServers": {
    "mcp_square_api": {
      "command": "npx",
      "args": ["square-mcp-server", "start"],
      "env": {
        "ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN",
        "SANDBOX": "true"
      }
    }
  }
}

Tool Reference

The Square MCP Server provides a streamlined set of tools for interacting with Square APIs:

Tool Description Primary Use
get_service_info Discover methods available for a service Exploration and discovery
get_type_info Get detailed parameter requirements Request preparation
make_api_request Execute API calls to Square Performing operations

Service Catalog

Square MCP Server provides access to Square’s complete API ecosystem. Check out the Square API Documentation for detailed information about each service:

Service Description
applepay Apple Pay integration
bankaccounts Bank account management
bookingcustomattributes Custom attributes for bookings
bookings Appointment booking management
cards Payment card management
cashdrawers Cash drawer management
catalog Catalog management (items, categories, etc.)
checkout Checkout and payment processing
customercustomattributes Custom attributes for customers
customergroups Customer grouping
customersegments Customer segmentation
customers Customer management
devices Square device management
disputes Payment dispute handling
events Event tracking
giftcardactivities Gift card activity tracking
giftcards Gift card management
inventory Inventory tracking
invoices Invoice management
labor Workforce management
locationcustomattributes Custom attributes for locations
locations Location management
loyalty Loyalty program management
merchantcustomattributes Custom attributes for merchants
merchants Merchant account management
oauth Authentication
ordercustomattributes Custom attributes for orders
orders Order management
payments Payment processing
payouts Payout management
refunds Refund management
sites Website integration
snippets Square Online Code integration
subscriptions Subscription management
team Staff management
terminal Square Terminal management
vendors Supplier management
webhooksubscriptions Event notifications

Usage Pattern

For optimal interaction with the Square API through MCP:

  1. Discover: Use get_service_info to explore available methods

    get_service_info(service: "catalog")
    
  2. Understand: Use get_type_info to learn parameter requirements

    get_type_info(service: "catalog", method: "list")
    
  3. Execute: Use make_api_request to perform the operation

    make_api_request(service: "catalog", method: "list", request: {})
    

Development and Debugging

Using MCP Inspector

The MCP Inspector provides a visual interface for testing:

## Build the project
npm run build

## Start the inspector with the Square MCP Server
npx @modelcontextprotocol/inspector node dist/index.js start

Development Workflow

  1. Clone the repository
  2. Install dependencies: npm install
  3. Start development mode: npm run watch
  4. Run the server: node dist/index.js start
  5. Test your changes using the MCP Inspector

Contributing

This repository is auto-generated from Square’s OpenAPI Specification. While contributions are welcome, please note that changes will need to be incorporated into the generator that produces this code. Please open an issue to discuss proposed changes before submitting a pull request.

Prerequisites

  • •Familiarity with the server domain
  • •Basic understanding of related technologies
  • •Knowledge of Developer Tools

Recommended Server

Elasticsearch Mcp

Elasticsearch Mcp

Elasticsearch MCP server with available features including mappings management, search and indexing, and index management etc.

Jira Mcp

Jira Mcp

A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow transitions.

Minimax Mcp

Minimax Mcp

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

View more → →

Details

Created

June 11, 2025

Last Updated

June 11, 2025

Category

Developer Tools

Author

square

Share

More Server

Conductor Tasks

Conductor Tasks

A task management system designed for AI development

Stata Mcp

Stata Mcp

Stata MCP Extension for VS Code and Cursor IDE

Opnsense Mcp Server

Opnsense Mcp Server

A Model Context Protocol (MCP) server implementation for managing OPNsense firewalls. This server allows Claude and other MCP-compatible clients to interact with all features exposed by the OPNsense API.

Devdb Vscode

Devdb Vscode

A zero-config VS Code database extension with affordances to aid development and debugging.