VenuVidya — Carnatic Flute Study Guide

Official7 toolsLive

by pradeep-anantha

Kannada/English Carnatic flute KSGMS syllabus — search lessons, log practice, ask a RAG guru.

io.github.pradeep-anantha/venuvidya — Model Context Protocol (MCP) Server

This MCP server provides a Kannada/English Carnatic flute KSGMS syllabus workflow. It supports searching lessons, logging practice sessions, and querying guidance via a “RAG guru.” The server is identified by the slug io-github-pradeep-anantha-venuvidya and exposes 7 tools.

🛠️ Key Features

Kannada/English Carnatic flute KSGMS syllabus
Search lessons
Log practice
Ask a “RAG guru”

🚀 Use Cases

Locate specific Carnatic flute lessons within the KSGMS syllabus
Record practice progress for ongoing learning
Request contextual guidance using RAG-based queries

⚡ Developer Benefits

7 available tools for syllabus search, practice logging, and RAG querying
Structured workflow aligned to lesson discovery and practice tracking

⚠️ Limitations

Only the syllabus/search/log/RAG functions are described; other capabilities are not provided in the available data

Captured live from the server via tools/list.

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'.

Parameters3

query	string	required
k	integer	optional
level	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "k": {
      "default": 4,
      "title": "K",
      "type": "integer"
    },
    "level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Level"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_syllabusArguments"
}

get_lesson

Fetch the full study content of a single lesson. Args: lesson_id: Lesson identifier, e.g. 'junior-theory-1-4'.

Parameters1

lesson_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "lesson_id": {
      "title": "Lesson Id",
      "type": "string"
    }
  },
  "required": [
    "lesson_id"
  ],
  "title": "get_lessonArguments"
}

list_lessons

List lesson metadata. Filter by level/category. Args: level: 'junior' | 'senior' | 'vidwat'. category: e.g. 'theory-1', 'practical-1', etc.

Parameters2

level	any	optional
category	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Level"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    }
  },
  "title": "list_lessonsArguments"
}

list_classes

List recent class journal entries (date descending). Args: level: optional level filter. limit: max number of classes (1-100, default 20).

Parameters2

level	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Level"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "list_classesArguments"
}

get_class

Fetch a single class journal entry with its items and practice log.

Parameters1

class_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "class_id": {
      "title": "Class Id",
      "type": "string"
    }
  },
  "required": [
    "class_id"
  ],
  "title": "get_classArguments"
}

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'.

Parameters3

question	string	required
level	any	optional
language	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    },
    "level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Level"
    },
    "language": {
      "default": "auto",
      "title": "Language",
      "type": "string"
    }
  },
  "required": [
    "question"
  ],
  "title": "ask_venuvidyaArguments"
}

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.

Parameters7

class_id	string	required
item_id	string	required
practiced_on	string	required
duration_min	integer	optional
notes	any	optional
rating	any	optional
admin_pin	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "class_id": {
      "title": "Class Id",
      "type": "string"
    },
    "item_id": {
      "title": "Item Id",
      "type": "string"
    },
    "practiced_on": {
      "title": "Practiced On",
      "type": "string"
    },
    "duration_min": {
      "default": 0,
      "title": "Duration Min",
      "type": "integer"
    },
    "notes": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Notes"
    },
    "rating": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rating"
    },
    "admin_pin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Admin Pin"
    }
  },
  "required": [
    "class_id",
    "item_id",
    "practiced_on"
  ],
  "title": "log_practice_sessionArguments"
}

Install

Tools (7)

search_syllabusget_lessonlist_lessonslist_classesget_classask_venuvidyalog_practice_session

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://venuvidya-backend-production.up.railway.app/api/mcp/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "venuvidya": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://venuvidya-backend-production.up.railway.app/api/mcp/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.pradeep-anantha/venuvidya — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_syllabus

get_lesson

list_lessons

list_classes

get_class

ask_venuvidya

log_practice_session

Install

Remote endpoint

Related servers