Ramayana Book MCP Server

io.github.svenkatreddyPublished by GitHub account svenkatreddyv0.1.0Updated Nov 2, 2026

Valmiki Ramayana verses: lookup, search and verse-of-the-day in 4 languages

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Serves Valmiki Ramayana verses for lookup, full-text search and a deterministic verse of the day in Sanskrit plus English, Hindi and Telugu translations.

What you can do
  • List the seven kandas with Sanskrit titles and chapter counts
  • Fetch a single verse by kanda, sarga and verse number, or every verse of one chapter
  • Search verses full-text across Sanskrit and English, Hindi and Telugu translations, with snippets
  • Get a deterministic verse of the day for any calendar date
  • Read a kandas resource with kanda, chapter and verse counts
When to use it
Useful when an assistant should quote, locate or search Ramayana verses with translations, for study, teaching, devotional reading or a daily-verse feature, without building a corpus yourself.
Requirements
A remote MCP endpoint over streamable HTTP; no API keys, accounts or configuration are needed. A local stdio variant exists but requires Node.js, a build step and a local checkout of the source verse repository.
Before you install
Read-only: it only looks up and searches text, with no writing or sending. Translations come from third-party sources with differing licenses and attribution requirements, so check them before republishing verse text.

Installation

In SourceWeft

  1. Open Ramayana Book MCP Server 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.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.svenkatreddy%2Framayana-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ramayana-book": {
      "type": "http",
      "url": "https://ramayana-mcp.vercel.app/api/mcp"
    }
  }
}

README

ramayana-mcp

An MCP (Model Context Protocol) server for the Ramayana Book (svenkatreddy/ramayana-mcp). Search verses, fetch Sanskrit plus English/Hindi/Telugu translations, and get a deterministic verse of the day. Same codebase serves three targets:

  • stdio (src/stdio.ts) — Claude Desktop, Cursor, and Smithery hosting
  • Vercel serverless (api/mcp.ts) — stateless JSON-RPC over HTTP at /api/mcp (dependency-free handler; the SDK's ESM transport crashes Vercel's runtime)

Tools

ToolWhat it does
list_kandasThe seven kandas with Sanskrit titles and chapter counts
get_verseOne verse by kanda, sarga and verse number
get_sargaEvery verse of one sarga, optional language filter
search_versesFull-text search across all four languages, with snippets
verse_of_the_dayDeterministic verse of the day (see below)

Plus a ramayana://kandas resource with kanda/chapter/verse counts.

Verse of the day

verse_of_the_day hashes the calendar date (FNV-1a, YYYY-MM-DD, UTC by default) and maps it uniformly onto all 24,214 indexed verses. The same date always returns the same verse; pass an explicit date to look up any other day.

Local setup

bash
npm installnpm run build-index   # builds data/ from a Ramayana_Book checkoutnpm run buildnpm start             # stdio server

build-index reads the Ramayana_Book repo from RAMAYANA_BOOK_DIR (default: ../../ramayana-modernization/repo relative to this package).

Claude Desktop config (claude_desktop_config.json):

json
{  "mcpServers": {    "ramayana-book": {      "command": "node",      "args": ["/absolute/path/to/ramayana-mcp/dist/src/stdio.js"]    }  }}

Deploy on Vercel (free Hobby plan, no payment needed)

  1. Push this directory to a new GitHub repo (create the repo yourself on github.com).
  2. In the Vercel dashboard: Add New Project -> Import the repo -> Deploy.
  3. No build config needed; vercel.json already ships the data/ files with the function. The MCP endpoint is https://<project>.vercel.app/api/mcp.

The endpoint is stateless (one POST per JSON-RPC request, no sessions), which fits the Hobby plan's function limits. Point any MCP client at the URL above.

Publish on Smithery (for discoverability)

  1. Push the repo to GitHub (public) - done: svenkatreddy/ramayana-mcp.
  2. Go to smithery.ai, sign in with GitHub.
  3. Add / deploy the ramayana-mcp repo. smithery.yaml declares the TypeScript runtime; Smithery installs, builds, and imports createServer plus configSchema from src/index.ts. No API keys or config needed.

Smithery hosts the server and gives it a registry page with one-click install for Claude Desktop, Cursor, and other clients.

Data and attribution

Verse data is built from the Ramayana_Book repository:

  • Sanskrit: Sanskrit Wikisource (Wikimedia); 3 chapters restored from IIT Kanpur's critical edition
  • English: Valmiki Ramayan Dataset (MIT) — M.N. Dutt's translation (1891-1894), IIT Kanpur, Gyaandweep
  • Hindi: Chaturvedi Dwarka Prasad Sharma's Hindi Ramayana (used with permission)
  • Telugu: Telugu Wikisource contributors (CC BY-SA)

Re-run npm run build-index after the Ramayana_Book translations change.

License

The server code in this repo is MIT licensed (see LICENSE).

The verse data under data/ carries the licenses of its sources, not MIT: Sanskrit from Sanskrit Wikisource (Wikimedia), English from the MIT-licensed Valmiki Ramayan Dataset, Hindi from Chaturvedi Dwarka Prasad Sharma's translation (used with permission), Telugu from Telugu Wikisource contributors (CC BY-SA). See the Ramayana_Book translation sources for full attribution.

Source: README.md at commit dbc5541

Tools

5

list_kandas

List the seven kandas of the Ramayana with their Sanskrit names and chapter counts

Takes no parameters.

get_verse

Fetch a single verse by kanda, chapter (sarga) and verse number, with Sanskrit and available translations

Parameterskandarequiredverserequiredchapterrequired

get_sarga

Fetch every verse of one sarga (chapter), with Sanskrit and available translations

Parameterskandarequiredlangschapterrequired

search_verses

Full-text search across Sanskrit and English/Hindi/Telugu translations; returns matching verse references with snippets

Parameterslimitqueryrequired

verse_of_the_day

A deterministic verse of the day: the same calendar date always yields the same verse, drawn uniformly from the whole corpus

Parametersdate

Version history

1
  1. v0.1.0LatestOct 19, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts