naftiko: 1.0.0-alpha2 info: label: FatSecret Platform API description: The FatSecret Platform API provides programmatic access to a global food nutrition database covering more than 1.9 million verified food items across 56 countries. It supports food and recipe search, barcode scanning, image recognition, natural language processing, and full profile-based food diary, exercise diary, and weight tracking management. tags: - Fatsecret - API created: '2026-05-06' modified: '2026-05-06' capability: consumes: - type: http namespace: fatsecret baseUri: https://platform.fatsecret.com/rest description: FatSecret Platform API HTTP API. authentication: type: bearer token: '{{FATSECRET_TOKEN}}' resources: - name: foods-search-v5 path: /foods/search/v5 operations: - name: searchfoods method: GET description: Search foods inputParameters: - name: search_expression in: query type: string required: true - name: page_number in: query type: integer - name: max_results in: query type: integer outputRawFormat: json outputParameters: - name: result type: object value: $. - name: foods-autocomplete-v2 path: /foods/autocomplete/v2 operations: - name: autocompletefoods method: GET description: Autocomplete food search inputParameters: - name: expression in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-barcode-find-by-id-v1 path: /food/barcode/find-by-id/v1 operations: - name: findfoodbybarcode method: GET description: Find food by barcode inputParameters: - name: barcode in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-v4 path: /food/v4 operations: - name: getfood method: GET description: Get food by id inputParameters: - name: food_id in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-brands-v2 path: /food-brands/v2 operations: - name: listfoodbrands method: GET description: List food brands outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-categories-v2 path: /food-categories/v2 operations: - name: listfoodcategories method: GET description: List food categories outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-sub-categories-v2 path: /food-sub-categories/v2 operations: - name: listfoodsubcategories method: GET description: List food sub-categories outputRawFormat: json outputParameters: - name: result type: object value: $. - name: recipes-search-v3 path: /recipes/search/v3 operations: - name: searchrecipes method: GET description: Search recipes inputParameters: - name: search_expression in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: recipe-v2 path: /recipe/v2 operations: - name: getrecipe method: GET description: Get recipe by id inputParameters: - name: recipe_id in: query type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: recipe-types-v2 path: /recipe-types/v2 operations: - name: listrecipetypes method: GET description: List recipe types outputRawFormat: json outputParameters: - name: result type: object value: $. - name: exercises-v2 path: /exercises/v2 operations: - name: listexercises method: GET description: List exercises outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-favorites-v2 path: /food/favorites/v2 operations: - name: getfavoritefoods method: GET description: Get favorite foods outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-favorite-add-v2 path: /food/favorite/add/v2 operations: - name: addfavoritefood method: POST description: Add favorite food outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-favorite-delete-v2 path: /food/favorite/delete/v2 operations: - name: deletefavoritefood method: POST description: Delete favorite food outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-entries-v2 path: /food-entries/v2 operations: - name: getfoodentries method: GET description: Get food diary entries inputParameters: - name: date in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createfoodentry method: POST description: Create food diary entry outputRawFormat: json outputParameters: - name: result type: object value: $. - name: food-entries-month-v2 path: /food-entries/month/v2 operations: - name: getfoodentriesmonth method: GET description: Monthly food diary summary inputParameters: - name: month in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: exercise-entries-v2 path: /exercise-entries/v2 operations: - name: getexerciseentries method: GET description: Get exercise diary entries outputRawFormat: json outputParameters: - name: result type: object value: $. - name: commitexerciseentries method: POST description: Commit exercise diary entries outputRawFormat: json outputParameters: - name: result type: object value: $. - name: weights-v2 path: /weights/v2 operations: - name: getweights method: GET description: Get weight history outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateweight method: POST description: Update weight entry outputRawFormat: json outputParameters: - name: result type: object value: $. - name: saved-meals-v2 path: /saved-meals/v2 operations: - name: listsavedmeals method: GET description: List saved meals outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createsavedmeal method: POST description: Create saved meal outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest port: 8080 namespace: fatsecret-rest description: REST adapter for FatSecret Platform API. resources: - path: /foods/search/v5 name: searchfoods operations: - method: GET name: searchfoods description: Search foods call: fatsecret.searchfoods outputParameters: - type: object mapping: $. - path: /foods/autocomplete/v2 name: autocompletefoods operations: - method: GET name: autocompletefoods description: Autocomplete food search call: fatsecret.autocompletefoods outputParameters: - type: object mapping: $. - path: /food/barcode/find-by-id/v1 name: findfoodbybarcode operations: - method: GET name: findfoodbybarcode description: Find food by barcode call: fatsecret.findfoodbybarcode outputParameters: - type: object mapping: $. - path: /food/v4 name: getfood operations: - method: GET name: getfood description: Get food by id call: fatsecret.getfood outputParameters: - type: object mapping: $. - path: /food-brands/v2 name: listfoodbrands operations: - method: GET name: listfoodbrands description: List food brands call: fatsecret.listfoodbrands outputParameters: - type: object mapping: $. - path: /food-categories/v2 name: listfoodcategories operations: - method: GET name: listfoodcategories description: List food categories call: fatsecret.listfoodcategories outputParameters: - type: object mapping: $. - path: /food-sub-categories/v2 name: listfoodsubcategories operations: - method: GET name: listfoodsubcategories description: List food sub-categories call: fatsecret.listfoodsubcategories outputParameters: - type: object mapping: $. - path: /recipes/search/v3 name: searchrecipes operations: - method: GET name: searchrecipes description: Search recipes call: fatsecret.searchrecipes outputParameters: - type: object mapping: $. - path: /recipe/v2 name: getrecipe operations: - method: GET name: getrecipe description: Get recipe by id call: fatsecret.getrecipe outputParameters: - type: object mapping: $. - path: /recipe-types/v2 name: listrecipetypes operations: - method: GET name: listrecipetypes description: List recipe types call: fatsecret.listrecipetypes outputParameters: - type: object mapping: $. - path: /exercises/v2 name: listexercises operations: - method: GET name: listexercises description: List exercises call: fatsecret.listexercises outputParameters: - type: object mapping: $. - path: /food/favorites/v2 name: getfavoritefoods operations: - method: GET name: getfavoritefoods description: Get favorite foods call: fatsecret.getfavoritefoods outputParameters: - type: object mapping: $. - path: /food/favorite/add/v2 name: addfavoritefood operations: - method: POST name: addfavoritefood description: Add favorite food call: fatsecret.addfavoritefood outputParameters: - type: object mapping: $. - path: /food/favorite/delete/v2 name: deletefavoritefood operations: - method: POST name: deletefavoritefood description: Delete favorite food call: fatsecret.deletefavoritefood outputParameters: - type: object mapping: $. - path: /food-entries/v2 name: getfoodentries operations: - method: GET name: getfoodentries description: Get food diary entries call: fatsecret.getfoodentries outputParameters: - type: object mapping: $. - path: /food-entries/v2 name: createfoodentry operations: - method: POST name: createfoodentry description: Create food diary entry call: fatsecret.createfoodentry outputParameters: - type: object mapping: $. - path: /food-entries/month/v2 name: getfoodentriesmonth operations: - method: GET name: getfoodentriesmonth description: Monthly food diary summary call: fatsecret.getfoodentriesmonth outputParameters: - type: object mapping: $. - path: /exercise-entries/v2 name: getexerciseentries operations: - method: GET name: getexerciseentries description: Get exercise diary entries call: fatsecret.getexerciseentries outputParameters: - type: object mapping: $. - path: /exercise-entries/v2 name: commitexerciseentries operations: - method: POST name: commitexerciseentries description: Commit exercise diary entries call: fatsecret.commitexerciseentries outputParameters: - type: object mapping: $. - path: /weights/v2 name: getweights operations: - method: GET name: getweights description: Get weight history call: fatsecret.getweights outputParameters: - type: object mapping: $. - path: /weights/v2 name: updateweight operations: - method: POST name: updateweight description: Update weight entry call: fatsecret.updateweight outputParameters: - type: object mapping: $. - path: /saved-meals/v2 name: listsavedmeals operations: - method: GET name: listsavedmeals description: List saved meals call: fatsecret.listsavedmeals outputParameters: - type: object mapping: $. - path: /saved-meals/v2 name: createsavedmeal operations: - method: POST name: createsavedmeal description: Create saved meal call: fatsecret.createsavedmeal outputParameters: - type: object mapping: $. - type: mcp port: 9090 namespace: fatsecret-mcp transport: http description: MCP adapter for FatSecret Platform API for AI agent use. tools: - name: searchfoods description: Search foods hints: readOnly: true destructive: false idempotent: true call: fatsecret.searchfoods with: search_expression: tools.search_expression page_number: tools.page_number max_results: tools.max_results inputParameters: - name: search_expression type: string description: search_expression required: true - name: page_number type: integer description: page_number - name: max_results type: integer description: max_results outputParameters: - type: object mapping: $. - name: autocompletefoods description: Autocomplete food search hints: readOnly: true destructive: false idempotent: true call: fatsecret.autocompletefoods with: expression: tools.expression inputParameters: - name: expression type: string description: expression required: true outputParameters: - type: object mapping: $. - name: findfoodbybarcode description: Find food by barcode hints: readOnly: true destructive: false idempotent: true call: fatsecret.findfoodbybarcode with: barcode: tools.barcode inputParameters: - name: barcode type: string description: barcode required: true outputParameters: - type: object mapping: $. - name: getfood description: Get food by id hints: readOnly: true destructive: false idempotent: true call: fatsecret.getfood with: food_id: tools.food_id inputParameters: - name: food_id type: string description: food_id required: true outputParameters: - type: object mapping: $. - name: listfoodbrands description: List food brands hints: readOnly: true destructive: false idempotent: true call: fatsecret.listfoodbrands outputParameters: - type: object mapping: $. - name: listfoodcategories description: List food categories hints: readOnly: true destructive: false idempotent: true call: fatsecret.listfoodcategories outputParameters: - type: object mapping: $. - name: listfoodsubcategories description: List food sub-categories hints: readOnly: true destructive: false idempotent: true call: fatsecret.listfoodsubcategories outputParameters: - type: object mapping: $. - name: searchrecipes description: Search recipes hints: readOnly: true destructive: false idempotent: true call: fatsecret.searchrecipes with: search_expression: tools.search_expression inputParameters: - name: search_expression type: string description: search_expression outputParameters: - type: object mapping: $. - name: getrecipe description: Get recipe by id hints: readOnly: true destructive: false idempotent: true call: fatsecret.getrecipe with: recipe_id: tools.recipe_id inputParameters: - name: recipe_id type: string description: recipe_id required: true outputParameters: - type: object mapping: $. - name: listrecipetypes description: List recipe types hints: readOnly: true destructive: false idempotent: true call: fatsecret.listrecipetypes outputParameters: - type: object mapping: $. - name: listexercises description: List exercises hints: readOnly: true destructive: false idempotent: true call: fatsecret.listexercises outputParameters: - type: object mapping: $. - name: getfavoritefoods description: Get favorite foods hints: readOnly: true destructive: false idempotent: true call: fatsecret.getfavoritefoods outputParameters: - type: object mapping: $. - name: addfavoritefood description: Add favorite food hints: readOnly: false destructive: false idempotent: false call: fatsecret.addfavoritefood outputParameters: - type: object mapping: $. - name: deletefavoritefood description: Delete favorite food hints: readOnly: false destructive: false idempotent: false call: fatsecret.deletefavoritefood outputParameters: - type: object mapping: $. - name: getfoodentries description: Get food diary entries hints: readOnly: true destructive: false idempotent: true call: fatsecret.getfoodentries with: date: tools.date inputParameters: - name: date type: string description: date outputParameters: - type: object mapping: $. - name: createfoodentry description: Create food diary entry hints: readOnly: false destructive: false idempotent: false call: fatsecret.createfoodentry outputParameters: - type: object mapping: $. - name: getfoodentriesmonth description: Monthly food diary summary hints: readOnly: true destructive: false idempotent: true call: fatsecret.getfoodentriesmonth with: month: tools.month inputParameters: - name: month type: string description: month outputParameters: - type: object mapping: $. - name: getexerciseentries description: Get exercise diary entries hints: readOnly: true destructive: false idempotent: true call: fatsecret.getexerciseentries outputParameters: - type: object mapping: $. - name: commitexerciseentries description: Commit exercise diary entries hints: readOnly: false destructive: false idempotent: false call: fatsecret.commitexerciseentries outputParameters: - type: object mapping: $. - name: getweights description: Get weight history hints: readOnly: true destructive: false idempotent: true call: fatsecret.getweights outputParameters: - type: object mapping: $. - name: updateweight description: Update weight entry hints: readOnly: false destructive: false idempotent: false call: fatsecret.updateweight outputParameters: - type: object mapping: $. - name: listsavedmeals description: List saved meals hints: readOnly: true destructive: false idempotent: true call: fatsecret.listsavedmeals outputParameters: - type: object mapping: $. - name: createsavedmeal description: Create saved meal hints: readOnly: false destructive: false idempotent: false call: fatsecret.createsavedmeal outputParameters: - type: object mapping: $. binds: - namespace: env keys: FATSECRET_TOKEN: FATSECRET_TOKEN