Kitchen Timer is an MCP server published by com.tnyforge, hosted at kt.tnyforge.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 9 tools, including plan_meal, meal_status, pause_meal, resume_meal, adjust_dish.
Plan a meal and run kitchen timers that ring on your phone. No sign-in.
1 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Make a meal plan: each dish starts at the right moment so everything is ready at the same time. Returns a link (open it on the phone in the kitchen, where the alarms ring), a QR code for that link, and the schedule. YOU do the cooking knowledge: break a recipe into dishes, each with its total cooking minutes, and put the timed moments inside a dish as steps ("simmer 20, rest 5" is a dish of 25 minutes with a step "Rest" at 20). If the person did not say when they want to eat, ASK before calling; use `readyInMinutes` for "we eat in 90 minutes", `readyAt` (an ISO date-time with a UTC offset, or local time plus `timeZone`) for "at 7", or `startNow` to start cooking now (a single timer is a one-dish plan with `startNow`). Keep times realistic and use only what the person gave you; at most 12 dishes, no dish over 12 hours, and a ready time up to two weeks ahead (later is refused). If the person gave only a clock time that has already passed today, take the next such time or ask which day, and STATE THE DATE you chose in your answer; send `readyAt` as a full ISO date-time. For a plan more than a day away, tell the person to open the Kitchen Timer app on their phone once before the day. Dish names are plain text, no links. The reply link works for anyone who has it and the plan is deleted about a day after the meal. Tell the person the alarms ring on the phone page, not in this chat. When you wrote a recipe, send it as `recipe` (ingredients and ordered steps, with `dish` on the step that starts each timed dish): the page then shows the recipe, and Start cooking opens it on the phone with each timer inside its step and saves it under Meals. It is public like the plan, so nothing personal in it. The reply also holds a secret CONTROL KEY (starts with ktpk_): remember it for the rest of the chat, do not show it or put it in any link, and pass it with the plan's code to the control tools to keep managing this plan. Kitchen Timer can also be connected for the whole kitchen: ⋯ → Link an agent in the app shows the connector address and a 6-digit code.
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Parameter | Type | Description |
|---|---|---|
| dishes * | array | What is being cooked. A single timer is one dish. |
| recipe | object | Optional: the recipe, so the person gets a full meal to cook from (ingredients, then the steps in order, each timed step showing its timer) and not only timers. It is saved under Meals on their phone when they tap Start cooking. Leave it out for a plain timer plan. Plain text only, no links. It is p… |
| readyAt | ["string","number"] | Everything ready at this time: ISO 8601 with a UTC offset (2026-10-17T19:00:00+01:00), or without an offset when timeZone is given, or epoch milliseconds. |
| startNow | boolean | True: start every dish now (the longest dish sets when it is ready). |
| timeZone | string | Optional IANA time zone such as Europe/London. Only used to word the schedule text; the card and the phone show times in the viewer's own clock. |
| readyInMinutes | number | Everything ready this many minutes from now. Give exactly one of readyInMinutes, readyAt, startNow. |
{
"name": "plan_meal",
"title": "Plan a meal",
"description": "Make a meal plan: each dish starts at the right moment so everything is ready at the same time. Returns a link (open it on the phone in the kitchen, where the alarms ring), a QR code for that link, and the schedule. YOU do the cooking knowledge: break a recipe into dishes, each with its total cooking minutes, and put the timed moments inside a dish as steps (\"simmer 20, rest 5\" is a dish of 25 minutes with a step \"Rest\" at 20). If the person did not say when they want to eat, ASK before calling; use `readyInMinutes` for \"we eat in 90 minutes\", `readyAt` (an ISO date-time with a UTC offset, or local time plus `timeZone`) for \"at 7\", or `startNow` to start cooking now (a single timer is a one-dish plan with `startNow`). Keep times realistic and use only what the person gave you; at most 12 dishes, no dish over 12 hours, and a ready time up to two weeks ahead (later is refused). If the person gave only a clock time that has already passed today, take the next such time or ask which day, and STATE THE DATE you chose in your answer; send `readyAt` as a full ISO date-time. For a plan more than a day away, tell the person to open the Kitchen Timer app on their phone once before the day. Dish names are plain text, no links. The reply link works for anyone who has it and the plan is deleted about a day after the meal. Tell the person the alarms ring on the phone page, not in this chat. When you wrote a recipe, send it as `recipe` (ingredients and ordered steps, with `dish` on the step that starts each timed dish): the page then shows the recipe, and Start cooking opens it on the phone with each timer inside its step and saves it under Meals. It is public like the plan, so nothing personal in it. The reply also holds a secret CONTROL KEY (starts with ktpk_): remember it for the rest of the chat, do not show it or put it in any link, and pass it with the plan's code to the control tools to keep managing this plan. Kitchen Timer can also be connected for the whole kitchen: ⋯ → Link an agent in the app shows the connector address and a 6-digit code.",
"inputSchema": {
"type": "object",
"required": [
"dishes"
],
"properties": {
"dishes": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"minutes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Plain text, 80 characters at most. For example \"Roast chicken\"."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"atMinutes"
],
"properties": {
"label": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "For example \"Turn the chicken\"."
},
"atMinutes": {
"type": "number",
"maximum": 720,
"minimum": 0.1,
"description": "Minutes after this dish goes in; before its total time."
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "Optional moments inside the cooking time, such as turning or resting."
},
"minutes": {
"type": "number",
"maximum": 720,
"minimum": 0.1,
"description": "Total cooking time in minutes, from putting it in until it is done."
},
"startsAfter": {
"type": "object",
"required": [
"dish",
"when"
],
"properties": {
"dish": {
"type": [
"string",
"number"
],
"description": "The other dish: its name as in this plan, or its number (1 is the first dish)."
},
"when": {
"enum": [
"goes in",
"is done"
],
"type": "string",
"description": "Count from when the other dish goes in, or from when it is done."
},
"minutes": {
"type": "number",
"maximum": 720,
"minimum": 0,
"description": "Minutes after that moment. 0 or left out: right then."
}
},
"description": "Optional: this dish starts a while after ANOTHER dish instead of finishing with the meal, for example the potatoes 30 minutes after the chicken goes in. Starting that other dish early or late then moves this one with it. The other dish may not itself wait on this one.",
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 12,
"minItems": 1,
"description": "What is being cooked. A single timer is one dish."
},
"recipe": {
"type": "object",
"required": [
"steps"
],
"properties": {
"steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"dish": {
"type": "integer",
"minimum": 0,
"description": "Only on the step that starts a dish's timer: that dish's position in `dishes`, counting from 0 (the first dish is 0). Each dish at most once. The time is the dish's own `minutes`; never repeat it here."
},
"text": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "What to do, 400 characters at most."
},
"title": {
"type": "string",
"maxLength": 500,
"description": "A short heading, 80 characters at most. Left out: the start of the text."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1,
"description": "The method in order, at most 20 steps. A step that puts a dish on to cook sets `dish` and so starts that dish's timer; a hands-on step (chop, season, rest, serve) has no `dish`."
},
"title": {
"type": "string",
"maxLength": 500,
"description": "The name the meal is saved under in Meals, 80 characters at most. Left out: the dish names."
},
"summary": {
"type": "string",
"maxLength": 1000,
"description": "One or two sentences about the dish, 300 characters at most."
},
"ingredients": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000
},
"maxItems": 100,
"description": "Ingredient lines with quantities, for example \"1.8 kg chicken\". At most 30, 100 characters each."
}
},
"description": "Optional: the recipe, so the person gets a full meal to cook from (ingredients, then the steps in order, each timed step showing its timer) and not only timers. It is saved under Meals on their phone when they tap Start cooking. Leave it out for a plain timer plan. Plain text only, no links. It is public like the rest of the plan (anyone with the link can read it, deleted about a day after the meal), so put nothing personal in it. Limits: 30 ingredients, 20 steps, step text 400 characters; over a limit the call is refused, nothing is cut.",
"additionalProperties": false
},
"readyAt": {
"type": [
"string",
"number"
],
"maxLength": 64,
"description": "Everything ready at this time: ISO 8601 with a UTC offset (2026-10-17T19:00:00+01:00), or without an offset when timeZone is given, or epoch milliseconds."
},
"startNow": {
"type": "boolean",
"description": "True: start every dish now (the longest dish sets when it is ready)."
},
"timeZone": {
"type": "string",
"maxLength": 64,
"description": "Optional IANA time zone such as Europe/London. Only used to word the schedule text; the card and the phone show times in the viewer's own clock."
},
"readyInMinutes": {
"type": "number",
"maximum": 86400,
"minimum": 1,
"description": "Everything ready this many minutes from now. Give exactly one of readyInMinutes, readyAt, startNow."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"code",
"url",
"readyAtMs",
"schedule"
],
"properties": {
"url": {
"type": "string",
"description": "Open this on the phone in the kitchen."
},
"code": {
"type": "string"
},
"links": {
"type": "array",
"items": {
"type": "object"
},
"description": "Each dish that starts after another dish (also on the dish as startsAfter)."
},
"alarms": {
"type": "string"
},
"dishes": {
"type": "array",
"items": {
"type": "object"
}
},
"readyAt": {
"type": "string",
"description": "Ready time, ISO 8601 (UTC)."
},
"schedule": {
"type": "array",
"items": {
"type": "object",
"required": [
"atMs",
"kind",
"label"
],
"properties": {
"atMs": {
"type": "integer"
},
"kind": {
"enum": [
"start",
"step",
"ready"
],
"type": "string"
},
"label": {
"type": "string"
}
}
}
},
"readyAtMs": {
"type": "integer"
},
"expiresAtMs": {
"type": "integer"
},
"serverNowMs": {
"type": "integer"
}
}
},
"annotations": {
"title": "Plan a meal",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Say what is next in a meal plan made with plan_meal, and how long until it. Give the plan's code (the last part of its link). Only reads; never changes a plan. Give the control key too, if you have it, to also see the timers on the phone.
| Parameter | Type | Description |
|---|---|---|
| key | string | Optional: the plan's secret control key. With it the answer also says whether the person has started the timers on the phone and what each one is doing. |
| code * | string | The plan's code, or its whole link. |
{
"name": "meal_status",
"title": "What is next in a meal plan",
"description": "Say what is next in a meal plan made with plan_meal, and how long until it. Give the plan's code (the last part of its link). Only reads; never changes a plan. Give the control key too, if you have it, to also see the timers on the phone.",
"inputSchema": {
"type": "object",
"required": [
"code"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Optional: the plan's secret control key. With it the answer also says whether the person has started the timers on the phone and what each one is doing."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"code",
"state",
"readyAtMs"
],
"properties": {
"code": {
"type": "string"
},
"next": {
"type": [
"object",
"null"
]
},
"links": {
"type": "array",
"items": {
"type": "object"
},
"description": "Each dish that starts after another dish: {dish, number, after, afterNumber, when: 'goes in'|'is done', minutes, text}. Keep these when you change the plan."
},
"state": {
"enum": [
"waiting",
"cooking",
"ready"
],
"type": "string"
},
"timers": {
"type": "array",
"items": {
"type": "object"
},
"description": "Only with the key, once the phone has started: each dish's state on the phone."
},
"claimed": {
"type": "boolean",
"description": "Only with the key: a phone has tapped Start."
},
"readyAt": {
"type": "string",
"description": "Ready time, ISO 8601 (UTC)."
},
"upcoming": {
"type": "array",
"items": {
"type": "object"
}
},
"readyAtMs": {
"type": "integer"
},
"serverNowMs": {
"type": "integer"
}
}
},
"annotations": {
"title": "What is next in a meal plan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Pause every dish of this plan that is running on the phone (the cook can resume on the phone or you can call resume_meal). Needs the plan's code and control key. Only works after the person has tapped Start on the phone; before that it says so.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
{
"name": "pause_meal",
"title": "Pause the meal",
"description": "Pause every dish of this plan that is running on the phone (the cook can resume on the phone or you can call resume_meal). Needs the plan's code and control key. Only works after the person has tapped Start on the phone; before that it says so.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Pause the meal",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Resume the paused dishes of this plan on the phone. Needs the plan's code and control key.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
{
"name": "resume_meal",
"title": "Resume the meal",
"description": "Resume the paused dishes of this plan on the phone. Needs the plan's code and control key.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Resume the meal",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Add time to a dish (a positive number of minutes) or take time off (negative). Before the person taps Start this changes the plan, and the ready time stays; afterwards it changes that dish's timer on the phone. Needs the plan's code and control key.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
| dish * | string | The dish's name as in the plan, or its number in the plan (1 is the first dish). |
| minutes * | number | Minutes to add (positive) or take off (negative), such as 2 or -1.5. Not zero. |
{
"name": "adjust_dish",
"title": "Add or take off time",
"description": "Add time to a dish (a positive number of minutes) or take time off (negative). Before the person taps Start this changes the plan, and the ready time stays; afterwards it changes that dish's timer on the phone. Needs the plan's code and control key.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key",
"dish",
"minutes"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
},
"dish": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The dish's name as in the plan, or its number in the plan (1 is the first dish)."
},
"minutes": {
"type": "number",
"maximum": 720,
"minimum": -720,
"description": "Minutes to add (positive) or take off (negative), such as 2 or -1.5. Not zero."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Add or take off time",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Skip the rest of the current wait for one dish: a dish still waiting to go in starts now, and a dish that is cooking finishes now. Only works after the person has tapped Start on the phone. Needs the plan's code and control key.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
| dish * | string | The dish's name as in the plan, or its number in the plan (1 is the first dish). |
{
"name": "skip_step",
"title": "Skip ahead on a dish",
"description": "Skip the rest of the current wait for one dish: a dish still waiting to go in starts now, and a dish that is cooking finishes now. Only works after the person has tapped Start on the phone. Needs the plan's code and control key.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key",
"dish"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
},
"dish": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The dish's name as in the plan, or its number in the plan (1 is the first dish)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Skip ahead on a dish",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Add one more dish to this plan. The ready time stays, so the new dish goes in at the ready time minus its cooking time and must still fit. Before the person taps Start it joins the plan on the sheet; afterwards it goes onto the phone too. Same rules as plan_meal: a plain-text name, at most 12 dishes. Needs the plan's code and control key.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
| name * | string | Plain text, 80 characters at most. |
| steps | array | Optional moments inside the cooking time. |
| minutes * | number | Total cooking time in minutes. |
{
"name": "add_dish",
"title": "Add a dish to the plan",
"description": "Add one more dish to this plan. The ready time stays, so the new dish goes in at the ready time minus its cooking time and must still fit. Before the person taps Start it joins the plan on the sheet; afterwards it goes onto the phone too. Same rules as plan_meal: a plain-text name, at most 12 dishes. Needs the plan's code and control key.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key",
"name",
"minutes"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Plain text, 80 characters at most."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"atMinutes"
],
"properties": {
"label": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"atMinutes": {
"type": "number",
"maximum": 720,
"minimum": 0.1
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "Optional moments inside the cooking time."
},
"minutes": {
"type": "number",
"maximum": 720,
"minimum": 0.1,
"description": "Total cooking time in minutes."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Add a dish to the plan",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Make a dish start a while after another dish goes in or is done ("the potatoes 30 minutes after the chicken goes in"), or clear that link by leaving `after` out. Starting the other dish early or late then moves this one with it. A dish cannot wait on a dish that waits on it, and a dish that already started cannot be linked. Needs the plan's code and control key.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
| dish * | string | The dish's name as in the plan, or its number in the plan (1 is the first dish). |
| when | string | Count from when that dish goes in, or from when it is done. |
| after | ["string","number"] | The dish to follow: its name as in the plan, or its number. Leave out to clear this dish's link. |
| minutes | number | Minutes after that moment. 0 or left out: right then. |
{
"name": "link_dish",
"title": "Start a dish after another dish",
"description": "Make a dish start a while after another dish goes in or is done (\"the potatoes 30 minutes after the chicken goes in\"), or clear that link by leaving `after` out. Starting the other dish early or late then moves this one with it. A dish cannot wait on a dish that waits on it, and a dish that already started cannot be linked. Needs the plan's code and control key.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key",
"dish"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
},
"dish": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The dish's name as in the plan, or its number in the plan (1 is the first dish)."
},
"when": {
"enum": [
"goes in",
"is done"
],
"type": "string",
"description": "Count from when that dish goes in, or from when it is done."
},
"after": {
"type": [
"string",
"number"
],
"description": "The dish to follow: its name as in the plan, or its number. Leave out to clear this dish's link."
},
"minutes": {
"type": "number",
"maximum": 720,
"minimum": 0,
"description": "Minutes after that moment. 0 or left out: right then."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Start a dish after another dish",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Cancel this plan: its link stops working, and if the person already started it, its timers are removed from the phone. Only that plan's timers; nothing else on the phone. Needs the plan's code and control key. Ask the person first.
| Parameter | Type | Description |
|---|---|---|
| key * | string | The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link. |
| code * | string | The plan's code, or its whole link. |
{
"name": "cancel_meal",
"title": "Cancel the meal",
"description": "Cancel this plan: its link stops working, and if the person already started it, its timers are removed from the phone. Only that plan's timers; nothing else on the phone. Needs the plan's code and control key. Ask the person first.",
"inputSchema": {
"type": "object",
"required": [
"code",
"key"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The plan's code, or its whole link."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
},
"annotations": {
"title": "Cancel the meal",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Kitchen Timer plans a meal so everything is ready together. Use `plan_meal` when someone wants a cooking schedule or a timer: it makes a shareable meal plan and returns a link and a QR code to open on the phone in the kitchen. The alarms ring on that phone page, not in this chat. Use `meal_status` to say what is next in a plan you made. `plan_meal` also gives you a secret control key for that one plan: keep it to yourself, never put it in the link, and use it with the plan's code to pause, resume, add or take off time, skip ahead, add a dish, start a dish after another dish (link_dish) or cancel (the tools below). Once the person taps Start on the phone, those tools change the timers of that plan and nothing else; before that they change the plan itself. This server cannot see or change anyone's other timers. When you wrote a recipe, send it with plan_meal as `recipe` so the person gets a full meal to cook from, not only timers. Plans are public to anyone with the link and are deleted about a day after the meal. Kitchen Timer can also be connected for the whole kitchen (all timers, presets and recipes, not just this meal). In the app, ⋯ → Link an agent shows a 6-digit code and the connector address (it ends in /mcp). Adding that address as a connector and typing the code when asked is all it takes; no password. The connected assistant sees and manages all their timers, and only with the code they give. The connector address for that is https://kt.tnyforge.com/mcp.
Names, descriptions and schemas were written by the server and are shown as data.