VenuVidya — Carnatic Flute Study Guide

Working · 2.7 s

io.github.pradeep-anantha/venuvidyav0.1.1

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

Education

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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

questionstring, required

levelstring

languagestring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (7)

ask_venuvidya

Argument	Type	Description
level	any
language	string
question*	string

Input schema (JSON)

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

get_class

Fetch a single class journal entry with its items and practice log. Only returns it if it belongs to your account (mcp_token). Args: class_id: The class to fetch. mcp_token: Your personal VenuVidya token — GET /api/auth/mcp-token.

Argument	Type	Description
class_id*	string
mcp_token*	string

Input schema (JSON)

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

get_lesson

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

Argument	Type	Description
lesson_id*	string

Input schema (JSON)

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

list_classes

List recent class journal entries (date descending) for YOUR account. Args: mcp_token: Your personal VenuVidya token — GET /api/auth/mcp-token while signed in to the app. Scopes results to your journal only. level: optional level filter. limit: max number of classes (1-100, default 20).

Argument	Type	Description
level	any
limit	integer
mcp_token*	string

Input schema (JSON)

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

list_lessons

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

Argument	Type	Description
level	any
category	any

Input schema (JSON)

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

log_practice_session

Log a practice session against a class item in YOUR journal. Args: class_id: Parent class id. item_id: Item id inside the class (kriti/varna/etc.). practiced_on: Date in YYYY-MM-DD. mcp_token: Your personal VenuVidya token — GET /api/auth/mcp-token. Only ever writes into a class this account owns. duration_min: Duration in minutes. notes: Free-text notes. rating: Self-rating 1-5.

Argument	Type	Description
notes	any
rating	any
item_id*	string
class_id*	string
mcp_token*	string
duration_min	integer
practiced_on*	string

Input schema (JSON)

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

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

Argument	Type	Description
k	integer
level	any
query*	string

Input schema (JSON)

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