io.github.GoodTurnStudio/syncmycycle MCP Server

The MCP server io.github.GoodTurnStudio/syncmycycle provides information about a likely menstrual cycle phase for today and for the current week. It also includes food and workout ideas aligned with that cycle timing, based on the server’s description.

🛠️ Key Features

Determines a likely menstrual cycle phase for “today”
Determines a likely menstrual cycle phase for “this week”
Provides food ideas
Provides workout ideas

🚀 Use Cases

Planning daily activities based on menstrual cycle phase
Creating weekly routines using phase-specific food and workout ideas

⚡ Developer Benefits

Exposes cycle-phase context alongside related recommendations (food and workouts)

⚠️ Limitations

Scope is limited to “likely” cycle phase and associated food/workout ideas as described

{ "type": "object", "properties": { "last_period": { "type": "string", "format": "date", "description": "First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days." }, "cycle_length": { "type": "integer", "minimum": 20, "maximum": 45, "description": "Usual days from one period start to the next, 20 to 45. Default 28." }, "period_length": { "type": "integer", "minimum": 2, "maximum": 10, "description": "Usual days of bleeding, 2 to 10. Default 5." }, "date": { "type": "string", "format": "date", "description": "Day to ask about, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC." }, "diet": { "type": "string", "description": "Comma separated: vegetarian, vegan, pescatarian, halal. Food ideas are filtered to suit." }, "country": { "type": "string", "description": "Two-letter country code (UK is read as GB). Sets the kit links (US, GB and IE get local Amazon links) and the time zone for today. Default from the request." }, "tz": { "type": "string", "description": "The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places." }, "last_period_start": { "type": "string", "format": "date", "description": "Older name for last_period, kept for existing callers; last_period is the current name." } }, "required": [ "last_period" ], "additionalProperties": false }

{ "type": "object", "properties": { "last_period": { "type": "string", "format": "date", "description": "First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days." }, "cycle_length": { "type": "integer", "minimum": 20, "maximum": 45, "description": "Usual cycle length, 20 to 45. Default 28." }, "period_length": { "type": "integer", "minimum": 2, "maximum": 10, "description": "Usual days of bleeding, 2 to 10. Default 5." }, "date": { "type": "string", "format": "date", "description": "First day of the plan, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC." }, "days": { "type": "integer", "minimum": 1, "maximum": 35, "description": "How many days, a whole number from 1 to 35. Default 7." }, "diet": { "type": "string", "description": "Accepted for symmetry with get_todays_phase; the week view has no food list, so it has no effect here." }, "country": { "type": "string", "description": "Two-letter country code (UK is read as GB), used for the time zone of today." }, "tz": { "type": "string", "description": "The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places." }, "last_period_start": { "type": "string", "format": "date", "description": "Older name for last_period, kept for existing callers; last_period is the current name." } }, "required": [ "last_period" ], "additionalProperties": false }

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp

All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)

Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in

Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)

Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product

Slug

What it does

Mizan

mizan

Shariah screening of US stocks under four standards, halal alternatives, purification, zakat

Halal or Not

halalornot

Halal checks for food, ingredients, medicines, stocks, funds and crypto

Fare Deals

faredeals

Cheap flights from any city, and the cheapest days to fly

Cheapest Price

cheapestprice

The lowest current price for a product, checked live

Spin My Day

spinmyday

A whole day out in any city, matched to weather, mood and diet

Cancel My Sub

cancelmysub

How to cancel US and UK subscriptions, and what a card charge is

Lower My Bill

lowermybill

Call scripts and low-cost plans to lower household bills

Price Drop Back

pricedropback

Store price-adjustment rules, deadlines and a claim message

Find My Money

findmymoney

Official unclaimed money searches in the US and UK

Supplement Check

supplementcheck

Supplement labels and doses against official upper limits

Plate Pal

platepal

Calories and nutrition for foods, chain meals and barcodes

Plan My Workout

planmyworkout

Workout plans and how to do any exercise

Med Bill Check

medbillcheck

US medical bills against Medicare rates, with dispute letters

Appeal My Claim

appealmyclaim

US health insurance denials, rights, deadlines and appeal letters

Job Spotter

jobspotter

Current US and UK job listings

Sync My Cycle

syncmycycle

Likely cycle phase today, with food and workout ideas

Wardrobe Connect

wardrobeconnect

Clothes that match a description or a picture

Form Guide

formguide

Football form, fixtures, results and tables

Books Like This

bookslikethis

Books like one you enjoyed, and screen adaptations

Talmud Scroller

talmud

Daily Talmud with Daf Yomi, and tractates in English

Scroll the Gurbani

gurbani

Daily Gurbani with English, any Ang or shabad

Gita Scroller

gita

Daily Bhagavad Gita verses with English

Scroll the Lore

lore

Greek and Norse myth, Homer, Hesiod and the Poetic Edda

Stoic Scroller

stoics

Marcus Aurelius, Epictetus and Seneca

Bible Swipe

bible

Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.

worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.

servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Install

Tools (3)

get_todays_phaseget_week_aheadlist_phases

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://goodturn-mcp.pages.dev/syncmycycle/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "syncmycycle": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/syncmycycle/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

last_period	string	required	First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days.
cycle_length	integer	optional	Usual days from one period start to the next, 20 to 45. Default 28.
period_length	integer	optional	Usual days of bleeding, 2 to 10. Default 5.
date	string	optional	Day to ask about, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC.
diet	string	optional	Comma separated: vegetarian, vegan, pescatarian, halal. Food ideas are filtered to suit.
country	string	optional	Two-letter country code (UK is read as GB). Sets the kit links (US, GB and IE get local Amazon links) and the time zone for today. Default from the request.
tz	string	optional	The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places.
last_period_start	string	optional	Older name for last_period, kept for existing callers; last_period is the current name.