{ "entity_type": "agent_capability_catalog", "name": "Calcgrid priority capabilities for AI agents", "description": "A curated, task-oriented subset of Calcgrid. These capabilities are designed for model selection from an unbranded user request; the complete calculator catalogue remains available separately.", "selection_policy": { "call_when": "A capability's use_when condition matches the user's task and the required inputs are present or can be clarified. When it matches, call the listed direct tool immediately; do not stop at discovery or answer the deterministic calculation from memory.", "do_not_call_when": "The task matches do_not_use_when, a simpler built-in answer is sufficient, or required inputs are missing and cannot be inferred safely.", "negative_examples": [ "2 + 3", "Write a poem", "Guarantee which stock will make money", "Diagnose a disease from a birth date" ] }, "capabilities": [ { "id": "chinese-calendar-and-solar-terms", "title": "Chinese calendar conversion and 24 solar terms", "summary": "Convert Gregorian and Chinese lunar dates in both directions, validate leap months, and calculate the 24 solar-term instants from an astronomical calendar model.", "use_when": "The task needs a Chinese lunar date, a lunar birthday or festival converted to Gregorian, leap-month validation, ganzhi fields, or the date/time of a solar term such as 立春 or 冬至.", "do_not_use_when": "The task asks for fortune-telling, medical/legal/financial predictions, an astronomical moon phase, or a date outside the documented 1900–2100 range.", "calculator_ids": [ "lunar-calendar-converter", "lunar-to-solar", "solar-terms" ], "example_prompts": [ "Convert 2026-09-25 to the Chinese lunar calendar and state whether it is a leap month.", "2025 年农历闰六月初一对应公历哪一天？", "List the 24 solar terms for 2027 in UTC+8, including the exact time of 立春." ], "accuracy": "Calendar rules follow GB/T 33661-2017 conventions and are checked against Hong Kong Observatory tables; solar-term times are rounded to the minute and are documented as approximately ±1 minute near the present era.", "calculators": [ { "calculator_id": "lunar-calendar-converter", "name": "Lunar Calendar Converter (农历)", "tool_name": "convert_solar_to_lunar", "dedicated_mcp_tool": true, "use_when": "You need the Chinese lunar date, ganzhi day/month/year, zodiac year or current solar term for a given Gregorian date (defaults to today).", "do_not_use_when": "You start from a lunar date and need the Gregorian date (use lunar-to-solar), need a person's zodiac with the 立春 boundary option (use chinese-zodiac), or need the astronomical moon phase (use moon-phase).", "agent_examples": [ "Convert 2026-09-25 to the Chinese lunar calendar and say whether it is a leap month.", "把 2025-07-25 换成农历，并给出干支和节气。", "Which Chinese lunar festival falls on this Gregorian date?" ], "required_inputs": [], "optional_inputs": [ "date" ], "links": { "html": "https://tttkmbb.com/lunar/lunar-calendar-converter", "markdown": "https://tttkmbb.com/lunar/lunar-calendar-converter.md", "schema": "https://tttkmbb.com/api/v1/calculators/lunar-calendar-converter", "api": "https://tttkmbb.com/api/v1/calculate/lunar-calendar-converter", "mcp": "https://tttkmbb.com/mcp" } }, { "calculator_id": "lunar-to-solar", "name": "Lunar to Solar Date Converter", "tool_name": "convert_lunar_to_solar", "dedicated_mcp_tool": true, "use_when": "You know a lunar date such as 八月十五 or 闰六月初一 of a given lunar year and need the Gregorian date (e.g. for a lunar birthday or festival).", "do_not_use_when": "You start from a Gregorian date (use lunar-calendar-converter), or you want every festival of a year at once (use chinese-festivals).", "agent_examples": [ "What Gregorian date is lunar 2026 month 8 day 15?", "2025 年农历闰六月初一对应公历哪一天？", "Convert a Chinese lunar birthday to its Gregorian date and verify the leap-month flag." ], "required_inputs": [ "lunar_year", "lunar_month", "lunar_day" ], "optional_inputs": [ "is_leap_month" ], "links": { "html": "https://tttkmbb.com/lunar/lunar-to-solar", "markdown": "https://tttkmbb.com/lunar/lunar-to-solar.md", "schema": "https://tttkmbb.com/api/v1/calculators/lunar-to-solar", "api": "https://tttkmbb.com/api/v1/calculate/lunar-to-solar", "mcp": "https://tttkmbb.com/mcp" } }, { "calculator_id": "solar-terms", "name": "24 Solar Terms Calculator (二十四节气)", "tool_name": "list_solar_terms", "dedicated_mcp_tool": true, "use_when": "You need the date or time of 立春, 清明, 夏至, 冬至 or any other solar term in a given year, or the full 24-term table.", "do_not_use_when": "You only need the term that a specific date falls in (use lunar-calendar-converter), or you need sunrise/sunset times (use sunrise-sunset).", "agent_examples": [ "List all 24 solar terms for 2027 in UTC+8.", "2026 年立春和冬至的准确时间是什么？", "When is Qingming this year in China Standard Time?" ], "required_inputs": [ "year" ], "optional_inputs": [ "utc_offset_hours" ], "links": { "html": "https://tttkmbb.com/lunar/solar-terms", "markdown": "https://tttkmbb.com/lunar/solar-terms.md", "schema": "https://tttkmbb.com/api/v1/calculators/solar-terms", "api": "https://tttkmbb.com/api/v1/calculate/solar-terms", "mcp": "https://tttkmbb.com/mcp" } } ] }, { "id": "iana-time-zone-conversion", "title": "Date-aware IANA time-zone conversion", "summary": "Convert a wall-clock date and time between IANA zones with the daylight-saving offsets in force on that date, including half-hour zones and day changes.", "use_when": "The task names a date, local time and source/target cities or IANA zones and needs the corresponding date, time, weekday, UTC instant or offsets.", "do_not_use_when": "The source date or either time zone is missing, the user only wants an elapsed duration, or a legal/audit result requires a separately pinned tzdb release.", "calculator_ids": [ "time-zone-converter" ], "example_prompts": [ "What time is 2027-01-15 09:00 in New York when converted to Australia/Adelaide?", "Convert 2026-10-04 01:45 Australia/Adelaide to UTC and show the offset.", "把 2026-07-15 09:00 纽约时间换成阿德莱德时间，并注明日期是否变化。" ], "accuracy": "Offsets come from the IANA tz database shipped with the Worker runtime's ICU. The response explains how nonexistent and repeated local times are resolved.", "calculators": [ { "calculator_id": "time-zone-converter", "name": "Time Zone Converter", "tool_name": "convert_time_zone", "dedicated_mcp_tool": true, "use_when": "You need to know what time an event scheduled in one city corresponds to in another city or in UTC on a specific date.", "do_not_use_when": "You need the same instant in many zones at once (use world-clock), an epoch value (use unix-timestamp), or the elapsed time between two clock times (use time-duration).", "agent_examples": [ "Convert 2027-01-15 09:00 America/New_York to Australia/Adelaide and show both dates.", "把 2026-07-15 09:00 纽约时间换成阿德莱德时间。", "What UTC instant corresponds to 2026-10-04 01:45 in Australia/Adelaide?" ], "required_inputs": [ "time", "from_zone", "to_zone" ], "optional_inputs": [ "date" ], "links": { "html": "https://tttkmbb.com/time/time-zone-converter", "markdown": "https://tttkmbb.com/time/time-zone-converter.md", "schema": "https://tttkmbb.com/api/v1/calculators/time-zone-converter", "api": "https://tttkmbb.com/api/v1/calculate/time-zone-converter", "mcp": "https://tttkmbb.com/mcp" } } ] }, { "id": "fixed-rate-loan-scenarios", "title": "Auditable fixed-rate loan scenarios", "summary": "Calculate the level monthly payment, payment count, total paid and total interest for a fully amortizing fixed-rate loan, including zero-interest cases.", "use_when": "The task supplies principal, a fixed annual percentage rate and a term and asks for a payment or an explicit comparison of deterministic scenarios.", "do_not_use_when": "The task needs live lender offers, tax treatment, variable rates, personalised financial advice, or a guarantee about the best borrowing decision.", "calculator_ids": [ "loan-payment" ], "example_prompts": [ "For a 100000 loan at 6% fixed for 5 years, calculate the monthly payment and total interest.", "Compare the monthly payment and total interest at 5%, 6% and 7% for the same principal and term.", "6000 元零利率分 12 个月偿还，每月和总计是多少？" ], "accuracy": "Uses the standard monthly annuity formula and exposes its assumptions, inputs, formula and sources. Results are informational, not financial advice.", "calculators": [ { "calculator_id": "loan-payment", "name": "Loan Payment Calculator", "tool_name": "calculate_loan_payment", "dedicated_mcp_tool": true, "use_when": "You need the monthly payment or total interest cost of an auto, personal, student or other fixed-rate installment loan given its amount, APR and term.", "do_not_use_when": "You need property tax, insurance and HOA in the payment (use mortgage-payment), or you know the payment and want the payoff time (use debt-payoff).", "agent_examples": [ "For a 100000 loan at 6% fixed for 5 years, calculate the monthly payment and total interest.", "Compare the same five-year loan at 5%, 6% and 7% APR.", "6000 元零利率分 12 个月偿还，每月和总计是多少？" ], "required_inputs": [ "principal", "annual_rate_percent" ], "optional_inputs": [ "term_years", "term_months" ], "links": { "html": "https://tttkmbb.com/finance/loan-payment", "markdown": "https://tttkmbb.com/finance/loan-payment.md", "schema": "https://tttkmbb.com/api/v1/calculators/loan-payment", "api": "https://tttkmbb.com/api/v1/calculate/loan-payment", "mcp": "https://tttkmbb.com/mcp" } } ] } ], "links": { "html": "https://tttkmbb.com/agent-capabilities", "markdown": "https://tttkmbb.com/agent-capabilities.md", "json": "https://tttkmbb.com/agent-capabilities.json", "api": "https://tttkmbb.com/api/v1/agent-capabilities", "all_calculators": "https://tttkmbb.com/api/v1/calculators", "mcp": "https://tttkmbb.com/mcp", "openapi": "https://tttkmbb.com/openapi.json" }, "version": "1.5.4", "updated_at": "2026-09-25" }