# venuvidya MCP server

Carnatic flute KSGMS syllabus — search lessons, fetch content, ask a guru-voice RAG bot.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-pradeep-anantha-venuvidya

## Install
- Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- Auth: Not captured

## Setup notes
- Remote endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/

## Tools
- search_syllabus - Keyword (BM25) search across all Carnatic flute lessons.

    Args:
        query: Natural-language question or keywords (English or Kannada).
        k: Number of top results to return (1-10, default 4).
        level: Optional filter — 'junior', 'senior' or 'vidwat'.
     Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- get_lesson - Fetch the full study content of a single lesson.

    Args:
        lesson_id: Lesson identifier, e.g. 'junior-theory-1-4'.
     Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- list_lessons - List lesson metadata. Filter by level/category.

    Args:
        level: 'junior' | 'senior' | 'vidwat'.
        category: e.g. 'theory-1', 'practical-1', etc.
     Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- list_classes - List recent class journal entries (date descending).

    Args:
        level: optional level filter.
        limit: max number of classes (1-100, default 20).
     Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- get_class - Fetch a single class journal entry with its items and practice log. Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- ask_venuvidya - Ask VenuVidya — the in-app RAG chatbot. Returns a grounded answer + citations.

    Args:
        question: Student question (2-1500 chars).
        level: Optional level filter for retrieval ('junior' | 'senior' | 'vidwat').
        language: 'en', 'kn' or 'auto'.
     Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/
- log_practice_session - Log a practice session against a class item. Requires admin_pin.

    Args:
        class_id: Parent class id.
        item_id: Item id inside the class (kriti/varna/etc.).
        practiced_on: Date in YYYY-MM-DD.
        duration_min: Duration in minutes.
        notes: Free-text notes.
        rating: Self-rating 1-5.
        admin_pin: Admin PIN required for writes.
     Endpoint: https://venuvidya-backend-production.up.railway.app/api/mcp/

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.pradeep-anantha
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 13, 2026
- Source: https://registry.modelcontextprotocol.io