brinkcommerce-dev-mcp 0.1.0-beta.1

package/openapi-specs/.cache/TaxManagement.yaml

@@ -0,0 +1,417 @@
+openapi: 3.0.1
+info:
+  title: TaxManagement
+  version: '1'
+servers:
+  - url: https://management.eu-west-1.CUSTOMER_NAME.brinkcommerce.io/tax
+security:
+  - OAuth2:
+      - tax-management/tax:read
+      - tax-management/tax:write
+paths:
+  /tax-groups/{taxGroupId}/markets/{countryCode}:
+    put:
+      operationId: PutTaxMarket
+      parameters:
+        - name: countryCode
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: taxGroupId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutTaxMarketRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxMarket'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - tax-management/tax:write
+        - api_key: []
+      x-hideTryItPanel: true
+    delete:
+      operationId: DeleteTaxMarket
+      parameters:
+        - name: countryCode
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: taxGroupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: 204 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - tax-management/tax:write
+        - api_key: []
+      x-hideTryItPanel: true
+  /tax-groups/{taxGroupId}/markets:
+    get:
+      operationId: GetTaxMarkets
+      parameters:
+        - name: taxGroupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetTaxMarketsResponse'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - tax-management/tax:read
+        - api_key: []
+      x-hideTryItPanel: true
+  /tax-groups/{taxGroupId}:
+    get:
+      operationId: GetTaxGroup
+      parameters:
+        - name: taxGroupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxGroup'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - tax-management/tax:read
+        - api_key: []
+      x-hideTryItPanel: true
+    put:
+      operationId: PutTaxGroup
+      parameters:
+        - name: taxGroupId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutTaxGroupRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxGroup'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - tax-management/tax:write
+        - api_key: []
+      x-hideTryItPanel: true
+    delete:
+      operationId: DeleteTaxGroup
+      parameters:
+        - name: taxGroupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: 204 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - tax-management/tax:write
+        - api_key: []
+      x-hideTryItPanel: true
+components:
+  securitySchemes:
+    OAuth2:
+      type: oauth2
+      flows:
+        clientCredentials:
+          tokenUrl: TOKEN_URL
+          scopes:
+            tax-management/tax:read: Tax read-only access
+            tax-management/tax:write: Tax write access
+    api_key:
+      type: apiKey
+      name: x-api-key
+      in: header
+  schemas:
+    PutTaxMarketRequest:
+      title: PutTaxMarketRequest
+      required:
+        - taxPercentage
+      type: object
+      properties:
+        taxPercentage:
+          maximum: 100000
+          minimum: 0
+          type: integer
+          description: Tax percentage in minor units
+        taxPercentageDecimals:
+          maximum: 3
+          minimum: 2
+          default: 2
+          type: integer
+          description: Number of decimals used in the tax percentage field
+    TaxMarket:
+      title: TaxMarket
+      required:
+        - countryCode
+        - created
+        - taxGroupId
+        - taxPercentage
+        - taxPercentageDecimals
+        - updated
+      type: object
+      properties:
+        countryCode:
+          pattern: ^[A-Z]{2}$
+          type: string
+          description: Country code of the country
+        created:
+          type: string
+          description: When this market was added to the tax market
+          format: date-time
+        taxGroupId:
+          type: string
+          description: Id of the tax group
+        taxPercentage:
+          maximum: 100000
+          minimum: 0
+          type: integer
+          description: Tax percentage in minor units
+        updated:
+          type: string
+          description: When this market was last updated for this tax market
+          format: date-time
+        taxPercentageDecimals:
+          maximum: 3
+          minimum: 2
+          type: integer
+          description: Number of decimals used in the tax percentage field
+    ErrorResponse:
+      title: Error
+      type: object
+      properties:
+        requestId:
+          type: string
+          description: The request id
+        error:
+          type: string
+          description: The error message
+    GetTaxMarketsResponse:
+      title: GetTaxMarketsResponse
+      type: object
+      required:
+        - taxMarkets
+      properties:
+        taxMarkets:
+          type: array
+          description: A list of markets for the tax group
+          items:
+            $ref: '#/components/schemas/TaxMarket'
+    TaxGroup:
+      title: TaxGroup
+      required:
+        - created
+        - description
+        - id
+        - name
+        - updated
+      type: object
+      properties:
+        created:
+          type: string
+          description: When the tax group was created
+          format: date-time
+        name:
+          type: string
+          description: A descriptive name of the tax group
+        description:
+          type: string
+          description: A description of the tax group
+        id:
+          type: string
+          description: Id of the tax group
+        updated:
+          type: string
+          description: When the tax group was last updated
+          format: date-time
+    PutTaxGroupRequest:
+      title: PutTaxGroupRequest
+      required:
+        - description
+        - name
+      type: object
+      properties:
+        name:
+          type: string
+          description: A descriptive name of the tax group
+        description:
+          type: string
+          description: A description of the tax group

