{
 "categories": [
  "payments",
  "commerce",
  "point-of-sale"
 ],
 "deployment": "saas",
 "evidence": [
  {
   "date": "2026-09-03",
   "fact": "homepage",
   "note": "Square presents a seller platform for in-person and online payments, point of sale, team, marketing, loyalty, and cash-flow tools.",
   "source": "https://squareup.com/us/en",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "platforms",
   "note": "Square documents web checkout and invoicing plus iPhone and Android Tap to Pay and first-party POS hardware and apps.",
   "source": "https://squareup.com/us/en/payments/pricing",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "license",
   "note": "Square is a commercial payments and seller platform. The opened pricing page states that standard processing rates apply and vary by payment method.",
   "source": "https://squareup.com/us/en/payments/pricing",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.api.exists",
   "note": "Square Developer documents Payments, Commerce, Customers, and Staff API groups plus API Explorer, GraphQL Explorer, and official SDKs.",
   "source": "https://developer.squareup.com/docs",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.api.kinds[0]",
   "note": "The Square API follows REST patterns: HTTPS requests, JSON bodies, GET/POST/PUT/DELETE, Square-Version header, and connect.squareup.com/v2 or connect.squareupsandbox.com/v2.",
   "source": "https://developer.squareup.com/docs/build-basics/general-considerations/using-rest-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.api.kinds[1]",
   "note": "Square GraphQL is a standards-compliant query endpoint at connect.squareup.com/public/graphql and the Sandbox equivalent. Mutations and subscriptions are not supported.",
   "source": "https://developer.squareup.com/docs/devtools/graphql",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.api.auth[0]",
   "note": "The OAuth API uses OAuth 2 to exchange an authorization code for an access token and refresh token. Code flow and PKCE are documented. Access tokens expire after 30 days.",
   "source": "https://developer.squareup.com/docs/oauth-api/overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.api.auth[1]",
   "note": "A Developer Console personal access token grants unrestricted access to the application's own Square account and is sent as Authorization Bearer. Sandbox and production tokens are separate.",
   "source": "https://developer.squareup.com/docs/build-basics/access-tokens",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.api.coverage",
   "note": "The API reference dated 2026-08-19 lists Payments, Refunds, Checkout, Terminal, Disputes, Invoices, Cards, Subscriptions, Orders, Catalog, Inventory, Bookings, Customers, Loyalty, Gift Cards, Labor, Team, Merchants, Locations, OAuth, Webhook subscriptions, and Events.",
   "source": "https://developer.squareup.com/reference/square",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.sdk.exists",
   "note": "Square recommends official server-side SDKs over raw REST and lists Go, Java, .NET, Node.js, PHP, Python, and Ruby packages with GitHub and quickstarts.",
   "source": "https://developer.squareup.com/docs/sdks",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.sdk.languages",
   "note": "The opened SDK hub names Go, Java, .NET, Node.js, PHP, PyPI, and RubyGems. The Python SDK page confirms pip install squareup, latest 45.1.0.20260819.",
   "source": "https://developer.squareup.com/docs/sdks",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.mcp.first_party",
   "note": "Square documents a first-party MCP server in Beta that bridges AI assistants to the Square REST API. Current docs host remote MCP at https://mcp.squareup.com/mcp with OAuth. Local startup is npx square-mcp-server. Source is GitHub square/square-mcp-server. Remote instances access production; local can target Sandbox.",
   "source": "https://developer.squareup.com/docs/mcp",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.mcp.verdict",
   "note": "The vendor README titles Square Model Context Protocol Server (Beta), documents npx square-mcp-server, remote https://mcp.squareup.com/sse, and tools get_service_info, get_type_info, and make_api_request over Connect services including catalog, customers, orders, payments, invoices, and loyalty.",
   "source": "https://github.com/square/square-mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.extensibility.scripting",
   "note": "Square applications created in the Developer Console call Square APIs for payments, orders, inventory, and customers.",
   "source": "https://developer.squareup.com/docs/get-started",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.extensibility.webhooks",
   "note": "Square sends HTTPS JSON event notifications to a registered URL and retries unsuccessful deliveries for up to 24 hours. Several APIs do not support webhooks. The Events API can recover missed notifications.",
   "source": "https://developer.squareup.com/docs/webhooks/overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.data_access.export",
   "note": "Successful GET, list, and search calls return JSON resources, including cursor pagination for list operations.",
   "source": "https://developer.squareup.com/docs/build-basics/general-considerations/using-rest-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.data_access.import",
   "note": "POST and PUT operations accept JSON bodies to create and update seller resources such as customers, with idempotency keys on create.",
   "source": "https://developer.squareup.com/docs/build-basics/general-considerations/using-rest-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "modalities.agent_docs.llms_txt",
   "note": "Opened developer.squareup.com/llms.txt. It is a first-party Square Developer Platform index for humans and AI agents and links the MCP Server docs.",
   "source": "https://developer.squareup.com/llms.txt",
   "tier": "scraped"
  },
  {
   "date": "2026-09-03",
   "fact": "verdict.scores.api",
   "note": "Connect REST is broad, versioned (2026-08-19 on the opened reference), sandboxed, read/write, webhook-enabled, and paired with official SDKs. GraphQL is query-only and several APIs lack webhooks, so the path is 8 rather than 9.",
   "source": "https://developer.squareup.com/reference/square",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "verdict.scores.mcp",
   "note": "The official server is a documented Beta preview with OAuth remote access and a local token/Sandbox mode. Coverage is the Connect surface via three generic tools. Remote MCP is production-only. That is a limited vendor preview, score 6.",
   "source": "https://developer.squareup.com/docs/mcp",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "freshness.watch[0].url",
   "note": "Opened and verified as Square's current MCP page, including Beta status, https://mcp.squareup.com/mcp, OAuth remote setup, and npx square-mcp-server local quickstart.",
   "source": "https://developer.squareup.com/docs/mcp",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "freshness.watch[1].url",
   "note": "Opened the vendor repository. The raw README documents the SSE remote URL, local npx startup, environment flags, and the three Connect wrapper tools.",
   "source": "https://github.com/square/square-mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "freshness.watch[2].url",
   "note": "Opened and verified as the current Using the REST API guide for HTTPS methods, headers, JSON bodies, pagination, and access tokens.",
   "source": "https://developer.squareup.com/docs/build-basics/general-considerations/using-rest-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-03",
   "fact": "freshness.watch[3].url",
   "note": "Opened and verified as the current Square Webhooks overview, including retry schedule and APIs that do not support webhooks.",
   "source": "https://developer.squareup.com/docs/webhooks/overview",
   "tier": "declared"
  }
 ],
 "freshness": {
  "last_verified": "2026-09-03",
  "volatility": "high",
  "watch": [
   {
    "type": "mcp",
    "url": "https://developer.squareup.com/docs/mcp"
   },
   {
    "type": "mcp",
    "url": "https://github.com/square/square-mcp-server"
   },
   {
    "type": "docs",
    "url": "https://developer.squareup.com/docs/build-basics/general-considerations/using-rest-api"
   },
   {
    "type": "changelog",
    "url": "https://developer.squareup.com/docs/webhooks/overview"
   }
  ]
 },
 "homepage": "https://squareup.com/us/en",
 "id": "square",
 "license": "commercial",
 "modalities": {
  "agent_docs": {
   "llms_txt": true
  },
  "api": {
   "auth": [
    "oauth2",
    "access-token"
   ],
   "coverage": "full",
   "docs": "https://developer.squareup.com/docs/build-basics/general-considerations/using-rest-api",
   "exists": true,
   "kinds": [
    "rest",
    "graphql"
   ]
  },
  "cli": {
   "exists": "unknown"
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [
    "api-json"
   ],
   "import": [
    "api-json"
   ]
  },
  "extensibility": {
   "scripting": [
    "developer-apps",
    "oauth-apps"
   ],
   "webhooks": true
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": "unknown",
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": true,
   "third_party": [],
   "verdict": "official"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI or device probe was run. Square's Connect REST APIs, official server SDKs, signed webhooks, query-only GraphQL, and first-party MCP server cover seller payments, catalog, orders, and customers without driving Seller Dashboard or hardware UI.\n",
   "ui_stack": [
    "web-dom",
    "mobile-native",
    "payment-terminal"
   ],
   "vendor_support": []
  },
  "sdk": {
   "exists": true,
   "languages": [
    "go",
    "java",
    "csharp",
    "javascript",
    "php",
    "python",
    "ruby"
   ],
   "official": true
  }
 },
 "name": "Square",
 "platforms": [
  "web",
  "ios",
  "android"
 ],
 "related": {
  "alternatives": [
   "stripe",
   "paypal",
   "zettle-paypal",
   "shopify"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "Square",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 8,
   "cli": null,
   "computer_use": null,
   "integrations": null,
   "mcp": 6,
   "overall": 8,
   "rpa": null
  },
  "summary": "Square is automatable today through the Connect REST API. HTTPS JSON operations cover payments, refunds, checkout, Terminal, invoices, cards, subscriptions, orders, catalog, inventory, bookings, customers, loyalty, gift cards, labor, team, locations, and webhook subscriptions, with production at https://connect.squareup.com/v2 and Sandbox at https://connect.squareupsandbox.com/v2. Sellers use a personal access token for their own account or OAuth 2.0 (code or PKCE) for scoped access to other Square accounts; access tokens are sent as Bearer credentials and OAuth tokens expire after 30 days. Official server SDKs exist for Go, Java, .NET, Node.js, PHP, Python, and Ruby. Signed HTTPS webhooks retry for 24 hours; Snippets, Sites, Merchants, Cash Drawer Shifts, Mobile Authorization, Customer Groups, Customer Segments, and Apple Pay do not support webhooks. Square GraphQL at https://connect.squareup.com/public/graphql is query-only. Square documents a first-party MCP server in Beta: current developer docs host it at https://mcp.squareup.com/mcp with OAuth; the vendor GitHub README still documents https://mcp.squareup.com/sse. Local startup is npx square-mcp-server with ACCESS_TOKEN and optional SANDBOX. Tools get_service_info, get_type_info, and make_api_request wrap Connect services. Remote MCP reaches production only. Square publishes developer.squareup.com/llms.txt. This record is the Block seller platform, not Zettle, Stripe, PayPal, or Shopify. Connector catalogs and a general-purpose CLI were not established. Computer-use viability is unassessed. API scores 8 and is the best path because MCP remains Beta with three generic tools and production-only remote access.\n"
 }
}