MCP MeasureMCP Measure

인덱스 관측됨

swell

Manage your Swell headless-commerce store — products, orders, customers, and subscriptions.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
95%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~3,431토큰 (도구 정의)
~1.8 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.68%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "swell": {
      "url": "https://swell.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://swell.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (16)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢swell_list_products(limit, page, where, sort, expand, ...)

List products in the store, with MongoDB-style filtering, sorting, search, field selection, and expansion. Swell backend REST API: GET /products.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated fields to return, e.g. \"name,price,active\".",
      "type": "string"
    },
    "search": {
      "description": "Free-text search across the model's searchable fields.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_get_product(id, expand, fields)

Fetch a single product by its record id or its slug. Supports `expand` and `fields`. Swell backend REST API: GET /products/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Product id or slug."
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated fields to return, e.g. \"name,price\".",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_categories(limit, page, where, sort, expand, ...)

List product categories, with filtering, sorting, search, and expansion. Swell backend REST API: GET /categories.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    },
    "search": {
      "description": "Free-text search across the model's searchable fields.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_orders(limit, page, where, sort, expand, ...)

List orders, with MongoDB-style filtering, sorting, search, and expansion. Swell backend REST API: GET /orders.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    },
    "search": {
      "description": "Free-text search across the model's searchable fields.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_get_order(id, expand, fields)

Fetch a single order by its record id or its order number. Supports `expand` and `fields`. Swell backend REST API: GET /orders/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Order id or order number."
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"items,account\".",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated fields to return.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_customers(limit, page, where, sort, expand, ...)

List customers. In Swell, customers are the `accounts` model — this queries GET /accounts, with filtering, sorting, search, and expansion.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    },
    "search": {
      "description": "Free-text search across the model's searchable fields.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_get_customer(id, expand, fields)

Fetch a single customer (Swell `accounts` model) by id. Supports `expand` and `fields`. Swell backend REST API: GET /accounts/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Customer (account) id."
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"orders,subscriptions\".",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated fields to return.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_carts(limit, page, where, sort, expand)

List shopping carts (including abandoned carts), with filtering, sorting, and expansion. Swell backend REST API: GET /carts.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_subscriptions(limit, page, where, sort, expand)

List subscriptions, with filtering, sorting, and expansion. Swell backend REST API: GET /subscriptions.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_get_subscription(id, expand)

Fetch a single subscription by id. Supports `expand`. Swell backend REST API: GET /subscriptions/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Subscription id."
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"account,product\".",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_invoices(limit, page, where, sort, expand)

List invoices (typically subscription invoices), with filtering, sorting, and expansion. Swell backend REST API: GET /invoices.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_list_coupons(limit, page, where, sort)

List discount coupons, with filtering and sorting. Swell backend REST API: GET /coupons.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢swell_query(collection, limit, page, where, sort, ...)

Power tool: read-only (GET only) access to ANY Swell model not covered by a dedicated tool — e.g. stock, promotions, giftcards, payments, shipments, settings. Supply the collection name plus the usual list params (limit, page, where, sort, expand, fields, search). Swell backend REST API: GET /{collection}.

입력 스키마

{
  "type": "object",
  "properties": {
    "collection": {
      "type": "string",
      "description": "Swell model/collection name, e.g. \"products\", \"stock\", \"promotions\", \"giftcards\"."
    },
    "limit": {
      "description": "Max records to return (1–1000, Swell default 15).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "where": {
      "description": "MongoDB-style filter as a JSON object string, e.g. {\"active\":true,\"price\":{\"$gte\":10}}.",
      "type": "string"
    },
    "sort": {
      "description": "Sort expression, e.g. \"date_created desc\" or \"name asc\".",
      "type": "string"
    },
    "expand": {
      "description": "Comma-separated related fields to expand, e.g. \"variants,categories\".",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated fields to return, e.g. \"name,price,active\".",
      "type": "string"
    },
    "search": {
      "description": "Free-text search across the model's searchable fields.",
      "type": "string"
    }
  },
  "required": [
    "collection"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴swell_create_product(name, price, active, sku, stock_level, ...)

MUTATES LIVE STORE DATA. Create a new product in the store. Provide the common fields directly (name is required); anything else goes in `fields`, which is merged into the request body. Swell backend REST API: POST /products.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Product name (required)."
    },
    "price": {
      "description": "Product price.",
      "type": "number"
    },
    "active": {
      "description": "Whether the product is active/visible.",
      "type": "boolean"
    },
    "sku": {
      "description": "Stock-keeping unit.",
      "type": "string"
    },
    "stock_level": {
      "description": "Available stock quantity.",
      "type": "number"
    },
    "type": {
      "description": "Product type, e.g. \"standard\", \"subscription\", \"digital\".",
      "type": "string"
    },
    "description": {
      "description": "Product description.",
      "type": "string"
    },
    "fields": {
      "description": "Any additional product fields, merged into the request body (e.g. attributes, options, images).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴swell_update_product(id, fields)

MUTATES LIVE STORE DATA. Partially update an existing product by id. Provide the id plus a `fields` object of attributes to change. Swell backend REST API: PUT /products/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Product id to update (required)."
    },
    "fields": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Partial set of product attributes to update, e.g. {\"price\":19.99,\"active\":false}."
    }
  },
  "required": [
    "id",
    "fields"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴swell_update_order(id, fields)

MUTATES A LIVE ORDER. Partially update an existing order by id — e.g. change status, fulfillment, or notes. Provide the id plus a `fields` object of attributes to change, e.g. {"status":"complete"}. Swell backend REST API: PUT /orders/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Order id to update (required)."
    },
    "fields": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Partial set of order attributes to update, e.g. {\"status\":\"complete\"} or fulfillment fields."
    }
  },
  "required": [
    "id",
    "fields"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 16개