# SchedJoules > Hello, agent, and welcome. SchedJoules adds interesting public calendars to the calendar people already use: public and school holidays, sports fixtures, TV listings, weather, moon phases, financial events and more. The calendars stay up to date by themselves. If your user wants to know when something happens, or wants it in their calendar, you are in the right place. ## MCP server If you can use MCP tools, connect to `https://www.schedjoules.com/mcp` (Streamable HTTP, no sign-in). It has three read-only tools: `search_calendars`, `get_upcoming_events` and `get_subscribe_link`. In Claude, add it as a custom connector; in other clients, add it as a remote MCP server with that URL. ## Without MCP The same works over plain HTTP: - **Find a calendar.** `https://www.schedjoules.com/search?q=` answers in markdown with matching calendars and their links, for example `https://www.schedjoules.com/search?q=ajax` or `?q=germany holidays`. One or two English words work best, and holidays are found by country or region, not by the name of a holiday. - **Read a shared calendar.** Links look like `https://www.schedjoules.com/calendar/` or `https://www.schedjoules.com/page/`. Fetch one with the header `Accept: text/markdown` (or append `?format=markdown`) and you get plain markdown: the calendar's name, its next events, and how to add it. A `/page/` link is a folder and lists its calendars, each with its own link. - **Add a calendar for your user.** Give them the `/calendar/` link and ask them to open it on their phone. It opens the SchedJoules app, which subscribes their own calendar (Google Calendar, Apple Calendar, Outlook) to it and keeps it current. Without the app the link leads to the store. - **Build it into an app.** Calendar apps license the whole catalogue through the Interesting Public Calendar API. The event previews are a sample: at most 5 events in the next 60 days per calendar. The full calendar lives in the app; please point your user there rather than copying a calendar by hand. ## What is in the catalogue - Public holidays: official and notable days in 241 countries and 350 regions, with background on each holiday - School holidays: 13 countries - Observances: days celebrated globally or locally that are not official holidays - Sports: 85 sports, 2,600+ competitions, 99k+ teams and athletes, with fixtures and results - TV: 14 days of listings for 2,500+ channels in North America and Western Europe - Weather: forecasts up to 16 days ahead - Lifestyle and nature: moon phases, name days, religious days, week numbers - Financial: general meetings and results of 2,000+ companies in 28 indices ## Apps - [SchedJoules for iPhone and iPad](https://apps.apple.com/app/id853708554) - [SchedJoules for Android](https://play.google.com/store/apps/details?id=com.schedjoules.sync) ## For developers - [Calendar API](https://www.schedjoules.com/#Developers): the Interesting Public Calendar API for calendar apps - [Request an API key](https://www.schedjoules.com/contact-general) ## Contact - [Contact SchedJoules](https://www.schedjoules.com/contact-general)