O que é Square MCP Server?
A Square, parte da Block, hospeda seu servidor MCP em https://mcp.squareup.com/mcp com login OAuth; um endpoint /sse mais antigo ainda é servido. Só clientes aprovados podem se conectar, como proteção contra registro malicioso de clientes, e a documentação lista Claude.ai, Claude Desktop, Goose, Cursor e Windsurf. O servidor hospedado só alcança dados de produção, e o projeto inteiro ainda é rotulado como beta.
Para testes em sandbox, você roda o servidor local de código aberto com npx square-mcp-server start, um ACCESS_TOKEN e SANDBOX=true. DISALLOW_WRITES=true o torna somente leitura e SQUARE_VERSION fixa a versão da API. O pacote npm não tem nova versão desde a 0.1.2, de 25 de abril de 2025, embora o README do repositório tenha sido revisado em outubro de 2026 para direcionar a maioria dos usuários ao servidor hospedado.
Em vez de uma ferramenta por endpoint, ele tem três: get_service_info para descobrir os métodos de um serviço, get_type_info para obter detalhes dos parâmetros e make_api_request para chamar a API. Isso alcança 38 serviços da Square, incluindo pagamentos, reembolsos, pedidos, catálogo, estoque, faturas, repasses, mão de obra e fidelidade.
Como instalar Square MCP Server
https://mcp.squareup.com/mcpSquare MCP Server vale a pena?
A Square segue o mesmo caminho das ferramentas genéricas da Stripe: três ferramentas que permitem ao agente descobrir e chamar qualquer um de 38 serviços da Square. Isso mantém a lista de ferramentas pequena, o que ajuda quando vários servidores dividem uma janela de contexto, e significa que um lojista pode perguntar sobre catálogo, pedidos, clientes ou repasses sem esperar uma ferramenta feita sob medida.
O preço das ferramentas genéricas é que o modelo precisa encontrar o método certo e montar sozinho o corpo da requisição, e as issues abertas mostram onde isso dá errado. A issue #20 (abril de 2026) relata make_api_request enviando arrays vazios para campos como location_ids, o que quebra a busca de Orders, e falhando em resolver parâmetros de caminho. A issue #31 (setembro de 2026) argumenta que a descrição de CreatePayment manda o modelo gerar uma nova chave de idempotência a cada chamada, então uma requisição repetida poderia cobrar um cartão duas vezes. A issue #27 observa que os nomes genéricos colidem com ferramentas de outros servidores, então um modelo às vezes encaminha uma pergunta sobre pagamentos para a Stripe.
O servidor hospedado só alcança produção, o que combina mal com o próprio conselho da Square de testar prompts primeiro em sandbox: fazer isso significa rodar o pacote local com um token, e a opção somente leitura DISALLOW_WRITES só existe ali. A documentação não nomeia escopos OAuth para o servidor hospedado e não publica limites de taxa nem termos de retenção de dados para o endpoint MCP.
Para perguntas somente leitura sobre o negócio de um lojista, como os itens mais vendidos do mês passado ou quais faturas estão vencidas, o design funciona e não custa nada além das tarifas normais da Square. Escritas que tocam pagamentos, reembolsos ou estoque merecem aprovação humana a cada chamada até que as issues #20 e #31 sejam fechadas.
Onde ele se destaca
O dono de um café com duas unidades na Square
Descobrir quais itens do cardápio mais venderam no mês passado e quais quase não saíram
No Claude, o agente consulta pedidos e catálogo por make_api_request no servidor hospedado. Sem taxa extra; aprove cada chamada, já que a mesma ferramenta também pode escrever, e uma busca de Orders que falha em location_ids é o bug aberto #20, não o prompt.
Um desenvolvedor criando uma integração com a Square para um cliente de varejo
Explorar endpoints desconhecidos da Square com dados de teste
Rode npx square-mcp-server start com SANDBOX=true e DISALLOW_WRITES=true; get_service_info e get_type_info funcionam como uma referência interativa da API. Gratuito, e nada toca dinheiro real.
Antes de decidir
- Configuração
- Adicione https://mcp.squareup.com/mcp em um cliente aprovado (Claude.ai, Claude Desktop, Goose, Cursor ou Windsurf) e faça login com a Square; a configuração do Claude Desktop usa npx mcp-remote. Para sandbox, rode npx square-mcp-server start com ACCESS_TOKEN e SANDBOX=true.
- Integrações
- Três ferramentas: get_service_info e get_type_info para descoberta somente leitura, e make_api_request para leituras e escritas em 38 serviços, incluindo pagamentos, reembolsos, pedidos, catálogo, estoque, faturas e repasses.
- Dados e privacidade
- O servidor hospedado age sobre dados reais de produção via OAuth; a documentação não lista escopos nem termos de retenção. O servidor local guarda um access token na sua máquina e pode ser tornado somente leitura com DISALLOW_WRITES=true.
- Custo em escala
- O servidor é gratuito sob Apache-2.0; as tarifas padrão de processamento da Square se aplicam a qualquer pagamento que ele criar. Cada operação costuma levar duas ou três chamadas (descobrir, inspecionar o tipo, depois requisitar), então o uso de tokens por tarefa é maior do que com ferramentas feitas sob medida; os limites de taxa não são publicados na documentação do MCP.
- Limites
- Beta; o servidor hospedado é só de produção; issues abertas relatam parâmetros de array descartados (#20), risco de cobrança duplicada em pagamentos repetidos (#31) e colisões de nomes de ferramentas com outros servidores (#27).
O que é bom
- Alcança 38 serviços da Square com três ferramentas
- Servidor OAuth hospedado com lista de clientes aprovados
- Modo somente leitura e suporte a sandbox no servidor local
- A lista pequena de ferramentas deixa espaço para outros servidores no contexto
O que não é
- Beta, com um pacote npm inalterado desde abril de 2025
- O servidor hospedado é só de produção, sem opção somente leitura
- Bugs abertos: parâmetros de array descartados, texto sobre idempotência que arrisca cobranças duplicadas
- Os nomes genéricos das ferramentas colidem com outros servidores
Ideal para
Lojistas e desenvolvedores da Square que querem que um assistente consulte dados de vendas, pedidos e catálogo.
Alternativas ao Square MCP Server
Square MCP Server: perguntas frequentes
- Square MCP Server vale a pena?
- Toda a API da Square por trás de três ferramentas: engenhoso para ler dados de vendas, arriscado para qualquer coisa que movimente dinheiro enquanto seus bugs de beta seguem abertos. Damos nota 3.6 de 5.
- Quanto custa Square MCP Server?
- Gratuito e de código aberto (Apache-2.0); as tarifas normais da Square se aplicam.
- Quais são as desvantagens de Square MCP Server?
- Beta, com um pacote npm inalterado desde abril de 2025; o servidor hospedado é só de produção, sem opção somente leitura; bugs abertos: parâmetros de array descartados, texto sobre idempotência que arrisca cobranças duplicadas; os nomes genéricos das ferramentas colidem com outros servidores.
- Para quem Square MCP Server é indicado?
- Lojistas e desenvolvedores da Square que querem que um assistente consulte dados de vendas, pedidos e catálogo.
- Quanto custa Square MCP Server para uma equipe ou em produção?
- O servidor é gratuito sob Apache-2.0; as tarifas padrão de processamento da Square se aplicam a qualquer pagamento que ele criar. Cada operação costuma levar duas ou três chamadas (descobrir, inspecionar o tipo, depois requisitar), então o uso de tokens por tarefa é maior do que com ferramentas feitas sob medida; os limites de taxa não são publicados na documentação do MCP.
- Square MCP Server é seguro para dados da empresa?
- O servidor hospedado age sobre dados reais de produção via OAuth; a documentação não lista escopos nem termos de retenção. O servidor local guarda um access token na sua máquina e pode ser tornado somente leitura com DISALLOW_WRITES=true.
- Quais são as melhores alternativas ao Square MCP Server?
- As alternativas mais próximas que analisamos são Stripe MCP, PayPal MCP Server e Shopify Dev MCP.
Respostas verificadas em 23 de out. de 2026.