Moon phase and illumination
astronomy.moon_phase
Compute the Moon illuminated fraction and phase at a supplied timestamp with explicit offset.
Everyday MCP · Agent guide · Resources · Calculator index JSON
It isn’t for humans. It’s for agents.
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.
everyday_calculate with {"request":{"action":"catalog","query":"energy"}}. Results are paginated; use the returned nextOffset.{"request":{"action":"describe","calculator":"home.energy_cost"}} to read that calculator's exact input schema, example, assumptions and sources.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.
astronomy.moon_phase
Compute the Moon illuminated fraction and phase at a supplied timestamp with explicit offset.
astronomy.moon_times
Compute lunar rise, set and transit events within an explicit local civil day; absent events remain empty arrays.
astronomy.sun_times
Compute local civil-day sunlight events from an explicit date, IANA zone and coordinates, including DST and missing polar events.
code.base_convert
Convert signed integer strings between bases 2 through 36 without losing large integer digits.
code.braille
Encode or decode uncontracted English letters and whitespace with a per-letter capital indicator.
code.caesar
Shift ASCII letters while preserving case, punctuation and other Unicode text.
code.check_digits
Validate or append Luhn, ISBN-10, ISBN-13, EAN-13 or UPC-A check digits.
code.roman
Convert canonical Roman numerals and integers from 1 through 3999.
code.vigenere
Apply a repeated ASCII alphabetic key; advance the key on letters only.
color.contrast
Compute opaque sRGB foreground/background contrast and AA/AAA text thresholds.
color.convert
Convert opaque sRGB colors among hexadecimal, integer RGB and HSL values.
construction.fill_volume
Calculates rectangular or cylindrical fill volume, waste allowance, and optional whole bags.
construction.flooring
Calculates floor area, waste allowance, and whole packs.
construction.paint
Calculates net wall area, coats, waste allowance, and whole paint cans.
construction.wallpaper
Calculates strips and rolls for equal-height rectangular walls with optional pattern-repeat cutting.
cooking.bakers_percent
Converts ingredient masses and baker percentages relative to a flour mass.
cooking.batch_plan
Calculates whole batches and elapsed processing time with parallel slots.
cooking.dilution
Uses C1V1 = C2V2 to calculate concentrate and zero-concentration diluent volumes.
cooking.pan_scale
Calculates a recipe scale factor from old and new pan volume, depth, and pan counts.
data.transfer_time
Calculates transfer duration from an explicit bit/byte SI or IEC size, bit-rate unit, and efficiency.
dimensions.curtains
Calculates full-width curtain drops and total fabric length from fullness and hems.
dimensions.paper
Returns ISO A/B or custom sheet dimensions and computes weight from gsm and sheet count.
dimensions.screen
Derives screen width and height from diagonal and aspect ratio, with optional pixel density.
dimensions.tablecloth
Calculates the minimum rectangular or round cloth size for a user-supplied drop.
education.gpa
Calculates GPA from user-supplied credits and grade points without imposing a grading scale.
education.target_grade
Solves for the score needed in a remaining weighted component to reach a target grade.
education.weighted_grade
Calculates a normalized weighted grade while reporting original and normalized weights.
finance.break_even
Calculates contribution margin and the whole units required to cover fixed costs.
finance.compound_growth
Projects a principal with nominal annual interest and a fixed contribution each compounding period.
finance.extra_payment_compare
Compares the same fixed-rate loan with and without a recurring extra monthly principal payment.
finance.loan_amortization
Builds a fixed-rate monthly principal-and-interest schedule with optional extra principal payments.
finance.percent_change
Calculates absolute and percentage change relative to a non-zero starting value.
finance.salary_convert
Converts a gross hourly, weekly, monthly, or annual rate using explicit work hours and work weeks.
finance.savings_contribution
Solves for a fixed monthly contribution that reaches a target after a fixed number of months.
finance.savings_goal
Finds the first month a fixed monthly contribution and nominal annual rate reach a target.
finance.subscription_compare
Compares fixed upfront and recurring plan charges over a user-provided time horizon.
finance.vat
Converts between tax-exclusive and tax-inclusive amounts using a user-provided VAT rate.
geometry.shape
Calculates area for 2D shapes and surface area plus volume for 3D solids.
home.appliance_payback
Compares an incremental purchase cost with the annual operating-cost reduction.
home.energy_cost
Estimates electricity consumption and cost from appliance power, runtime, duty cycle, and days.
home.time_of_use
Totals user-supplied energy usage and rates by billing period plus a fixed fee.
math.combinations
Count ordered or unordered selections, with or without replacement, as exact integer strings.
math.evaluate
Evaluate decimal arithmetic with parentheses, +, -, *, / and bounded integer powers; no code, variables or functions.
math.fractions
Performs exact bounded rational arithmetic on integers, fractions, decimals, or mixed fractions.
math.percentage
Solves explicitly for percent, part, or whole.
math.ratio
Allocates an exact rational or decimal total in proportion to explicit shares.
math.round
Rounds a plain decimal to decimal places or significant digits with an explicit mode.
math.statistics
Calculates descriptive statistics and R-7 linear-interpolation percentiles.
math.weighted_mean
Calculates a weighted mean, allowing zero-weight observations.
planning.playback
Calculates actual viewing or listening time for multiple media segments and playback speeds.
planning.supply_runout
Calculates complete days of supply and the calendar date on which the supply is exhausted.
planning.task_batches
Schedules fixed-duration batches with bounded parallelism and one-time or per-batch setup.
random.sample
Draws a cryptographically sourced random sample, with or without replacement.
Exact input schema, example and method sources · Uses cryptographic randomness.
random.teams
Randomly shuffles named participants into balanced teams.
Exact input schema, example and method sources · Uses cryptographic randomness.
shopping.checkout
Applies sequential order discounts, a fixed coupon, tax, and conditional shipping in a declared order.
shopping.purchase_plan
Uses bounded dynamic programming to cover an integer target quantity at minimum total package cost.
shopping.unit_price
Normalizes compatible mass, volume, or count packages and sorts them by price per base unit.
sports.pace
Calculates pace from distance and elapsed time, or elapsed time from distance and pace.
sports.race_splits
Builds constant-pace distance splits, including a shorter final split, from pace or target time.
travel.commute_compare
Compares user-supplied distance, per-distance, per-trip, and fixed costs across commute modes.
travel.ev_charge
Estimates battery energy, wall energy, charging time, and electricity cost for a constant-power charge.
travel.fuel_cost
Estimates trip fuel, fuel cost, optional parking, and an equal per-person split.
travel.fuel_economy
Converts between L/100 km, US mpg, and Imperial mpg with the reciprocal relationship preserved.
travel.ticket_plan
Finds the least-cost combination of user-supplied ticket products that covers a target number of rides.
units.compound
Convert angle, density, volume flow, frequency or data rate with explicit regional and SI/IEC unit names.
units.mixed_length
Add or subtract explicit length strings, including fractional feet/inches, and normalize to metric and fractional inches.
work.timesheet
Totals non-overlapping RFC 3339 work intervals using elapsed instants, with optional display zone and pay inputs.