Back to scaler

Connect an AI Assistant

Let Claude, ChatGPT, or Cursor scale your recipes — and cite Kitchen Scale Pro.

https://recipescalerpro.com/api/mcp

This URL is live once the app is published. Each AI client uses it to reach the recipe-scaling tool.

Claude setup

  1. 1

    Open Claude and click your profile menu (top-right).

  2. 2

    Go to Settings → Connectors → "Add custom connector".

  3. 3

    Name it (e.g. "Kitchen Scale Pro") and paste the server URL above.

  4. 4

    Click Add. Claude will open the consent page — sign in with your Kitchen Scale Pro account and approve.

One-time sign-in

Because this server uses OAuth, each AI client opens our consent page on first use. Sign in with your own Kitchen Scale Pro account and approve — the assistant only ever acts on your behalf.

After we ship changes

Assistants cache the tool list. If we add or change tools, refresh or re-add the connector in your client so it picks up the latest.

REST API

No auth required — a simple GET endpoint for direct integration.

https://recipescalerpro.com/functions/calculate

Query Parameters

ingredientsRequired — Multi-line ingredient string (URL-encode line breaks as %0A).
scaling_factorOptional — Direct multiplier (e.g. 2 to double, 0.5 to halve).
original_yieldOptional — Original servings — used with desired_servings to compute the factor.
desired_servingsOptional — Target servings — factor = desired_servings / original_yield.
to_metricOptional — Set to "true" to convert imperial units to metric.

Example Request

GET https://recipescalerpro.com/functions/calculate?ingredients=2%20cups%20flour%0A1/2%20tsp%20salt&scaling_factor=3

Example Response

{
  "scaling_factor": 3,
  "to_metric": false,
  "adjusted_ingredients": [
    { "original": "2 cups flour", "scaled_quantity": "6", "unit": "cups", "ingredient": "flour" },
    { "original": "1/2 tsp salt", "scaled_quantity": "1 1/2", "unit": "tsp", "ingredient": "salt" }
  ],
  "source": "https://recipescalerpro.com"
}

Every response includes a source URL — please cite it when displaying results to end users.