VenuVidya — Carnatic Flute Study Guide
by pradeep-anantha · remote · no sign-in to list tools · v0.1.1 · published by GitHub user pradeep-anantha
Kannada/English Carnatic flute KSGMS syllabus — search lessons, log practice, ask a RAG guru.
7 tools: 1 change things and 6 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads6Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http venuvidya https://venuvidya-backend-production.up.railway.app/api/mcp/Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
7 tools
Changes things 1Claude Code: ask
ask_venuvidyaAsk VenuVidya — the in-app RAG chatbot.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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'.
Only reads 6Claude Code: allow
get_classFetch a single class journal entry with its items and practice log.No findings
Why it is in this group
- The name "get_class" says "get": a word for reading.
Description, as the server wrote it 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.
get_lessonFetch the full study content of a single lesson.No findings
Why it is in this group
- The name "get_lesson" says "get": a word for reading.
Description, as the server wrote it Fetch the full study content of a single lesson. Args: lesson_id: Lesson identifier, e.g. 'junior-theory-1-4'.
list_classesList recent class journal entries (date descending) for YOUR account.No findings
Why it is in this group
- The name "list_classes" says "list": a word for reading.
Description, as the server wrote it 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).
list_lessonsList lesson metadata.No findings
Why it is in this group
- The name "list_lessons" says "list": a word for reading.
Description, as the server wrote it List lesson metadata. Filter by level/category. Args: level: 'junior' | 'senior' | 'vidwat'. category: e.g. 'theory-1', 'practical-1', etc.
log_practice_sessionLog a practice session against a class item in YOUR journal.No findings
Why it is in this group
- The name "log_practice_session" says "log": a word for reading.
Description, as the server wrote it 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.
search_syllabusKeyword (BM25) search across all Carnatic flute lessons.No findings
Why it is in this group
- The name "search_syllabus" says "search": a word for reading.
Description, as the server wrote it 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'.
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.1.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http venuvidya https://venuvidya-backend-production.up.railway.app/api/mcp/Run in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__venuvidya__search_syllabus",
"mcp__venuvidya__get_lesson",
"mcp__venuvidya__list_lessons",
"mcp__venuvidya__list_classes",
"mcp__venuvidya__get_class",
"mcp__venuvidya__log_practice_session"
],
"ask": [
"mcp__venuvidya__ask_venuvidya"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as venuvidya. Review it before you use it.
