Everyday MCP · Agent guide · Resources · Calculator index JSON

Everyday MCP calculator directory

It isn’t for humans. It’s for agents.

Connect first

MCP Streamable HTTP endpoint:

https://everyday.alfie.family/mcp

Authentication: none. Status: Public remote endpoint configured.

The existing everyday_calculate tool exposes 67 calculators through three ordinary MCP tool actions. The server still has 14 top-level tools. Calculation inputs are processed remotely without saving a personal history.

  1. Call everyday_calculate with {"request":{"action":"catalog","query":"energy"}}. Results are paginated; use the returned nextOffset.
  2. Call it with {"request":{"action":"describe","calculator":"home.energy_cost"}} to read that calculator's exact input schema, example, assumptions and sources.
  3. Call it with action: calculate, the same calculator ID, and the validated example or user-supplied values in parameters. The executable example below is generated from that calculator's descriptor.
{
  "name": "everyday_calculate",
  "arguments": {
    "request": {
      "action": "calculate",
      "calculator": "home.energy_cost",
      "parameters": {
        "appliances": [
          {
            "label": "Fan",
            "watts": 50,
            "hoursPerDay": 8,
            "dutyCyclePercent": 75,
            "days": 30
          }
        ],
        "pricePerKWh": "0.20",
        "currency": "USD"
      }
    }
  }
}

Parameters are limited to 200 KiB and results to 512 KiB. Each input schema applies smaller limits. Results include values, units and assumptions. Monetary inputs use decimal strings where specified. Supply actual rates, grading rules and measurements; calculations do not fetch prices, make payments or apply local legal rules. Random selection is explicitly marked non-deterministic.

Existing direct actions recipe_scale, shopping_merge and bill_split remain available through their original schemas.

All 67 calculators

Moon phase and illumination

astronomy.moon_phase

Compute the Moon illuminated fraction and phase at a supplied timestamp with explicit offset.

Exact input schema, example and method sources

Moonrise, moonset and transit

astronomy.moon_times

Compute lunar rise, set and transit events within an explicit local civil day; absent events remain empty arrays.

Exact input schema, example and method sources

Sunrise, sunset and twilight

astronomy.sun_times

Compute local civil-day sunlight events from an explicit date, IANA zone and coordinates, including DST and missing polar events.

Exact input schema, example and method sources

Exact integer base conversion

code.base_convert

Convert signed integer strings between bases 2 through 36 without losing large integer digits.

Exact input schema, example and method sources

Basic Braille alphabet

code.braille

Encode or decode uncontracted English letters and whitespace with a per-letter capital indicator.

Exact input schema, example and method sources

Caesar and ROT13 encoding

code.caesar

Shift ASCII letters while preserving case, punctuation and other Unicode text.

Exact input schema, example and method sources

Check-digit validation and completion

code.check_digits

Validate or append Luhn, ISBN-10, ISBN-13, EAN-13 or UPC-A check digits.

Exact input schema, example and method sources

Roman numerals

code.roman

Convert canonical Roman numerals and integers from 1 through 3999.

Exact input schema, example and method sources

Vigenere encoding and decoding

code.vigenere

Apply a repeated ASCII alphabetic key; advance the key on letters only.

Exact input schema, example and method sources

WCAG text contrast ratio

color.contrast

Compute opaque sRGB foreground/background contrast and AA/AAA text thresholds.

Exact input schema, example and method sources

HEX, RGB and HSL color conversion

color.convert

Convert opaque sRGB colors among hexadecimal, integer RGB and HSL values.

Exact input schema, example and method sources

Fill volume

construction.fill_volume

Calculates rectangular or cylindrical fill volume, waste allowance, and optional whole bags.

Exact input schema, example and method sources

Flooring packs

construction.flooring

Calculates floor area, waste allowance, and whole packs.

Exact input schema, example and method sources

Paint quantity

construction.paint

Calculates net wall area, coats, waste allowance, and whole paint cans.

Exact input schema, example and method sources

Wallpaper rolls

construction.wallpaper

