Temporal Intelligence for AI Assistants
Open-source MCP server that gives your AI assistant rich time awareness. 200+ timezones, 9 cultural calendars, prayer times, and astronomical calculations.
Works with Claude Desktop, Continue, Cline, and any MCP-compatible client.
Complete Temporal Context
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
9 Cultural Calendars
Hebrew, Islamic, Chinese, Hindu, Persian, Buddhist, Bahá'í, Ethiopian, and Mayan calendars
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
┌─────────────────────────────────────────────────┐
│ Your AI Client (Claude Desktop / Continue) │
│ - Natural language queries │
│ - Contextual conversations │
└────────────────────┬────────────────────────────┘
│ MCP Protocol
▼
┌─────────────────────────────────────────────────┐
│ @vreme/temporal-mcp (This Package) │
│ - Query parsing │
│ - Response formatting │
└────────────────────┬────────────────────────────┘
│ HTTPS
▼
┌─────────────────────────────────────────────────┐
│ Vreme Time API (api.vreme.ai) │
│ - 200+ timezones (pytz) │
│ - 9 cultural calendars │
│ - Prayer time calculations │
│ - Astronomical computations │
│ - Stateless, horizontally scalable │
└─────────────────────────────────────────────────┘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.
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 9 cultural calendars: Hebrew, Islamic (Hijri), Chinese (Lunar), Hindu, Persian (Solar Hijri), Buddhist, Bahá'í, Ethiopian, and Mayan. This enables AI assistants to understand and respect cultural time contexts globally.
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 (9 calendars), religious observances (Ramadan, Shabbat), prayer times, astronomical events, and activity appropriateness. It's designed for AI assistants to understand time the way humans do - with context and nuance.