naftiko: 1.0.0-alpha2 info: label: Fake Store API description: Fake Store API exposes a sample REST API for e-commerce data including products, carts, users, and authentication. It is intended for prototyping, teaching, and integration testing — write operations return fabricated responses and do not persist data on the server. tags: - Fake - Store - Api - API created: '2026-05-06' modified: '2026-05-06' capability: consumes: - type: http namespace: fake-store-api baseUri: https://fakestoreapi.com description: Fake Store API HTTP API. resources: - name: products path: /products operations: - name: listproducts method: GET description: List products outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createproduct method: POST description: Create a product outputRawFormat: json outputParameters: - name: result type: object value: $. - name: products-id path: /products/{id} operations: - name: getproduct method: GET description: Get a product outputRawFormat: json outputParameters: - name: result type: object value: $. - name: replaceproduct method: PUT description: Replace a product outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateproduct method: PATCH description: Partially update a product outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deleteproduct method: DELETE description: Delete a product outputRawFormat: json outputParameters: - name: result type: object value: $. - name: products-categories path: /products/categories operations: - name: listcategories method: GET description: List product categories outputRawFormat: json outputParameters: - name: result type: object value: $. - name: products-category-category path: /products/category/{category} operations: - name: listproductsbycategory method: GET description: List products in a category outputRawFormat: json outputParameters: - name: result type: object value: $. - name: carts path: /carts operations: - name: listcarts method: GET description: List carts inputParameters: - name: startdate in: query type: string description: Start date for filtering carts - name: enddate in: query type: string description: End date for filtering carts outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createcart method: POST description: Create a cart outputRawFormat: json outputParameters: - name: result type: object value: $. - name: carts-id path: /carts/{id} operations: - name: getcart method: GET description: Get a cart outputRawFormat: json outputParameters: - name: result type: object value: $. - name: replacecart method: PUT description: Replace a cart outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updatecart method: PATCH description: Partially update a cart outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deletecart method: DELETE description: Delete a cart outputRawFormat: json outputParameters: - name: result type: object value: $. - name: carts-user-userid path: /carts/user/{userId} operations: - name: listcartsbyuser method: GET description: List carts for a user outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users path: /users operations: - name: listusers method: GET description: List users outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createuser method: POST description: Create a user outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-id path: /users/{id} operations: - name: getuser method: GET description: Get a user outputRawFormat: json outputParameters: - name: result type: object value: $. - name: replaceuser method: PUT description: Replace a user outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateuser method: PATCH description: Partially update a user outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deleteuser method: DELETE description: Delete a user outputRawFormat: json outputParameters: - name: result type: object value: $. - name: auth-login path: /auth/login operations: - name: login method: POST description: Login outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest port: 8080 namespace: fake-store-api-rest description: REST adapter for Fake Store API. resources: - path: /products name: listproducts operations: - method: GET name: listproducts description: List products call: fake-store-api.listproducts outputParameters: - type: object mapping: $. - path: /products name: createproduct operations: - method: POST name: createproduct description: Create a product call: fake-store-api.createproduct outputParameters: - type: object mapping: $. - path: /products/{id} name: getproduct operations: - method: GET name: getproduct description: Get a product call: fake-store-api.getproduct outputParameters: - type: object mapping: $. - path: /products/{id} name: replaceproduct operations: - method: PUT name: replaceproduct description: Replace a product call: fake-store-api.replaceproduct outputParameters: - type: object mapping: $. - path: /products/{id} name: updateproduct operations: - method: PATCH name: updateproduct description: Partially update a product call: fake-store-api.updateproduct outputParameters: - type: object mapping: $. - path: /products/{id} name: deleteproduct operations: - method: DELETE name: deleteproduct description: Delete a product call: fake-store-api.deleteproduct outputParameters: - type: object mapping: $. - path: /products/categories name: listcategories operations: - method: GET name: listcategories description: List product categories call: fake-store-api.listcategories outputParameters: - type: object mapping: $. - path: /products/category/{category} name: listproductsbycategory operations: - method: GET name: listproductsbycategory description: List products in a category call: fake-store-api.listproductsbycategory outputParameters: - type: object mapping: $. - path: /carts name: listcarts operations: - method: GET name: listcarts description: List carts call: fake-store-api.listcarts outputParameters: - type: object mapping: $. - path: /carts name: createcart operations: - method: POST name: createcart description: Create a cart call: fake-store-api.createcart outputParameters: - type: object mapping: $. - path: /carts/{id} name: getcart operations: - method: GET name: getcart description: Get a cart call: fake-store-api.getcart outputParameters: - type: object mapping: $. - path: /carts/{id} name: replacecart operations: - method: PUT name: replacecart description: Replace a cart call: fake-store-api.replacecart outputParameters: - type: object mapping: $. - path: /carts/{id} name: updatecart operations: - method: PATCH name: updatecart description: Partially update a cart call: fake-store-api.updatecart outputParameters: - type: object mapping: $. - path: /carts/{id} name: deletecart operations: - method: DELETE name: deletecart description: Delete a cart call: fake-store-api.deletecart outputParameters: - type: object mapping: $. - path: /carts/user/{userId} name: listcartsbyuser operations: - method: GET name: listcartsbyuser description: List carts for a user call: fake-store-api.listcartsbyuser outputParameters: - type: object mapping: $. - path: /users name: listusers operations: - method: GET name: listusers description: List users call: fake-store-api.listusers outputParameters: - type: object mapping: $. - path: /users name: createuser operations: - method: POST name: createuser description: Create a user call: fake-store-api.createuser outputParameters: - type: object mapping: $. - path: /users/{id} name: getuser operations: - method: GET name: getuser description: Get a user call: fake-store-api.getuser outputParameters: - type: object mapping: $. - path: /users/{id} name: replaceuser operations: - method: PUT name: replaceuser description: Replace a user call: fake-store-api.replaceuser outputParameters: - type: object mapping: $. - path: /users/{id} name: updateuser operations: - method: PATCH name: updateuser description: Partially update a user call: fake-store-api.updateuser outputParameters: - type: object mapping: $. - path: /users/{id} name: deleteuser operations: - method: DELETE name: deleteuser description: Delete a user call: fake-store-api.deleteuser outputParameters: - type: object mapping: $. - path: /auth/login name: login operations: - method: POST name: login description: Login call: fake-store-api.login outputParameters: - type: object mapping: $. - type: mcp port: 9090 namespace: fake-store-api-mcp transport: http description: MCP adapter for Fake Store API for AI agent use. tools: - name: listproducts description: List products hints: readOnly: true destructive: false idempotent: true call: fake-store-api.listproducts outputParameters: - type: object mapping: $. - name: createproduct description: Create a product hints: readOnly: false destructive: false idempotent: false call: fake-store-api.createproduct outputParameters: - type: object mapping: $. - name: getproduct description: Get a product hints: readOnly: true destructive: false idempotent: true call: fake-store-api.getproduct outputParameters: - type: object mapping: $. - name: replaceproduct description: Replace a product hints: readOnly: false destructive: false idempotent: true call: fake-store-api.replaceproduct outputParameters: - type: object mapping: $. - name: updateproduct description: Partially update a product hints: readOnly: false destructive: false idempotent: false call: fake-store-api.updateproduct outputParameters: - type: object mapping: $. - name: deleteproduct description: Delete a product hints: readOnly: false destructive: true idempotent: true call: fake-store-api.deleteproduct outputParameters: - type: object mapping: $. - name: listcategories description: List product categories hints: readOnly: true destructive: false idempotent: true call: fake-store-api.listcategories outputParameters: - type: object mapping: $. - name: listproductsbycategory description: List products in a category hints: readOnly: true destructive: false idempotent: true call: fake-store-api.listproductsbycategory outputParameters: - type: object mapping: $. - name: listcarts description: List carts hints: readOnly: true destructive: false idempotent: true call: fake-store-api.listcarts with: startdate: tools.startdate enddate: tools.enddate inputParameters: - name: startdate type: string description: Start date for filtering carts - name: enddate type: string description: End date for filtering carts outputParameters: - type: object mapping: $. - name: createcart description: Create a cart hints: readOnly: false destructive: false idempotent: false call: fake-store-api.createcart outputParameters: - type: object mapping: $. - name: getcart description: Get a cart hints: readOnly: true destructive: false idempotent: true call: fake-store-api.getcart outputParameters: - type: object mapping: $. - name: replacecart description: Replace a cart hints: readOnly: false destructive: false idempotent: true call: fake-store-api.replacecart outputParameters: - type: object mapping: $. - name: updatecart description: Partially update a cart hints: readOnly: false destructive: false idempotent: false call: fake-store-api.updatecart outputParameters: - type: object mapping: $. - name: deletecart description: Delete a cart hints: readOnly: false destructive: true idempotent: true call: fake-store-api.deletecart outputParameters: - type: object mapping: $. - name: listcartsbyuser description: List carts for a user hints: readOnly: true destructive: false idempotent: true call: fake-store-api.listcartsbyuser outputParameters: - type: object mapping: $. - name: listusers description: List users hints: readOnly: true destructive: false idempotent: true call: fake-store-api.listusers outputParameters: - type: object mapping: $. - name: createuser description: Create a user hints: readOnly: false destructive: false idempotent: false call: fake-store-api.createuser outputParameters: - type: object mapping: $. - name: getuser description: Get a user hints: readOnly: true destructive: false idempotent: true call: fake-store-api.getuser outputParameters: - type: object mapping: $. - name: replaceuser description: Replace a user hints: readOnly: false destructive: false idempotent: true call: fake-store-api.replaceuser outputParameters: - type: object mapping: $. - name: updateuser description: Partially update a user hints: readOnly: false destructive: false idempotent: false call: fake-store-api.updateuser outputParameters: - type: object mapping: $. - name: deleteuser description: Delete a user hints: readOnly: false destructive: true idempotent: true call: fake-store-api.deleteuser outputParameters: - type: object mapping: $. - name: login description: Login hints: readOnly: false destructive: false idempotent: false call: fake-store-api.login outputParameters: - type: object mapping: $.