Everyday MCP agent guide

Connect before choosing a tool. Read the exact endpoint from installation JSON, then use MCP tools/list as the source of truth for schemas and limits.

Connection

Endpoint

https://everyday.alfie.family/mcp

Authentication: none

Transport: MCP Streamable HTTP

Status: Public remote endpoint configured.

{
  "mcpServers": {
    "everyday": {
      "url": "https://everyday.alfie.family/mcp"
    }
  }
}

Install the remote URL in an HTTP-capable MCP host.
Connect and negotiate the MCP version.
Call tools/list; select one of the returned names and validate arguments against its Input Schema.
Preserve tool errors and structured results. Never infer success after an error.

Six valid utility requests

Each block contains the MCP tool name and its arguments object. The live schema remains authoritative.

1. `everyday_calculate`

Scale exact recipe quantities while preserving the instructions.

{
  "name": "everyday_calculate",
  "arguments": {
    "request": {
      "action": "recipe_scale",
      "fromServings": "4",
      "toServings": "7",
      "ingredients": [
        {
          "name": "flour",
          "quantity": "1 1/3",
          "unit": "US_cup"
        }
      ],
      "instructions": "Bake at 350°F for 20 minutes."
    }
  }
}

2. `everyday_calculate`

Merge compatible shopping quantities with explicit regional units.

{
  "name": "everyday_calculate",
  "arguments": {
    "request": {
      "action": "shopping_merge",
      "ingredients": [
        {
          "name": "flour",
          "quantity": "1 1/3",
          "unit": "US_cup"
        },
        {
          "name": " Flour ",
          "quantity": "2/3",
          "unit": "US_cup"
        }
      ]
    }
  }
}

3. `everyday_calculate`

Split itemized amounts, tax, and tip with exact minor-unit accounting.

{
  "name": "everyday_calculate",
  "arguments": {
    "request": {
      "action": "bill_split",
      "participants": [
        {
          "id": "a"
        },
        {
          "id": "b"
        }
      ],
      "items": [
        {
          "label": "Shared dish",
          "amount": "10.00",
          "sharedBy": [
            "a",
            "b"
          ]
        }
      ],
      "taxRatePercent": "8.25",
      "tipRatePercent": "20",
      "tipBase": "subtotal"
    }
  }
}

4. `text_transform`

Convert bounded SRT subtitle text to WebVTT.

{
  "name": "text_transform",
  "arguments": {
    "request": {
      "action": "subtitle_convert",
      "source": "srt",
      "target": "vtt",
      "text": "1\n00:00:01,000 --> 00:00:02,000\nMeet outside.\n"
    }
  }
}

5. `text_transform`

Shift WebVTT cue times by an integer number of milliseconds.

{
  "name": "text_transform",
  "arguments": {
    "request": {
      "action": "subtitle_shift",
      "source": "vtt",
      "text": "WEBVTT\n\n00:01.000 --> 00:02.000\nMeet outside.\n",
      "offsetMilliseconds": 1250
    }
  }
}

6. `text_transform`

Extract plain dialogue while preserving spoken dates and numbers.

{
  "name": "text_transform",
  "arguments": {
    "request": {
      "action": "subtitle_transcript",
      "source": "vtt",
      "text": "WEBVTT\n\n00:01.000 --> 00:02.000\nMeet at 12:30 in 2026.\n"
    }
  }
}

Discover calculators without loading every parameter schema

Use everyday_calculate action catalog with a search query, then describe with a returned calculator ID, then calculate with its validated parameters. Read the directory of 67 calculators. These three actions are standard MCP tool calls and require no additional protocol extension. The original direct recipe, shopping merge and bill-split actions retain their schemas.

{"name":"everyday_calculate","arguments":{"request":{"action":"catalog","query":"fuel"}}}
{"name":"everyday_calculate","arguments":{"request":{"action":"describe","calculator":"travel.fuel_cost"}}}

The description supplies inputSchema, example parameters and method sources. Calculation results contain values, units and assumptions. Decimal-string money, regional unit names and explicit fee/rate inputs prevent ambiguous interpretation. Random selection operations are non-deterministic. Individual schemas and result limits remain authoritative.

Send feedback or request a feature

When the user wants to contact the Everyday MCP maintainers, call ask_for. Set kind to feedback, feature_request, or bug_report, with a title up to 160 characters and a message up to 4,000 characters. No login or contact details are required.

{
  "name": "ask_for",
  "arguments": {
    "request": {
      "kind": "feature_request",
      "title": "Compare grocery package sizes",
      "message": "Please add a tool to compare unit prices for packages with different weights."
    }
  }
}

The result includes status: received and a receipt ID. The full message is stored for maintainer review until removed; submissions are not publicly listed. The receipt confirms receipt of the request, without promising a response or implementation.

Selection rules

Use everyday_calculate for the calculator directory, exact recipe scaling, compatible shopping-unit merging, and itemized bill splits. Calculator-specific fields are discovered through describe.
Use calendar to discover holiday jurisdictions before requesting holidays. ICS generation and parsing handle a documented bounded subset; calls do not write a personal calendar.
Use IANA zones and timestamps with explicit offsets for time operations. Choose seconds or milliseconds explicitly for epoch conversion.
Keep a timer ID and capability together. Put the capability only in MCP tool arguments, never in a URL or log. There is no global timer list or credential recovery.
Use explicit regional units such as US_gal or Imperial_gal, and explicit data units such as GB or GiB.
Text and data utilities process supplied content. URL, HTML, sitemap, and sharing-link operations do not fetch remote pages.

Version, events, and limits

Everyday MCP version 0.2.0 targets MCP 2026-07-28 and retains legacy 2025-series compatibility. Actual compatibility depends on the negotiated host handshake.

timer.fired follows the experimental Events proposal. Check advertised capabilities. Polling, push delivery, background wake-up, and user notification depend on the host.

The server accepts HTTP request bodies up to 1 MiB, limits each observed network peer IP to 120 requests per minute and four concurrent MCP requests, and applies tighter per-tool schema limits. A configured trusted proxy supplies the peer IP; shared network addresses can aggregate several end users. Examples include 100 KiB for most text operations, 200 KiB and 2,000 cues for subtitles, and a 366-day holiday range. Read the live schema before every call.

Source boundaries

Holiday discovery uses date-holidays 3.37.0 under its published license terms. Coverage varies by jurisdiction and release; China results do not represent annual adjusted working-day schedules.

Unit conversion uses fixed definitions documented in the returned source metadata. Recipe quantities use exact rational arithmetic. Bill splits use integer minor units and disclosed rounding/allocation rules. Subtitle, ICS, structured-data, codec, and text operations disclose unsupported input or transformation loss through errors and notes.

Discovery documents

llms.txt and this guide are supplementary documents. They do not replace MCP discovery or host installation approval.