Calculates strips and rolls for equal-height rectangular walls with optional pattern-repeat cutting.

Exact input schema, example and method sources

Baker's percentages

cooking.bakers_percent

Converts ingredient masses and baker percentages relative to a flour mass.

Exact input schema, example and method sources

Batch plan

cooking.batch_plan

Calculates whole batches and elapsed processing time with parallel slots.

Exact input schema, example and method sources

Dilution calculator

cooking.dilution

Uses C1V1 = C2V2 to calculate concentrate and zero-concentration diluent volumes.

Exact input schema, example and method sources

Pan volume scale

cooking.pan_scale

Calculates a recipe scale factor from old and new pan volume, depth, and pan counts.

Exact input schema, example and method sources

Data transfer time

data.transfer_time

Calculates transfer duration from an explicit bit/byte SI or IEC size, bit-rate unit, and efficiency.

Exact input schema, example and method sources

Curtain fabric

dimensions.curtains

Calculates full-width curtain drops and total fabric length from fullness and hems.

Exact input schema, example and method sources

Paper dimensions and weight

dimensions.paper

Returns ISO A/B or custom sheet dimensions and computes weight from gsm and sheet count.

Exact input schema, example and method sources

Screen dimensions

dimensions.screen

Derives screen width and height from diagonal and aspect ratio, with optional pixel density.

Exact input schema, example and method sources

Tablecloth size

dimensions.tablecloth

Calculates the minimum rectangular or round cloth size for a user-supplied drop.

Exact input schema, example and method sources

Credit-weighted GPA

education.gpa

Calculates GPA from user-supplied credits and grade points without imposing a grading scale.

Exact input schema, example and method sources

Target grade

education.target_grade

Solves for the score needed in a remaining weighted component to reach a target grade.

Exact input schema, example and method sources

Weighted grade

education.weighted_grade

Calculates a normalized weighted grade while reporting original and normalized weights.

Exact input schema, example and method sources

Calculate break-even units

finance.break_even

Calculates contribution margin and the whole units required to cover fixed costs.

Exact input schema, example and method sources

Project compound growth

finance.compound_growth

Projects a principal with nominal annual interest and a fixed contribution each compounding period.

Exact input schema, example and method sources

Compare extra loan payments

finance.extra_payment_compare

Compares the same fixed-rate loan with and without a recurring extra monthly principal payment.

Exact input schema, example and method sources

Build a loan amortization schedule

finance.loan_amortization

Builds a fixed-rate monthly principal-and-interest schedule with optional extra principal payments.

Exact input schema, example and method sources

Calculate percent change

finance.percent_change

Calculates absolute and percentage change relative to a non-zero starting value.

Exact input schema, example and method sources

Convert gross salary rates

finance.salary_convert

Converts a gross hourly, weekly, monthly, or annual rate using explicit work hours and work weeks.

Exact input schema, example and method sources

Calculate the monthly savings contribution

finance.savings_contribution

Solves for a fixed monthly contribution that reaches a target after a fixed number of months.

Exact input schema, example and method sources

Estimate months to a savings goal

finance.savings_goal

Finds the first month a fixed monthly contribution and nominal annual rate reach a target.

Exact input schema, example and method sources

Compare subscription plans

finance.subscription_compare

Compares fixed upfront and recurring plan charges over a user-provided time horizon.

Exact input schema, example and method sources

Add or extract VAT

finance.vat

Converts between tax-exclusive and tax-inclusive amounts using a user-provided VAT rate.

Exact input schema, example and method sources

Shape area and volume

geometry.shape

Calculates area for 2D shapes and surface area plus volume for 3D solids.

Exact input schema, example and method sources

Appliance payback

home.appliance_payback

Compares an incremental purchase cost with the annual operating-cost reduction.

Exact input schema, example and method sources

Appliance energy cost

home.energy_cost

Estimates electricity consumption and cost from appliance power, runtime, duty cycle, and days.

Exact input schema, example and method sources

Time-of-use electricity cost

home.time_of_use

Totals user-supplied energy usage and rates by billing period plus a fixed fee.

