From 97031b899e165cf8f50919c4a7d052f2305cfe96 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Wed, 11 Feb 2026 12:59:05 +0000 Subject: [PATCH 1/5] Add Square MCP server definitions (local + remote) Official Square MCP server for payments, orders, catalog, and more. Local stdio version uses square-mcp-server npm package with access token. Remote HTTP version at mcp.squareup.com/sse uses OAuth. https://claude.ai/code/session_013AxurW8hPAfnUNvik354Xx --- servers/com.square-mcp-http.json | 45 ++++++++++++++++++++++ servers/com.square-mcp.json | 64 ++++++++++++++++++++++++++++++++ 2 files changed, 109 insertions(+) create mode 100644 servers/com.square-mcp-http.json create mode 100644 servers/com.square-mcp.json diff --git a/servers/com.square-mcp-http.json b/servers/com.square-mcp-http.json new file mode 100644 index 0000000..c0acade --- /dev/null +++ b/servers/com.square-mcp-http.json @@ -0,0 +1,45 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.square-mcp-http", + "name": "Square (Remote)", + "alias": "square-remote", + "description": "Interact with Square APIs via the hosted remote MCP server. Connects with OAuth for secure access to payments, orders, and more.", + "icon": "https://avatars.githubusercontent.com/u/82592?v=4", + "schema_version": "2.1", + "categories": ["developer-tools", "cloud"], + "tags": ["square", "payments", "commerce", "orders", "catalog", "pos", "remote"], + + "transport": { + "type": "http", + "url": "https://mcp.squareup.com/sse", + "metadata": { + "inputs": [] + } + }, + + "auth": { + "type": "oauth", + "instructions": "Connects via OAuth. Your MCP host will initiate the Square OAuth flow to authorize access to your seller account." + }, + + "contributor": { + "name": "Square", + "github": "square", + "url": "https://squareup.com" + }, + + "links": { + "repository": "https://github.com/square/square-mcp-server", + "homepage": "https://squareup.com", + "documentation": "https://developer.squareup.com/docs/mcp" + }, + + "platforms": ["all"], + + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + } +} diff --git a/servers/com.square-mcp.json b/servers/com.square-mcp.json new file mode 100644 index 0000000..2454f65 --- /dev/null +++ b/servers/com.square-mcp.json @@ -0,0 +1,64 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.square-mcp", + "name": "Square", + "alias": "square", + "description": "Interact with Square APIs for payments, orders, catalog, inventory, customers, and bookings. Supports all Square API services.", + "icon": "https://avatars.githubusercontent.com/u/82592?v=4", + "schema_version": "2.1", + "categories": ["developer-tools", "cloud"], + "tags": ["square", "payments", "commerce", "orders", "catalog", "pos"], + + "transport": { + "type": "stdio", + "command": "npx", + "args": ["-y", "square-mcp-server", "start"], + "env": { + "ACCESS_TOKEN": "${input:ACCESS_TOKEN}" + }, + "metadata": { + "inputs": [ + { + "id": "ACCESS_TOKEN", + "label": "Square Access Token", + "description": "Square API personal access token or sandbox access token.", + "type": "password", + "required": true, + "secret": true, + "placeholder": "EAAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", + "obtain": { + "url": "https://developer.squareup.com/apps", + "instructions": "1. Go to developer.squareup.com/apps\n2. Select or create an application\n3. Go to the Credentials section\n4. Copy your Access Token (sandbox or production)", + "button_label": "Get Access Token" + } + } + ] + } + }, + + "auth": { + "type": "api_key", + "instructions": "Get a Square access token at https://developer.squareup.com/apps" + }, + + "contributor": { + "name": "Square", + "github": "square", + "url": "https://squareup.com" + }, + + "links": { + "repository": "https://github.com/square/square-mcp-server", + "homepage": "https://squareup.com", + "documentation": "https://developer.squareup.com/docs/mcp" + }, + + "platforms": ["all"], + + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + } +} From ca5b682b6be3833527674e2001b54f1dea58bd32 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 19:11:02 +0800 Subject: [PATCH 2/5] fix: update server definition (input type 'password' -> 'text' for ACCESS_TOKEN) --- servers/com.square-mcp.json | 32 +++++++++++++++++++++----------- 1 file changed, 21 insertions(+), 11 deletions(-) diff --git a/servers/com.square-mcp.json b/servers/com.square-mcp.json index 2454f65..d550f80 100644 --- a/servers/com.square-mcp.json +++ b/servers/com.square-mcp.json @@ -6,13 +6,26 @@ "description": "Interact with Square APIs for payments, orders, catalog, inventory, customers, and bookings. Supports all Square API services.", "icon": "https://avatars.githubusercontent.com/u/82592?v=4", "schema_version": "2.1", - "categories": ["developer-tools", "cloud"], - "tags": ["square", "payments", "commerce", "orders", "catalog", "pos"], - + "categories": [ + "developer-tools", + "cloud" + ], + "tags": [ + "square", + "payments", + "commerce", + "orders", + "catalog", + "pos" + ], "transport": { "type": "stdio", "command": "npx", - "args": ["-y", "square-mcp-server", "start"], + "args": [ + "-y", + "square-mcp-server", + "start" + ], "env": { "ACCESS_TOKEN": "${input:ACCESS_TOKEN}" }, @@ -22,7 +35,7 @@ "id": "ACCESS_TOKEN", "label": "Square Access Token", "description": "Square API personal access token or sandbox access token.", - "type": "password", + "type": "text", "required": true, "secret": true, "placeholder": "EAAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", @@ -35,26 +48,23 @@ ] } }, - "auth": { "type": "api_key", "instructions": "Get a Square access token at https://developer.squareup.com/apps" }, - "contributor": { "name": "Square", "github": "square", "url": "https://squareup.com" }, - "links": { "repository": "https://github.com/square/square-mcp-server", "homepage": "https://squareup.com", "documentation": "https://developer.squareup.com/docs/mcp" }, - - "platforms": ["all"], - + "platforms": [ + "all" + ], "capabilities": { "tools": true, "resources": false, From 9014640fc0096ba166390c1eef7f259ec7c29181 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 19:20:47 +0800 Subject: [PATCH 3/5] fix: update Square documentation and obtain URLs --- servers/com.square-mcp-http.json | 27 +++++++++++++++++---------- servers/com.square-mcp.json | 6 +++--- 2 files changed, 20 insertions(+), 13 deletions(-) diff --git a/servers/com.square-mcp-http.json b/servers/com.square-mcp-http.json index c0acade..b623569 100644 --- a/servers/com.square-mcp-http.json +++ b/servers/com.square-mcp-http.json @@ -6,9 +6,19 @@ "description": "Interact with Square APIs via the hosted remote MCP server. Connects with OAuth for secure access to payments, orders, and more.", "icon": "https://avatars.githubusercontent.com/u/82592?v=4", "schema_version": "2.1", - "categories": ["developer-tools", "cloud"], - "tags": ["square", "payments", "commerce", "orders", "catalog", "pos", "remote"], - + "categories": [ + "developer-tools", + "cloud" + ], + "tags": [ + "square", + "payments", + "commerce", + "orders", + "catalog", + "pos", + "remote" + ], "transport": { "type": "http", "url": "https://mcp.squareup.com/sse", @@ -16,26 +26,23 @@ "inputs": [] } }, - "auth": { "type": "oauth", "instructions": "Connects via OAuth. Your MCP host will initiate the Square OAuth flow to authorize access to your seller account." }, - "contributor": { "name": "Square", "github": "square", "url": "https://squareup.com" }, - "links": { "repository": "https://github.com/square/square-mcp-server", "homepage": "https://squareup.com", - "documentation": "https://developer.squareup.com/docs/mcp" + "documentation": "https://developer.squareup.com/docs/devtools/mcp" }, - - "platforms": ["all"], - + "platforms": [ + "all" + ], "capabilities": { "tools": true, "resources": false, diff --git a/servers/com.square-mcp.json b/servers/com.square-mcp.json index d550f80..3cd91a5 100644 --- a/servers/com.square-mcp.json +++ b/servers/com.square-mcp.json @@ -40,8 +40,8 @@ "secret": true, "placeholder": "EAAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "obtain": { - "url": "https://developer.squareup.com/apps", - "instructions": "1. Go to developer.squareup.com/apps\n2. Select or create an application\n3. Go to the Credentials section\n4. Copy your Access Token (sandbox or production)", + "url": "https://developer.squareup.com/console/en/apps", + "instructions": "1. Go to developer.squareup.com and log in\n2. Navigate to Apps in the developer console\n3. Select or create an application\n4. Go to Credentials\n5. Copy your access token", "button_label": "Get Access Token" } } @@ -60,7 +60,7 @@ "links": { "repository": "https://github.com/square/square-mcp-server", "homepage": "https://squareup.com", - "documentation": "https://developer.squareup.com/docs/mcp" + "documentation": "https://developer.squareup.com/docs/devtools/mcp" }, "platforms": [ "all" From 485a9788c128386d76f07e839d73c53545f6f586 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 22:46:03 +0800 Subject: [PATCH 4/5] fix: rename server files with transport suffix - com.square-mcp.json -> com.square-mcp-npx.json (id: com.square-mcp-npx) Signed-off-by: Mohammod Al Amin Ashik --- servers/{com.square-mcp.json => com.square-mcp-npx.json} | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename servers/{com.square-mcp.json => com.square-mcp-npx.json} (97%) diff --git a/servers/com.square-mcp.json b/servers/com.square-mcp-npx.json similarity index 97% rename from servers/com.square-mcp.json rename to servers/com.square-mcp-npx.json index 3cd91a5..40d26d9 100644 --- a/servers/com.square-mcp.json +++ b/servers/com.square-mcp-npx.json @@ -1,7 +1,7 @@ { "$schema": "../schemas/server-definition.schema.json", - "id": "com.square-mcp", - "name": "Square", + "id": "com.square-mcp-npx", + "name": "Square (npx)", "alias": "square", "description": "Interact with Square APIs for payments, orders, catalog, inventory, customers, and bookings. Supports all Square API services.", "icon": "https://avatars.githubusercontent.com/u/82592?v=4", From 7edb9eb379d606c002791d4a95b278606e3dd4a3 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Fri, 20 Feb 2026 09:10:41 +0800 Subject: [PATCH 5/5] Rename Square (Remote) to Square (HTTP) Align naming convention: use transport type (HTTP) instead of "Remote" in display name and alias. Signed-off-by: Mohammod Al Amin Ashik --- servers/com.square-mcp-http.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/servers/com.square-mcp-http.json b/servers/com.square-mcp-http.json index b623569..a8fdefd 100644 --- a/servers/com.square-mcp-http.json +++ b/servers/com.square-mcp-http.json @@ -1,8 +1,8 @@ { "$schema": "../schemas/server-definition.schema.json", "id": "com.square-mcp-http", - "name": "Square (Remote)", - "alias": "square-remote", + "name": "Square (HTTP)", + "alias": "square-http", "description": "Interact with Square APIs via the hosted remote MCP server. Connects with OAuth for secure access to payments, orders, and more.", "icon": "https://avatars.githubusercontent.com/u/82592?v=4", "schema_version": "2.1",