FestivalFinder

io.github.everyai-comv1.0.0Updated Oct 1, 2026

Computed Hindu festival dates: Diwali, Holi, Navratri, more.

VerifiedStreamable HTTPWeb executableLocation & Lifestyle

Overview

AI-generated overview

Provides computed Hindu festival dates such as Diwali, Holi and Navratri through a remote MCP endpoint.

What it does
FestivalFinder is a remote, streamable HTTP MCP server that supplies computed Hindu festival dates, including Diwali, Holi and Navratri. The registry description is brief and the accompanying README describes a broader South Indian Jyotish research workspace with chart, Panchanga, Muhurta, compatibility and Lal Kitab tools, so the exact tool list is not fully documented. No tools are listed in the manifest.
When to use it
Use it when an assistant needs Hindu festival or calendar dates, or related Jyotish calculations, without running a local package. It is a hosted endpoint, so it suits clients that can connect to a remote MCP URL.
Requirements
A remote MCP client that supports streamable HTTP, connecting to the provider's hosted endpoint. No packages, environment variables or headers are declared. The README mentions optional scoped Bearer keys for metering and vault integration, and rate limits on public calls.
Before you install
The README states that public calls are rate-limited and that optional scoped Bearer keys provide metering and vault integration, so a key may be requested. It also notes that unreviewed personalized output is withheld and that retrieved text is treated as untrusted data. The README describes the project as a research preview, so outputs should not be treated as validated predictions.

Installation

In SourceWeft

  1. Open FestivalFinder in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "festival-finder": {
      "type": "http",
      "url": "https://festival-finder.magicteams.ai/mcp"
    }
  }
}

README

Sahadeva

[CI]

A clean-room, Cloudflare-native research build for a transparent South Indian AI Jyotish workspace.

Run locally

bash
npm installnpm run dev

The Cloudflare Vite plugin serves the React application and Worker API together. POST /api/chart is deterministic. POST /api/interpret uses the configured Workers AI binding.

AI narration

Narration uses only Cloudflare's native AI binding and Cloudflare-hosted @cf/... models. The default is @cf/zai-org/glm-5.3-flash; AI_MODEL selects it in wrangler.jsonc, and non-@cf/ model names are rejected in favor of that safe default. No AI Gateway, third-party API, or provider token participates in this path. GET /api/ai/status exposes only non-secret readiness metadata, and successful narration identifies the Cloudflare model while keeping calculated evidence immutable.

The consultation surface adds deterministic topic judgments, house exploration, natal Panchanga, convention comparison, Prashna, timing fusion, rectification, and depth endpoints. Topic judgments share one evidence-ledger engine across web, MCP, reports, and the Expo mobile client. Opt-in snapshots store versioned ledgers and a hashed follow-up secret—not names, places, or raw birth input—and calibration remains descriptive rather than predictive.

Connect through MCP

After deployment, compatible clients can connect to:

text
https://your-worker.example/mcp

The Streamable HTTP endpoint exposes a high-signal catalog led by a comprehensive first-reading dossier. The returned profile reference lets later consultations answer focused questions from the verified natal context without repeating the dossier. It also supports chart reports, Prashna, timing, separate North Indian Ashtakoota and South Indian ten-Porutham compatibility, Panchanga, Muhurta and visual reports. Specialist tools remain directly callable and are documented through an MCP resource. Chart calculation does not require a language model. Public calls are rate-limited; optional scoped Bearer keys provide metering and vault integration. See MCP integration examples.

Clients can call assess_prediction_readiness before interpretation to distinguish implemented calculation from reviewed rules and calibrated prediction. Lal Kitab currently provides source-linked structural inspection. All of its material is retained, including sensitive topics and remedies; reviewed claims can later use graduated caution-led disclosure, while unreviewed personalized output remains withheld. See Prediction quality and MCP gap audit.

The source-only analyze_lal_kitab workflow now converts natal placements to Lal Kitab fixed houses and returns locators for all relevant planet-house sections without publishing their unreviewed claims. The complete integration inventory is in Lal Kitab integration map.

The web chart surfaces the same fixed-house map, source locators, retained-sensitive-material caution, and an independent calculation-quality audit. MCP clients can use the lal_kitab_consultation prompt or compose the equivalent tools from the published workflow resource.

For evidence-first use across AI clients, the MCP now publishes sahadeva://prediction-quality and the evidence_first_prediction prompt. Reviewed-rule search, rights-aware passage discovery, separate-tradition comparison, per-claim auditing, versioned outcome capture and conservative validation reporting are available as typed tools. These improve traceability and abstention; they do not guarantee prediction accuracy or convert unreviewed traditions into validated knowledge.

The primary consultation also supports a compact cross-tradition whole-person profile and consent-aware remedy selection. Its security contract is published at sahadeva://security; production profile references are keyed opaque identifiers, restricted knowledge remains server-side, and retrieved text is explicitly untrusted data. See MCP AI orchestration and security.

Workers AI has a limited daily free allocation. Sahadeva therefore describes hosted narration as optional and allowance-backed, not unlimited free inference.

Verify

bash
npm run checknpm testnpm run buildnpm run test:e2enpm run migrations:verifynpm run mobile:verify

Current status

The product interface and computation pipeline are functional. The Moon, Panchanga transitions, and Lahiri convention have high-precision reference fixtures; the application remains a research preview until independent Lagna, solar-event, complete-strength, and practitioner certification gates are satisfied. See RESEARCH_AND_ARCHITECTURE.md for the calculation boundary, topology, and validation gates.

Clean-room boundary

No third-party astrology engine is bundled. Repository research informed the capability map and test strategy only. Production algorithms must be derived from documented specifications and independently validated.

Continuous integration

Pushes and pull requests run the verify pipeline on Flare Actions (flare.yml): typecheck, unit tests, migration and secret checks, audit, build, bundle budget, Playwright e2e, and the Expo mobile verify. Run completions email all registered users.

License

MIT — see LICENSE.

Source: README.md at commit a7d5243

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 1, 2026