Exact input schema, example and method sources

Exact combinations and permutations

math.combinations

Count ordered or unordered selections, with or without replacement, as exact integer strings.

Exact input schema, example and method sources

Bounded decimal arithmetic

math.evaluate

Evaluate decimal arithmetic with parentheses, +, -, *, / and bounded integer powers; no code, variables or functions.

Exact input schema, example and method sources

Fraction arithmetic

math.fractions

Performs exact bounded rational arithmetic on integers, fractions, decimals, or mixed fractions.

Exact input schema, example and method sources

Percentage

math.percentage

Solves explicitly for percent, part, or whole.

Exact input schema, example and method sources

Ratio allocation

math.ratio

Allocates an exact rational or decimal total in proportion to explicit shares.

Exact input schema, example and method sources

Decimal rounding

math.round

Rounds a plain decimal to decimal places or significant digits with an explicit mode.

Exact input schema, example and method sources

Descriptive statistics

math.statistics

Calculates descriptive statistics and R-7 linear-interpolation percentiles.

Exact input schema, example and method sources

Weighted mean

math.weighted_mean

Calculates a weighted mean, allowing zero-weight observations.

Exact input schema, example and method sources

Playback time

planning.playback

Calculates actual viewing or listening time for multiple media segments and playback speeds.

Exact input schema, example and method sources

Supply runout

planning.supply_runout

Calculates complete days of supply and the calendar date on which the supply is exhausted.

Exact input schema, example and method sources

Task batch schedule

planning.task_batches

Schedules fixed-duration batches with bounded parallelism and one-time or per-batch setup.

Exact input schema, example and method sources

Random sample

random.sample

Draws a cryptographically sourced random sample, with or without replacement.

Exact input schema, example and method sources · Uses cryptographic randomness.

Random teams

random.teams

Randomly shuffles named participants into balanced teams.

Exact input schema, example and method sources · Uses cryptographic randomness.

Calculate checkout total

shopping.checkout

Applies sequential order discounts, a fixed coupon, tax, and conditional shipping in a declared order.

Exact input schema, example and method sources

Find the least-cost package plan

shopping.purchase_plan

Uses bounded dynamic programming to cover an integer target quantity at minimum total package cost.

Exact input schema, example and method sources

Compare unit prices

shopping.unit_price

Normalizes compatible mass, volume, or count packages and sorts them by price per base unit.

Exact input schema, example and method sources

Pace and finish time

sports.pace

Calculates pace from distance and elapsed time, or elapsed time from distance and pace.

Exact input schema, example and method sources

Race splits

sports.race_splits

Builds constant-pace distance splits, including a shorter final split, from pace or target time.

Exact input schema, example and method sources

Commute cost comparison

travel.commute_compare

Compares user-supplied distance, per-distance, per-trip, and fixed costs across commute modes.

Exact input schema, example and method sources

EV charge estimate

travel.ev_charge

Estimates battery energy, wall energy, charging time, and electricity cost for a constant-power charge.

Exact input schema, example and method sources

Trip fuel cost

travel.fuel_cost

Estimates trip fuel, fuel cost, optional parking, and an equal per-person split.

Exact input schema, example and method sources

Fuel economy conversion

travel.fuel_economy

Converts between L/100 km, US mpg, and Imperial mpg with the reciprocal relationship preserved.

Exact input schema, example and method sources

Ticket purchase plan

travel.ticket_plan

Finds the least-cost combination of user-supplied ticket products that covers a target number of rides.

Exact input schema, example and method sources

Compound and additional units

units.compound

Convert angle, density, volume flow, frequency or data rate with explicit regional and SI/IEC unit names.

Exact input schema, example and method sources

Mixed feet, inches and metric lengths

units.mixed_length

Add or subtract explicit length strings, including fractional feet/inches, and normalize to metric and fractional inches.

Exact input schema, example and method sources

Timesheet totals

work.timesheet

Totals non-overlapping RFC 3339 work intervals using elapsed instants, with optional display zone and pay inputs.

Exact input schema, example and method sources