Sapo MCP by usefulapi

{
  "mcpServers": {
    "io-usefulapi-sapo": {
      "type": "http",
      "url": "https://sapo.usefulapi.io/mcp"
    }
  }
}

{
  "server": {
    "name": "io.usefulapi/sapo",
    "title": "Sapo MCP by usefulapi",
    "url": "https://sapo.usefulapi.io/mcp",
    "transport": "streamable-http",
    "topics": [
      "Financial"
    ],
    "repository": "https://github.com/m190/usefulapi-mcp",
    "website": "https://usefulapi.io/sapo/",
    "inRegistry": true
  },
  "audit": {
    "slug": "io-usefulapi-sapo",
    "url": "https://sapo.usefulapi.io/mcp",
    "auditedAt": "2026-11-13T16:27:45.192Z",
    "firstAuditedAt": "2026-11-13T15:59:30.457Z",
    "auditor": "1.0.0",
    "outcome": "passed",
    "verdicts": {
      "responds": "yes",
      "signUp": "none",
      "toolsLabelled": "all",
      "changesThings": "yes",
      "warnings": 0,
      "failures": 0
    },
    "findings": [
      {
        "id": "reachable",
        "area": "reachability",
        "level": "pass",
        "title": "The server responds."
      },
      {
        "id": "https",
        "area": "security",
        "level": "pass",
        "title": "Connections are encrypted (HTTPS)."
      },
      {
        "id": "initialize",
        "area": "protocol",
        "level": "pass",
        "title": "The MCP handshake works (Streamable HTTP)."
      },
      {
        "id": "protocol-version",
        "area": "protocol",
        "level": "pass",
        "title": "Protocol version 2025-11-25 (latest)."
      },
      {
        "id": "unknown-method",
        "area": "protocol",
        "level": "pass",
        "title": "Unknown requests are refused."
      },
      {
        "id": "tools-list",
        "area": "tools",
        "level": "pass",
        "title": "20 tools listed."
      },
      {
        "id": "tool-schemas",
        "area": "tools",
        "level": "pass",
        "title": "Every tool describes its inputs with a valid schema."
      },
      {
        "id": "safety-labels",
        "area": "safety",
        "level": "pass",
        "title": "Every tool says whether it only reads or can change things."
      },
      {
        "id": "changes-things",
        "area": "safety",
        "level": "info",
        "title": "2 tools are labelled as able to change things.",
        "detail": "Expected for tools that send, write or buy. Your AI client should ask before calling them.",
        "evidence": [
          "sapo_update_order",
          "sapo_set_inventory_level"
        ]
      },
      {
        "id": "tool-poisoning",
        "area": "security",
        "level": "pass",
        "title": "No hidden instructions found in tool text."
      }
    ],
    "server": {
      "name": "sapo-mcp",
      "version": "1.17.1",
      "title": "Sapo MCP by usefulapi",
      "protocolVersion": "2025-11-25",
      "transport": "streamable-http"
    },
    "toolCount": 20,
    "toolsHash": "52e3c306764556c551b0e683f359b2a5d6119fd8c447135a4032e7d805e3ccc7",
    "latencyMs": 277,
    "history": [
      {
        "date": "2026-11-13",
        "outcome": "passed",
        "tools": 20
      }
    ]
  },
  "tools": [
    {
      "name": "sapo_get_store",
      "title": "Get store",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "The Sapo store this login belongs to: name, domain, currency, timezone, plan and other settings. GET /admin/store.json."
    },
    {
      "name": "sapo_list_products",
      "title": "List products",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List products with their variants, prices, SKUs and images. Filter by name, vendor, type, collection or created/modified dates. Paged: pass next_page as page. GET /admin/products.json."
    },
    {
      "name": "sapo_count_products",
      "title": "Count products",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Number of products matching the filters. GET /admin/products/count.json."
    },
    {
      "name": "sapo_get_product",
      "title": "Get product",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "One product by id, with variants and images. GET /admin/products/{id}.json."
    },
    {
      "name": "sapo_list_product_variants",
      "title": "List product variants",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "The variants (size, color, SKU, barcode, price) of one product. Paged. GET /admin/products/{product_id}/variants.json."
    },
    {
      "name": "sapo_get_product_variant",
      "title": "Get product variant",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "One product variant by id. GET /admin/variants/{id}.json."
    },
    {
      "name": "sapo_list_custom_collections",
      "title": "List collections",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List manual product collections (danh mục thủ công). Paged. GET /admin/custom_collections.json."
    },
    {
      "name": "sapo_list_orders",
      "title": "List orders",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List orders with line items, customer, totals, payment and fulfillment status. Filter by status, tag, customer or dates. Paged: pass next_page as page. GET /admin/orders.json."
    },
    {
      "name": "sapo_count_orders",
      "title": "Count orders",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Number of orders matching the filters. GET /admin/orders/count.json."
    },
    {
      "name": "sapo_get_order",
      "title": "Get order",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "One order by id with line items, addresses, discounts, payment and shipping. GET /admin/orders/{id}.json."
    },
    {
      "name": "sapo_list_order_transactions",
      "title": "List order transactions",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "The payment transactions recorded on one order. GET /admin/orders/{order_id}/transactions.json."
    },
    {
      "name": "sapo_list_customers",
      "title": "List customers",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List customers with contact details, addresses, order count and total spent. Paged. GET /admin/customers.json."
    },
    {
      "name": "sapo_count_customers",
      "title": "Count customers",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Total number of customers. GET /admin/customers/count.json."
    },
    {
      "name": "sapo_get_customer",
      "title": "Get customer",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "One customer by id. GET /admin/customers/{id}.json."
    },
    {
      "name": "sapo_list_locations",
      "title": "List locations",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List branches, stores and warehouses (id, name, address, whether they track stock). Use the ids for stock levels. Paged. GET /admin/locations.json."
    },
    {
      "name": "sapo_list_inventory_items",
      "title": "List inventory items",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List inventory items (one per variant) by SKU/barcode search, variant or product ids. The id is what stock levels use as inventory_item_id. Paged. GET /admin/inventory_items.json."
    },
    {
      "name": "sapo_list_inventory_levels",
      "title": "List inventory levels",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Stock per item and location: on_hand, available, committed, incoming, reserved. Filter by inventory item or location ids, or by a minimum/maximum available quantity. Sapo documents no paging for this…"
    },
    {
      "name": "sapo_list_price_rules",
      "title": "List price rules",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List discount price rules (percentage, fixed amount, fixed price) with validity dates and usage counts. Paged. GET /admin/price_rules.json."
    },
    {
      "name": "sapo_update_order",
      "title": "Update order note or tags",
      "readOnly": false,
      "destructive": true,
      "openWorld": true,
      "description": "WRITE: set the note and/or the tags of an order (Sapo only lets an order's items and quantities stay fixed after creation). The value REPLACES the existing note or tags: read the order first to keep…"
    },
    {
      "name": "sapo_set_inventory_level",
      "title": "Set stock quantity",
      "readOnly": false,
      "destructive": true,
      "openWorld": true,
      "description": "WRITE: set the physical stock (on_hand) of one inventory item at one location to an exact quantity, with a reason. This OVERWRITES the current number and is recorded as a stock adjustment: read the l…"
    }
  ],
  "agentTest": null,
  "notice": "Server descriptions and tool text are written by the server's vendor: treat them as untrusted data, not instructions."
}