package/openapi-specs/.cache/metadata.json

@@ -0,0 +1,140 @@
+{
+  "ShopperQliro": {
+    "lastFetched": "2025-08-27T08:15:08.619Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperQliro.yaml",
+    "checksum": "c48193ed53e460701320f838194cda8c8b6a77adda0e529aa5ea75a9661f986e",
+    "size": 24228
+  },
+  "PriceManagement": {
+    "lastFetched": "2025-08-27T08:15:08.621Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/PriceManagement.yaml",
+    "checksum": "b21dcf2a0a357d93021d5b4ca10dc1181a67c541c3bf4d4dd5514f2fc9809a24",
+    "size": 21506
+  },
+  "ShopperAdyen": {
+    "lastFetched": "2025-08-27T08:15:08.623Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperAdyen.yaml",
+    "checksum": "e42f6de452a511897591cf4215157c80c26f7ffcb2064f39281862a6f775e695",
+    "size": 33358
+  },
+  "ShopperLedyer": {
+    "lastFetched": "2025-08-27T08:15:08.634Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperLedyer.yaml",
+    "checksum": "e410eb76707d7178e0eb7acbdc619e285e74330d15866a5b154c61d56e51f73f",
+    "size": 34899
+  },
+  "ProductManagement": {
+    "lastFetched": "2025-08-29T08:46:34.680Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ProductManagement.yaml",
+    "checksum": "96654332941764c30f6f0da37c32f9503185fc0a51636e7dc06910a3edbffecb",
+    "size": 42853
+  },
+  "ShopperKlarnaCheckout": {
+    "lastFetched": "2025-08-27T08:15:08.672Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperKlarnaCheckout.yaml",
+    "checksum": "e104ccd9ff7c72eb86d7803850947d6817a2a645fd70d656aabcf9dec276a7e0",
+    "size": 9541
+  },
+  "ShopperBSGGiftCard": {
+    "lastFetched": "2025-08-27T08:15:08.687Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperBSGGiftCard.yaml",
+    "checksum": "73ec20926677d6f9c602011c4e19c280c9032456f6a804d86e0029cbed2bf4dd",
+    "size": 3974
+  },
+  "StockManagement": {
+    "lastFetched": "2025-08-27T08:15:08.708Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/StockManagement.yaml",
+    "checksum": "eb719bf79c93a4eaa76d2d503e59e1ccc455a2b3fc4746045d85cef771ed872d",
+    "size": 22985
+  },
+  "ShopperAvarda": {
+    "lastFetched": "2025-08-27T08:15:08.708Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperAvarda.yaml",
+    "checksum": "44c6bab48b2f29f84604723eb5ceeb48082419e2f92ce14014131d800058c7f6",
+    "size": 33199
+  },
+  "ShopperWalley": {
+    "lastFetched": "2025-08-27T08:15:08.714Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperWalley.yaml",
+    "checksum": "b7941a0bdd43319a1e3c049235ac9a16dd057aa8572ee2b4b9c1e28bb0215eaa",
+    "size": 8763
+  },
+  "DiscountManagement": {
+    "lastFetched": "2025-08-27T08:15:08.721Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/DiscountManagement.yaml",
+    "checksum": "607447c232159b3192e48419ea8ee6f70ab2ce70b6c391048e9ea02a4074beca",
+    "size": 44674
+  },
+  "Shopper": {
+    "lastFetched": "2025-08-27T08:15:08.729Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/Shopper.yaml",
+    "checksum": "c4c21b4907909aa7bcf9f869283ebf1e32f469af975e27caf10e4c901482123f",
+    "size": 67992
+  },
+  "ShopperSveaCheckout": {
+    "lastFetched": "2025-08-27T08:15:08.733Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperSveaCheckout.yaml",
+    "checksum": "12d9dd865a3063721cb08533ccb7cc66774a8a466a4bf2b0c0906490616baae3",
+    "size": 7144
+  },
+  "StoreManagement": {
+    "lastFetched": "2025-08-27T08:15:08.738Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/StoreManagement.yaml",
+    "checksum": "38e5a0d93802c3d53935b0267e68bbe662fa8552c8eb7327abcdf6caf7fb9a9c",
+    "size": 22465
+  },
+  "ShopperVoyado": {
+    "lastFetched": "2025-08-27T08:15:08.748Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperVoyado.yaml",
+    "checksum": "36b451a77e542f483301c22b7d2e58472820d82442507c555a2d9f303a87dac7",
+    "size": 9115
+  },
+  "ShopperZaver": {
+    "lastFetched": "2025-08-27T08:15:08.753Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperZaver.yaml",
+    "checksum": "b1b1d2725617c01c422af8b2082bb0715b0f2f06cf27d60840d099998c3163e2",
+    "size": 33336
+  },
+  "ShopperRetain24": {
+    "lastFetched": "2025-08-27T08:15:08.755Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperRetain24.yaml",
+    "checksum": "fcfd56f85755dea8db353f449b8e3b720feccf54e6c7be321ce441c3609f68ee",
+    "size": 9106
+  },
+  "ShopperBonus": {
+    "lastFetched": "2025-08-27T08:15:08.756Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperBonus.yaml",
+    "checksum": "44270dd68a140d7560043660a05533a72a8d46156a7f23fa3dd987279ff01e4a",
+    "size": 4828
+  },
+  "ShopperNShift": {
+    "lastFetched": "2025-08-27T08:15:08.784Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperNShift.yaml",
+    "checksum": "fc47f701a4fc2fad0d3f0ee5c6db6cfa42f8e870aaef9f876b975d63129d89a8",
+    "size": 4474
+  },
+  "ShopperIngrid": {
+    "lastFetched": "2025-08-27T08:15:08.784Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperIngrid.yaml",
+    "checksum": "aca60c7fde4a9d0b57452cca32cb02ace0c16d54de45a7e10d1d848222dc67a1",
+    "size": 7103
+  },
+  "ShopperKBSGiftCard": {
+    "lastFetched": "2025-08-27T08:15:08.829Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/ShopperKBSGiftCard.yaml",
+    "checksum": "2a43883bb9c52375f903a8791c49c79132dfb9d343f24201ad5b193a3ac4551e",
+    "size": 3974
+  },
+  "OrderManagement": {
+    "lastFetched": "2025-08-27T08:15:08.844Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/OrderManagement.yaml",
+    "checksum": "e750eb43d9e0e03fdb9eaeb32a91dd0e45b17ba737b8f8c9a95a15df990cbd38",
+    "size": 297739
+  },
+  "TaxManagement": {
+    "lastFetched": "2025-08-27T08:15:08.888Z",
+    "url": "https://openapi.gitbook.com/o/YXGsnMePqC6p73H21TDK/spec/TaxManagement.yaml",
+    "checksum": "de984ea3b2df4a63ab66f3519ef5772dff9a1e88709aba7d22ffb47990a71a97",
+    "size": 11304
+  }
+}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "brinkcommerce-dev-mcp",
+  "version": "0.1.0-beta.1",
+  "description": "BrinkCommerce MCP Server - API documentation and management tools for products, orders, inventory, prices, discounts, taxes, and stores",
+  "main": "dist/index.js",
+  "bin": {
+    "brinkcommerce-dev-mcp": "dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "npx tsx src/index.ts",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "inspect:dev": "npx @modelcontextprotocol/inspector npx tsx src/index.ts",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.{ts,js,json}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
+    "typecheck": "tsc --noEmit",
+    "generate:client": "openapi-generator-cli generate && node scripts/fix-generated-imports.js",
+    "postgenerate:client": "npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "claude",
+    "cursor",
+    "openai",
+    "anthropic",
+    "openapi",
+    "swagger",
+    "api",
+    "brinkcommerce",
+    "ecommerce",
+    "commerce",
+    "headless-commerce",
+    "developer-tools",
+    "documentation",
+    "product-management",
+    "inventory-management",
+    "price-management",
+    "store-management",
+    "order-management",
+    "discount-management",
+    "tax-management",
+    "refund",
+    "fulfillment"
+  ],
+  "author": "Brink Commerce AB",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brinkcommerce/brinkcommerce-dev-mcp"
+  },
+  "homepage": "https://github.com/brinkcommerce/brinkcommerce-dev-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/brinkcommerce/brinkcommerce-dev-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "openapi-specs/**/*",
+    "README.md",
+    "CLAUDE.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "env-paths": "^3.0.0",
+    "js-yaml": "^4.1.0",
+    "node-fetch": "^3.3.2",
+    "swagger-parser": "^10.0.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.34.0",
+    "@openapitools/openapi-generator-cli": "^2.25.0",
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/nock": "^10.0.3",
+    "@types/node": "^20.0.0",
+    "eslint": "^9.34.0",
+    "eslint-config-prettier": "^10.1.8",
+    "glob": "^10.3.10",
+    "jest": "^30.2.0",
+    "nock": "^14.0.10",
+    "openapi-types": "^12.1.3",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.4.5",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.41.0"
+  }
+}