The Ultimate Temporal Intelligence System + Astrology
69 MCP tools for AI assistants. NEW v1.9.10: Calendar boundaries & ISO week intelligence. NEW v1.9.9: Time in timezone calculator. NEW v1.9.8: Business days calculator + nth occurrence finder. NEW v1.9.7: Weekday finder (next/previous/closest). NEW v1.9.6: Temporal pattern detection & frequency analysis. NEW v1.9.5: Historical date facts & projections. NEW v1.9.4: Date range operations. NEW v1.9.3: Timezone offset intelligence. NEW v1.9.2: Duration & period calculations. ASTROLOGY (Western zodiac signs, planet positions, aspects, Chinese zodiac cycles, sun ingresses, moon phases). PLUS: Time arithmetic, phrase resolution ('tomorrow evening'), temporal context snapshots, interval algebra, RRULE expansion, fuzzy/uncertain time, multi-calendar alignment, observance universe (awareness days, fun days, tech holidays). 32 cultural calendars, 247+ countries holidays, 5 financial markets. Astronomy-backed astrology as time structure.
Works with Claude Desktop, VS Code, Cursor, Continue, Cline, and any MCP-compatible client.
Complete Temporal Context
Western Zodiac Context
Planet positions in zodiac signs with aspects. Get Sun, Moon, Mercury, Venus, Mars positions. Detect conjunctions, oppositions, trines, squares, sextiles. Astronomy-backed using JPL ephemeris. 'What sign is the Sun in today?'
Chinese Zodiac Cycles
60-year cycle of 12 animals × 10 elements with yin/yang. Lunar year calculation with animal (Rat→Pig), element (Wood, Fire, Earth, Metal, Water), and polarity. 'What Chinese zodiac year is 2024?'
Astro Events
Sun ingresses (sign changes) and moon phases in time windows. Find when Sun enters Capricorn, next full moon, all new moons this month. Precise UTC times with local timezone conversion.
Astro Calendar
Calendar view of astro events in your timezone. Monthly/yearly views with local times. 'Show me all sun sign changes and moon phases for December 2024 in NYC'
Time Arithmetic Engine
Precise date/time math with business rules. Add/subtract days, business_days with regional holidays, set_time operations. Step-by-step execution trace with deterministic hashing.
Temporal Phrase Resolution
Natural language → concrete time windows. 'tomorrow evening', 'end of week', 'early next week' → start/end times with confidence scores. Context-aware for planning vs casual conversation.
Multi-LLM Context Snapshots
Export portable temporal context for sharing between Claude, GPT-4, Gemini. TemporalContextSnapshotV1 schema with calendars, events, rhythm fingerprint. Generate LLM-ready prompt prefixes.
Activity Timing Intelligence
'Is now good for deep work?' Returns yes/no, score (0-1), reasons, alternatives. Considers time of day, bedtime, upcoming events, historical patterns. Activities: deep_work, financial_decision, hard_feedback, creative_play, exercise.
Global Sacred Time Analysis
Multi-region sacred time for product launches, webinars, maintenance. Avoid windows (Ramadan, holidays), preferred windows. 'When to launch in US/SA/IN/ID?' 7×24 sacred rhythm heatmap for multicultural teams.
Microseasons Context
Seasonal micro-context for location/date. Microseason ID/name, day length, sunrise/sunset, hemisphere-aware seasonal classification, suggested tone for content.
Time Scale Conversions
Convert between UNIX_SECONDS, UNIX_MILLIS, UTC_ISO, LOCAL_ISO (TAI, GPS planned). Explicit timezone handling, batch conversion support. 'Convert Unix 1733700000 to NYC time'
Interval Algebra
Set operations on time intervals: UNION (merge), INTERSECTION (overlap), DIFFERENCE (subtract), GAPS (find gaps). Handles overlapping/adjacent intervals with normalized output.
RRULE Expansion
RFC 5545 compliant recurrence evaluation. Expand RRULE to concrete occurrences within window. 'Find all Mondays in January', 'When does this meeting repeat?' Safety limit: 1000 max.
Multi-Calendar Alignment
Show single instant across multiple calendar systems. Gregorian, Unix, ISO Week, Ordinal (more planned: Islamic, Hebrew, Chinese). 'What is Dec 9, 2025 in Islamic calendar?'
Partial Date Matching
Find dates matching partial specification. Search by year/month/day constraints. 'Find all September 1st dates from 2020-2030', 'When is first Monday of September?'
Phase A: Fuzzy/Uncertain Time
Represent uncertainty explicitly with window + confidence. Circa dates ('circa 1990'), custom windows for flexible scheduling. Intersection of fuzzy times with refined confidence.
Phase B: Observance Intelligence
Get awareness days, fun days, tech holidays on any date. Categories: awareness_day, fun_day, tech, seasonal. Scope filtering (global, country), importance scoring (0-1), tag-based search.
Phase B: Today's Story
Curated highlights with relevance scoring. Combines importance + scope match + tag overlap. Returns 1-3 most relevant observances for user's region and interests.
Phase B: Observance Calendar
Month-wide observance planning. Find all awareness days in June for Pride Month content planning. Tech holidays for developer marketing. Health awareness days for campaigns.
Natural Language Queries
Ask naturally: 'What time is it in Tokyo?', 'Is it Ramadan?', 'When is sunset in Paris?'
200+ Timezones
Full pytz timezone support with automatic DST handling and UTC offset calculations
32 Cultural Calendars
Hebrew, Islamic, Chinese, Hindu, Persian, Buddhist, Coptic, Sikh, Orthodox, Thai Buddhist, Tibetan, Armenian, Japanese, Bengali, Tamil, Nepali, Ethiopian, Bahá'í, Mayan, French Revolutionary, Discordian, Holocene, Unix Epoch, ISO Week, Revised Julian, Zoroastrian, Mongolian, Burmese, Javanese, Western Zodiac, Star Trek Stardate, and more
247+ Countries Holiday Database
Comprehensive holiday data with PUBLIC/BANK/SCHOOL/OPTIONAL categories plus 5 financial markets trading holidays (NYSE, NSE India, Brazil B3, ECB, ICE Futures)
Islamic Prayer Times
All 5 daily prayers (Fajr, Dhuhr, Asr, Maghrib, Isha) with Qibla direction for any location
Religious Observances
Detects Ramadan, Yom Kippur, Shabbat, and other religious fasting/work restrictions
Astronomical Calculations
Sunrise, sunset, twilight times, moon phases, and solar position calculations
Activity Appropriateness
Smart recommendations for calls, meetings, and work based on time and cultural context
Stateless & Fast
Pure computation, no database, instant responses. Scales horizontally.
Real-World Use Cases
See how developers use Vreme MCP to build time-aware AI assistants
Global Team Coordination
Religious Observance
Cultural Awareness
Travel Planning
Compatible Clients
Works with any Model Context Protocol compatible client
Why Use an MCP Server?
Model Context Protocol (MCP) is Anthropic's open standard for connecting AI assistants to external data sources and tools. Instead of building custom integrations for every AI client, you build once and it works everywhere.
Vreme's MCP server gives your AI assistant temporal intelligence - the ability to understand time across cultures, timezones, and contexts. It's like giving your AI a sense of time.
Unlike web APIs that require manual query construction, MCP servers provide a natural language interface. Your AI can ask "Is it a good time to call Berlin?" and get a contextual answer considering business hours, cultural observances, and local time.
How It Works
Three simple steps from your question to intelligent temporal answers
You Ask a Question
User asks:
"What time is it in Tokyo?"
Your AI client (Claude Desktop, VS Code, Continue, etc.) receives your natural language query.
MCP Server Routes the Request
MCP server calls:
query_time(query="What time is it in Tokyo?")
The MCP server identifies which of 53 temporal tools to use and formats the request for the API.
Vreme API Computes the Answer
API returns structured data:
{
"current_time": "2024-12-20T15:30:00+09:00",
"timezone": "Asia/Tokyo",
"day_of_week": "Friday",
"sunrise": "06:45",
"sunset": "16:30",
"calendars": {
"gregorian": "December 20, 2024",
"hebrew": "19 Kislev 5785",
"islamic": "18 Jumada al-awwal 1446"
}
}The API performs calculations using 200+ timezones, 32 calendar systems, and 247+ countries' holiday data. All computation happens in real-time - no database queries.
You Get a Rich Answer
AI responds:
"It's currently 3:30 PM JST (Japan Standard Time) in Tokyo on Friday, December 20, 2024. In the Hebrew calendar, it's 19 Kislev 5785. Sunrise was at 6:45 AM and sunset will be at 4:30 PM."
Your AI assistant receives structured temporal data and formats it into a natural, contextual response with cultural and astronomical context.
Architecture
AI Client
Claude Desktop, VS Code, Cursor, Continue, Cline, and more. You interact naturally with your AI assistant.
MCP Server
Routes queries to the right tool, handles MCP protocol communication, and formats responses.
Vreme API
Performs all temporal calculations: timezones, calendars, holidays, astronomy, prayer times. Stateless and fast.
Why This Architecture?
- ✓Stateless: No database, pure computation. Every request is independent.
- ✓Fast: Sub-100ms response times for most queries.
- ✓Scalable: Horizontal scaling with no shared state.
- ✓Open Source: MIT licensed. Fork it, extend it, self-host it.
What You Get
- ✓53 Specialized Tools: Each optimized for specific temporal queries.
- ✓Structured Data: JSON responses only - your AI formats as needed.
- ✓Global Coverage: 247+ countries, 32 calendars, 5+ billion people.
- ✓Cultural Intelligence: Religious observances, prayer times, cultural calendars.
Frequently Asked Questions
What is a Model Context Protocol (MCP) server?
A Model Context Protocol server is a standardized way to give AI assistants access to external data and tools. Developed by Anthropic, MCP allows AI clients like Claude Desktop to query specialized services (like Vreme's time intelligence) using natural language.
Which AI clients support Vreme MCP server?
Vreme MCP server works with Claude Desktop, Continue, Cline, and any MCP-compatible AI client. If your AI client supports the Model Context Protocol, it supports Vreme.
What cultural calendars does Vreme support?
Vreme supports 31 cultural calendars including: Hebrew, Islamic (Hijri), Chinese (Lunar), Hindu, Persian (Solar Hijri), Buddhist, Coptic, Sikh, Orthodox Christian, Thai Buddhist, Tibetan, Armenian, Japanese, Bengali, Tamil, Nepali, Ethiopian, Bahá'í, Mayan, Roman, French Revolutionary, Discordian, Holocene, Unix Epoch, ISO Week Date, Revised Julian, Zoroastrian, Mongolian, Burmese, Javanese, Western Zodiac, and Star Trek Stardate. This enables AI assistants to understand and respect cultural time contexts globally across diverse civilizations.
How accurate are the Islamic prayer times?
Vreme calculates prayer times using astronomical algorithms based on location coordinates. It provides all 5 daily prayers (Fajr, Dhuhr, Asr, Maghrib, Isha) plus Qibla direction. Accuracy depends on precise location data.
Is Vreme MCP server free and open source?
Yes! Vreme MCP server is MIT licensed and completely free. The source code is available on GitHub. You can use it commercially, modify it, or self-host it without restrictions.
How do I install Vreme MCP server?
Install via npm: npm install -g @vreme/temporal-mcp. Then add it to your AI client's MCP configuration file and restart. Full installation guide available in our documentation.
Can I self-host the Vreme API backend?
Yes! The Python FastAPI backend is open source and available in our GitHub repository. You can deploy it to your own infrastructure and point the MCP server to your instance using the VREME_API_URL environment variable.
What makes Vreme different from other time APIs?
Vreme provides temporal intelligence, not just time conversion. It understands cultural contexts (31 calendars across all major civilizations), religious observances (Ramadan, Shabbat, Diwali, etc.), 247+ countries' holiday data with category filtering, 5 financial markets' trading holidays, prayer times, astronomical events, business time calculations, temporal density scoring, and activity appropriateness. It's designed for AI assistants to understand time the way humans do - with context, cultural awareness, and nuance.