# ReciPal MCP by usefulapi (remote · recipal.usefulapi.io)

Read recipes, nutrition and inventory, manage ingredients and costs, and render ReciPal labels.

- Trust score: 18/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `recipal.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-recipal/recipal.md), [page](https://verifymcp.io/servers/io-usefulapi-recipal/recipal)

## Channel facts

- Endpoint: `https://recipal.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.7.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the ReciPal MCP by usefulapi server?

ReciPal MCP by usefulapi is a hosted endpoint at https://recipal.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-recipal 'https://recipal.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-recipal": {
      "url": "https://recipal.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-recipal": {
      "type": "http",
      "url": "https://recipal.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-recipal]
url = "https://recipal.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-recipal": {
      "type": "remote",
      "url": "https://recipal.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-recipal --url 'https://recipal.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-recipal:
    url: "https://recipal.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-recipal": {
      "Transport": "http",
      "Url": "https://recipal.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-recipal -t streamable-http -u 'https://recipal.usefulapi.io/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-02 (score 18, −47)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.03 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-11-01 (score 65, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-10-31 (score 64)

First indexed and scored.

## MCP tools (30)

### `recipal_list_recipes` (~217 tokens)

List recipes

List your recipes (products) with yield, servings, cost per batch/package and the headline per-serving nutrition (calories, fat, sodium, carbohydrate, protein). Sorted by last update by default. Set full=true for the complete object with every nutrient. Pages of up to 20; a page with fewer rows is the last. GET /recipes.

Input parameters:

- `archived` (string): "false" = active only (default), "true" = archived only, "all" = both.
- `full` (boolean): Return every recipe field including all ~80 nutrients (large). Default false.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-20 (default 20).
- `sort_direction` (string): "desc" (default) or "asc".
- `sort_field` (string): Sort by "updated_at" (default), "created_at" or "name".

### `recipal_get_recipe` (~68 tokens)

Get recipe

One recipe in full: yield, servings, packages, allergens, costs (ingredient + packaging/labor/overhead), ingredient list, tags, primary label path and the complete per-serving nutrition. GET /recipes/{id}.

Input parameters:

- `recipe_id` (integer, required): ReciPal recipe id.

### `recipal_list_recipe_ingredients` (~79 tokens)

List recipe ingredients

The formula of one recipe: every recipe ingredient line with ingredient id, name, quantity, unit, waste %, total grams and the display name per label language. Use the line ids with recipal_update_recipe_ingredient. GET /recipes/{id}/recipe_ingredients.

Input parameters:

- `recipe_id` (integer, required): ReciPal recipe id.

### `recipal_get_recipe_ingredient` (~82 tokens)

Get recipe ingredient

One ingredient line of a recipe, including units_and_grams (the units you can use for it, each with its weight in grams). GET /recipes/{recipe_id}/recipe_ingredients/{id}.

Input parameters:

- `recipe_id` (integer, required): ReciPal recipe id.
- `recipe_ingredient_id` (integer, required): Recipe ingredient (line) id.

### `recipal_list_ingredients` (~186 tokens)

List ingredients

List your own ingredients (custom and subrecipe ingredients) with allergens, units and headline nutrition per 100 g. Set full=true for every nutrient. Archived ones are hidden unless asked for. GET /ingredients.

Input parameters:

- `archived` (string): "false" = active only (default), "true" = archived only, "all" = both.
- `full` (boolean): Return every ingredient field including all nutrients (large). Default false.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-20 (default 20).
- `sort_direction` (string): "desc" (default) or "asc".
- `sort_field` (string): Sort by "updated_at" (default), "created_at" or "name".

### `recipal_get_ingredient` (~59 tokens)

Get ingredient

One ingredient in full (yours or a public one): allergens, ingredient-list text, custom units, and every nutrient per 100 grams. GET /ingredients/{id}.

Input parameters:

- `ingredient_id` (integer, required): ReciPal ingredient id.

### `recipal_list_ingredient_costs` (~117 tokens)

List costs of an ingredient

The cost history of one ingredient: effective date, quantity, unit, price and shipping per entry (the entry with the latest effective_at not in the future is the active one). GET /ingredients/{id}/ingredient_costs.

Input parameters:

- `ingredient_id` (integer, required): ReciPal ingredient id.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-20 (default 20).

### `recipal_list_current_ingredient_costs` (~86 tokens)

List current ingredient costs

The currently active cost of every ingredient (one entry per ingredient): price, shipping, quantity and unit. GET /ingredient_costs.

Input parameters:

- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-20 (default 20).

### `recipal_get_ingredient_cost` (~39 tokens)

Get ingredient cost

One ingredient cost entry by id. GET /ingredient_costs/{id}.

Input parameters:

- `ingredient_cost_id` (integer, required): Ingredient cost id.

### `recipal_get_label` (~134 tokens)

Get label

A recipe's saved nutrition-facts label settings (format, which rows show, styling) plus the computed nutrition claims (e.g. Fat Free) and ingredient list per language. The token is the last part of the recipe's primary_label path (/api/v1/labels/{token}). Optionally compute claims and ingredient list for another format. GET /labels/{token}.

Input parameters:

- `label_token` (string, required): Label token from the recipe's primary_label path.
- `result_format` (string): Compute claims and ingredient list for this format instead of the saved one, e.g. legacy_fda/adult/vertical.

### `recipal_start_label_render` (~175 tokens)

Start label render

WRITE (render job): start rendering a recipe's nutrition label as a PDF or PNG and return the render status with a token. Always asynchronous: poll recipal_get_label_render_status with the token until status is ready, then give the user the temporary download url. Each account may run 5 renders in parallel. GET /recipes/{id}/label.pdf|label.png?async=true.

Input parameters:

- `format` (string, required): "pdf" or "png".
- `page_size` (string): PDF only: "auto" (default) crops to the label, or letter, legal, A4.
- `recipe_id` (integer, required): ReciPal recipe id.
- `zoom` (number): PNG only: scale from 0.8 to 6 (default 3); larger = crisper, bigger image.

### `recipal_get_label_render_status` (~86 tokens)

Get label render status

Status of a label render started with recipal_start_label_render: waiting, processing, ready or error. When ready, url is a temporary presigned download link. Poll about once a second; each poll counts toward the weekly request limit. GET /recipes/label_renders/{token}.

Input parameters:

- `token` (string, required): Render token returned by recipal_start_label_render.

### `recipal_list_inventories` (~249 tokens)

List raw-material inventory

Raw-material (ingredient) stock rows: quantity on hand, weeks remaining, daily consumption, quantity on order, reorder risk (safe, warning, critical), reorder level and the on-hand value. Needs an inventory plan (otherwise 403 INVENTORY_PLAN_REQUIRED). By default sorted by weeks remaining, lowest first. GET /inventories.

Input parameters:

- `archived` (string): "false" = active only (default), "true" = archived only, "all" = both.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-20 (default 20).
- `q` (string): Case-insensitive search in the ingredient name.
- `sort_direction` (string): "asc" (default), "desc", or "mid" (warning band first, then critical, then safe; only for weeks_remaining and risk).
- `sort_field` (string): Default "inventories.weeks_remaining".
- `supplier_id` (integer): Only rows linked to this supplier.
- `tags` (array): Only rows whose ingredient has ALL these tags.

### `recipal_get_inventory` (~55 tokens)

Get raw-material inventory row

One raw-material stock row by id (quantity, unit, weeks remaining, reorder guideline, on-hand value). Needs an inventory plan. GET /inventories/{id}.

Input parameters:

- `inventory_id` (integer, required): Inventory row id.

### `recipal_list_inventory_tags` (~50 tokens)

List ingredient tags

Ingredient tags in use with the number of ingredients carrying each, most used first. Use them to filter recipal_list_inventories. Needs an inventory plan. GET /inventories/tags.

### `recipal_list_finished_goods` (~184 tokens)

List finished goods inventory

Finished-goods stock rows: recipe, quantity on hand, unit, total packages, lot-code settings, case/pallet sizes and the on-hand value. Needs an inventory plan. GET /finished_goods.

Input parameters:

- `archived` (string): "false" = active only (default), "true" = archived only, "all" = both.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-20 (default 20).
- `q` (string): Case-insensitive search in the recipe name.
- `sort_direction` (string): "asc" (default) or "desc".
- `sort_field` (string): Default "recipes.name".
- `tags` (array): Only rows whose recipe has ALL these tags.

### `recipal_get_finished_good` (~45 tokens)

Get finished goods row

One finished-goods stock row by id. Needs an inventory plan. GET /finished_goods/{id}.

Input parameters:

- `finished_good_id` (integer, required): Finished good row id.

### `recipal_list_finished_good_tags` (~50 tokens)

List recipe tags

Recipe tags in use with the number of recipes carrying each, most used first. Use them to filter recipal_list_finished_goods. Needs an inventory plan. GET /finished_goods/tags.

### `recipal_create_recipe` (~553 tokens)

Create recipe

WRITE: create a new, empty recipe (add ingredient lines with recipal_add_recipe_ingredient, or use recipal_create_recipe_from_ingredients to do both at once). All fields are optional. Creates a record in your ReciPal account; it counts against the plan's recipe allowance. POST /recipes.

Input parameters:

- `allergens` (object): Allergens by name, e.g. {"Milk": true, "Almond": true, "other-shellfish": "Oyster"}. Standard names: Wheat, Peanuts, Soy, Sesame, Mustard, Sulfites, Milk (Goat milk, Sheep milk), Egg (Duck egg, Quail…
- `ingredient_list` (string): Ingredient list text for the label.
- `labor_cost` (number): Labor cost per batch.
- `name` (string): Recipe name.
- `overhead_cost` (number): Overhead cost per batch (rent, electricity, equipment ...).
- `package_yield_quantity` (number): Net weight of each finished package, in package_yield_unit (default 0).
- `package_yield_unit` (string): Unit of the finished package weight: "grams" (default), "ounces", "mL" or "fluid ounces".
- `packages` (number): Number of packages the recipe yields per batch (0 or more).
- `packaging_cost` (number): Cost per package of direct and secondary packaging.
- `preparation` (string): Preparation instructions for staff.
- `prepared_serving_note` (string): Note after the serving size on FDA labels, e.g. "makes 1 cup prepared".
- `servings` (number): Servings per package (at least 1).
- `sku` (string): Your SKU.
- `subrecipe_name` (string): Name shown when this recipe is used as a subrecipe in another recipe's ingredient list.
- `subrecipe_name_french` (string): French name shown when used as a subrecipe.
- `suggested_serving` (string): Suggested serving in common terms, e.g. "1 piece or 1 cup".
- `visual_unit_of_measure` (string): Visual reference after the metric serving size on FDA labels, e.g. "5 chips".

### `recipal_update_recipe` (~594 tokens)

Update recipe

WRITE: change fields of one recipe; fields you leave out stay unchanged. package_yield_quantity "default" sets the package weight to the total weight of the current ingredients (no moisture loss accounted for); ingredient_list "default" rebuilds the label ingredient list in descending weight order. Changes labels and costs of this recipe. Tags cannot be set here. PUT /recipes/{id}.

Input parameters:

- `allergens` (object): Allergens by name, e.g. {"Milk": true, "Almond": true, "other-shellfish": "Oyster"}. Standard names: Wheat, Peanuts, Soy, Sesame, Mustard, Sulfites, Milk (Goat milk, Sheep milk), Egg (Duck egg, Quail…
- `ingredient_list` (string): Ingredient list text for the label, or "default" to rebuild it from the ingredients.
- `labor_cost` (number): Labor cost per batch.
- `name` (string): Recipe name.
- `overhead_cost` (number): Overhead cost per batch (rent, electricity, equipment ...).
- `package_yield_quantity`: Net weight of each finished package in package_yield_unit, or "default" to total the ingredient weights.
- `package_yield_unit` (string): Unit of the finished package weight: "grams" (default), "ounces", "mL" or "fluid ounces".
- `packages` (number): Number of packages the recipe yields per batch (0 or more).
- `packaging_cost` (number): Cost per package of direct and secondary packaging.
- `preparation` (string): Preparation instructions for staff.
- `prepared_serving_note` (string): Note after the serving size on FDA labels, e.g. "makes 1 cup prepared".
- `recipe_id` (integer, required): ReciPal recipe id.
- `servings` (number): Servings per package (at least 1).
- `sku` (string): Your SKU.
- `subrecipe_name` (string): Name shown when this recipe is used as a subrecipe in another recipe's ingredient list.
- `subrecipe_name_french` (string): French name shown when used as a subrecipe.
- `suggested_serving` (string): Suggested serving in common terms, e.g. "1 piece or 1 cup".
- `visual_unit_of_measure` (string): Visual reference after the metric serving size on FDA labels, e.g. "5 chips".

### `recipal_scale_recipe` (~139 tokens)

Copy or scale recipe

WRITE: create a NEW recipe as a copy of an existing one, with every ingredient quantity and the yield multiplied by scale_amount (1 = plain copy; per-serving nutrition stays the same; scaling down cannot take packages below 1). Costs and tags carry over. The original is not changed. Without a name the copy is called "<name> (copy)" or "<name> <n>x". POST /recipes/{id}/scale.

Input parameters:

- `name` (string): Name of the new recipe.
- `recipe_id` (integer, required): Recipe to copy.
- `scale_amount` (number): Multiplier for quantities and yield (default 1).

### `recipal_create_recipe_from_ingredients` (~568 tokens)

Create recipe with ingredients

WRITE: create a new recipe and its ingredient lines in one call. ingredients lists ingredient ids with the weight of each in grams. Optional yield, servings and packaging fields as in recipal_create_recipe. Creates a record in your ReciPal account. POST /recipes/shortcut.

Input parameters:

- `allergens` (object): Allergens by name, e.g. {"Milk": true, "Almond": true, "other-shellfish": "Oyster"}. Standard names: Wheat, Peanuts, Soy, Sesame, Mustard, Sulfites, Milk (Goat milk, Sheep milk), Egg (Duck egg, Quail…
- `ingredient_list` (string): Ingredient list text for the label.
- `ingredients` (array, required): Ingredient ids with their weights in grams (1-100 lines).
- `labor_cost` (number): Labor cost per batch.
- `name` (string): Recipe name.
- `overhead_cost` (number): Overhead cost per batch (rent, electricity, equipment ...).
- `package_yield_quantity` (number): Net weight of each finished package, in package_yield_unit (default 0).
- `package_yield_unit` (string): Unit of the finished package weight: "grams" (default), "ounces", "mL" or "fluid ounces".
- `packages` (number): Number of packages the recipe yields per batch (0 or more).
- `packaging_cost` (number): Cost per package of direct and secondary packaging.
- `preparation` (string): Preparation instructions for staff.
- `prepared_serving_note` (string): Note after the serving size on FDA labels, e.g. "makes 1 cup prepared".
- `servings` (number): Servings per package (at least 1).
- `sku` (string): Your SKU.
- `subrecipe_name` (string): Name shown when this recipe is used as a subrecipe in another recipe's ingredient list.
- `subrecipe_name_french` (string): French name shown when used as a subrecipe.
- `suggested_serving` (string): Suggested serving in common terms, e.g. "1 piece or 1 cup".
- `visual_unit_of_measure` (string): Visual reference after the metric serving size on FDA labels, e.g. "5 chips".

### `recipal_create_subrecipe` (~91 tokens)

Turn recipe into subrecipe

WRITE: turn a recipe into an ingredient (a subrecipe) with its nutrition, costing and ingredient list, so it can be used inside other recipes. Later changes to the recipe flow through to the ingredient. Fails if the recipe is empty. Returns the new ingredient. POST /recipes/{id}/create_subrecipe.

Input parameters:

- `recipe_id` (integer, required): Recipe to turn into a subrecipe.

### `recipal_add_recipe_ingredient` (~207 tokens)

Add ingredient to recipe

WRITE: add an ingredient line to a recipe, by unit and quantity (the unit must be one the ingredient offers, e.g. "1 cup" or "1 gram"; see units_and_grams from recipal_get_recipe_ingredient or valid_units from recipal_get_ingredient) or directly by total_grams (overrides unit and quantity). Changes the recipe's nutrition, label and cost. POST /recipes/{id}/recipe_ingredients.

Input parameters:

- `ingredient_id` (integer, required): Ingredient to add.
- `quantity` (number): Amount of the unit (default 1).
- `recipe_id` (integer, required): ReciPal recipe id.
- `total_grams` (number): Weight in grams; overrides unit and quantity.
- `unit` (string): Unit of the ingredient (default: its first unit).
- `waste` (number): Percent of the ingredient that does not go into the product (0-100). Costed in full, excluded from nutrition.

### `recipal_update_recipe_ingredient` (~173 tokens)

Update recipe ingredient amount

WRITE: change the AMOUNT of one ingredient line in a recipe (unit, quantity, waste or total_grams; total_grams overrides unit and quantity). It cannot swap the ingredient: remove the line and add another instead. Changes the recipe's nutrition, label and cost. PUT /recipes/{recipe_id}/recipe_ingredients/{id}.

Input parameters:

- `quantity` (number): Amount of the unit.
- `recipe_id` (integer, required): ReciPal recipe id.
- `recipe_ingredient_id` (integer, required): Recipe ingredient (line) id from recipal_list_recipe_ingredients.
- `total_grams` (number): Weight in grams; overrides unit and quantity.
- `unit` (string): Unit, one of the ingredient's units.
- `waste` (number): Waste percent (0-100).

### `recipal_remove_recipe_ingredient` (~114 tokens)

Remove ingredient from recipe

WRITE (destructive): permanently remove one ingredient line from a recipe. It cannot be undone, but the same ingredient can be added back (with recipal_add_recipe_ingredient). Changes the recipe's nutrition, label and cost. The ingredient itself is not deleted. DELETE /recipes/{recipe_id}/recipe_ingredients/{id}.

Input parameters:

- `recipe_id` (integer, required): ReciPal recipe id.
- `recipe_ingredient_id` (integer, required): Recipe ingredient (line) id from recipal_list_recipe_ingredients.

### `recipal_create_ingredient` (~759 tokens)

Create ingredient

WRITE: create a custom ingredient (private to your account) with its nutrition facts. For a food ingredient give nutrition_unit and nutrition_quantity (the serving the nutrients are entered for, e.g. 1 cup; for units beyond gram/oz/lb/kg add them in measures first) and all required nutrients. food and non_food cannot be changed later. Non-food items: set food=false and non_food to labor, packaging, safety, other_hourly or other_fixed. POST /ingredients.

Input parameters:

- `allergens` (object): Allergens by name, e.g. {"Milk": true, "Almond": true, "other-shellfish": "Oyster"}. Standard names: Wheat, Peanuts, Soy, Sesame, Mustard, Sulfites, Milk (Goat milk, Sheep milk), Egg (Duck egg, Quail…
- `brand` (string): Brand name, mainly to verify data.
- `food` (boolean): true (default) for a food ingredient; false for a non-food item.
- `ingredient_list` (string): Ingredient list text as it appears on a label, e.g. "Curlies (Milk, Sugar)".
- `measures` (array): Custom units, e.g. [{quantity:1, unit:'cup', equivalent_quantity:240, equivalent_unit:'gram'}].
- `name` (string, required): Ingredient name (unique unless private).
- `non_food` (string): Required when food=false.
- `nutrients` (object): Nutrition facts (food ingredients only). Amounts per serving (nutrition_quantity x nutrition_unit): calories; grams for protein, fat, fat_saturated, fat_trans, carbohydrate, fiber, uncounted_fiber, s…
- `nutrition_quantity` (number): Required for food ingredients: quantity of nutrition_unit the nutrients are for, e.g. 0.5 for 0.5 cup.
- `nutrition_unit` (string): Required for food and safety ingredients. Food: the unit the nutrients are entered in (gram, oz, lb, kg, "100 grams", a unit from measures, or a volume unit such as cup once measures includes a volum…
- `source` (string): Data source: URL, supplier or recipe id.

### `recipal_update_ingredient` (~572 tokens)

Update ingredient

WRITE: change fields of one of YOUR ingredients (public ingredients cannot be edited); fields you leave out stay unchanged. If nutrition_unit, nutrition_quantity or their measure change, nutrients you do not pass are rescaled to keep the same amount per serving. measures REPLACES the whole list of custom units, so send them all. Setting archived true hides the ingredient from lists; false restores it. The change flows into every recipe using the ingredient. PUT /ingredients/{id}.

Input parameters:

- `allergens` (object): Allergens by name, e.g. {"Milk": true, "Almond": true, "other-shellfish": "Oyster"}. Standard names: Wheat, Peanuts, Soy, Sesame, Mustard, Sulfites, Milk (Goat milk, Sheep milk), Egg (Duck egg, Quail…
- `archived` (boolean): true to archive, false to restore.
- `brand` (string): Brand name.
- `ingredient_id` (integer, required): ReciPal ingredient id (one you created).
- `ingredient_list` (string): Ingredient list text for labels.
- `measures` (array): The FULL list of custom units (replaces the existing list).
- `name` (string): Ingredient name.
- `nutrients` (object): Nutrition facts to change; others are kept. Amounts per serving (nutrition_quantity x nutrition_unit): calories; grams for protein, fat, fat_saturated, fat_trans, carbohydrate, fiber, uncounted_fiber…
- `nutrition_quantity` (number): Quantity of nutrition_unit the nutrients are for.
- `nutrition_unit` (string): Unit the nutrients are entered in.
- `source` (string): Data source.

### `recipal_create_ingredient_cost` (~186 tokens)

Add ingredient cost

WRITE: add a price for an ingredient that becomes active on effective_at (the active cost is the one with the latest effective_at not after the date; one cost per ingredient per date). price and shipping are per quantity x unit. Changes the cost of every recipe using the ingredient from that date. Not allowed for subrecipe ingredients. POST /ingredient_costs.

Input parameters:

- `effective_at` (string, required): Date the cost becomes active, yyyy-mm-dd.
- `ingredient_id` (integer, required): Ingredient id.
- `price` (number): Price for quantity x unit (default 0).
- `quantity` (number): How much of the unit the price covers (default 0).
- `shipping` (number): Shipping for quantity x unit (default 0).
- `unit` (string, required): A unit of the ingredient, e.g. "1 cup", "1 lb".

### `recipal_update_ingredient_cost` (~143 tokens)

Update ingredient cost

WRITE: change an existing ingredient cost entry (date, unit, quantity, price, shipping); fields you leave out stay unchanged. Changes recipe costs that depend on it. Not allowed for subrecipe ingredients. PUT /ingredient_costs/{id}.

Input parameters:

- `effective_at` (string): New effective date, yyyy-mm-dd (unique per ingredient).
- `ingredient_cost_id` (integer, required): Ingredient cost id.
- `price` (number): Price for quantity x unit.
- `quantity` (number): How much of the unit the price covers.
- `shipping` (number): Shipping for quantity x unit.
- `unit` (string): A unit of the ingredient.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-recipal/recipal#diagnostics

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 65
- 2026-10-31: 64

## Common questions

### What is the ReciPal MCP by usefulapi server?

ReciPal MCP by usefulapi is listed in the public MCP registry as io.usefulapi/recipal. Read recipes, nutrition and inventory, manage ingredients and costs, and render ReciPal labels. This page covers its hosted endpoint (https://recipal.usefulapi.io/mcp).

### Is the ReciPal MCP by usefulapi server safe to use?

ReciPal MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the ReciPal MCP by usefulapi server expose?

ReciPal MCP by usefulapi exposes 30 tools: recipal_list_recipes, recipal_get_recipe, recipal_list_recipe_ingredients, recipal_get_recipe_ingredient, recipal_list_ingredients, and 25 more. Their descriptions and schemas cost roughly 6,060 tokens of context every time the server is loaded.

### Does the ReciPal MCP by usefulapi server require authentication?

Its publisher declares no required credentials for ReciPal MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.

### Is the ReciPal MCP by usefulapi server still maintained?

ReciPal MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://recipal.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/recipal/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-recipal/recipal.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-recipal/recipal.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-recipal/recipal