Bhagavad Gita

What Bhagavad Gita does

Bhagavad Gita provides structured access to the Hindu scripture through MCP. Its three dedicated tools cover the work at chapter and verse level:

• list_chapters returns all 18 chapters with chapter numbers, Sanskrit names, transliterations, English meanings, summaries, and verse counts.
• get_chapter retrieves the same kind of metadata for one chapter selected by number.
• get_verse retrieves one verse by chapter and verse number, including the original Sanskrit in Devanagari, transliteration, English translations, and commentary.

The English translation set includes versions attributed to Sivananda, Purohit, Gambirananda, and Adidevananda. This makes the server suitable for lookup, comparison, study, and applications that need both original text and translated material.

How it works

The data comes through the Vedic Scriptures API, with the upstream project serving keyless JSON through GitHub Pages at vedicscriptures.github.io. MCP clients can connect to the hosted Pipeworx route:

https://gateway.pipeworx.io/bhagavad-gita/mcp

The same gateway also offers a full endpoint at https://gateway.pipeworx.io/mcp. The scoped route lists the Bhagavad Gita tools directly, while gateway connections also expose shared Pipeworx meta-tools such as ask_pipeworx, discover_tools, search_within, remember, and recall. The gateway can use ask_pipeworx to route questions across its catalog.

For direct HTTP calls, the gateway exposes tool routes under https://gateway.pipeworx.io/v1/tools/. For example, list_chapters accepts a JSON POST request at /v1/tools/list_chapters.

Setup and configuration

Remote MCP clients can use this configuration:

{
  "mcpServers": {
    "bhagavad-gita": {
      "url": "https://gateway.pipeworx.io/bhagavad-gita/mcp"
    }
  }
}

The package also runs locally as a stdio server using the npm package:

{
  "mcpServers": {
    "bhagavad-gita": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-bhagavad-gita"]
    }
  }
}

Run npx -y @pipeworx/mcp-bhagavad-gita directly to verify that the local process starts. The standalone mode handles MCP initialization, tool listing, and tool calls for the Bhagavad Gita tools without the gateway's shared meta-tools.

Tools and capabilities

• Enumerate every chapter and its basic metadata.
• Look up an individual chapter by number.
• Retrieve a verse using chapter and verse numbers.
• Compare multiple named English translations.
• Read Sanskrit text in Devanagari alongside transliteration and commentary.

Limitations and notes

The integration is independent and unofficial; it is not affiliated with, endorsed by, or published by the upstream provider. Hosted connections include additional gateway tools alongside the pack's own tools, so the tool count shown by a client can exceed the three dedicated tools. The local package keeps its scope limited to the Bhagavad Gita tools and does not provide the gateway's cross-catalog routing.

The hosted gateway requires no account for its first calls. The local stdio option avoids a Pipeworx account and gateway round-trip.