# VenuVidya — Carnatic Flute Study Guide

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

- name: io.github.pradeep-anantha/venuvidya
- version: 0.1.1
- connection class: R0 (autonomous)
- trust: 73/100 flags: no-repository
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.pradeep-anantha%2Fvenuvidya
- tools: https://api.protogrid.dev/v1/servers/io.github.pradeep-anantha%2Fvenuvidya/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "venuvidya": {
      "type": "http",
      "url": "https://venuvidya-backend-production.up.railway.app/api/mcp/"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 65
- provenance: 45
- drivers: +website +reachable +uptime-100% ~updated-135d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_syllabus (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_class (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_lesson (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 997 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 7, about 997 tokens to load them all
- tool set hash: 4754c17a659d8558eafc2034ac69cc0e
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.pradeep-anantha/venuvidya.svg)](https://protogrid.dev/servers/io.github.pradeep-anantha/venuvidya)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://venuvidya-backend-production.up.railway.app/api/mcp/ (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (7)

- `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'.
    
- `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.
    
- `get_lesson`: Fetch the full study content of a single lesson.

    Args:
        lesson_id: Lesson identifier, e.g. 'junior-theory-1-4'.
    
- `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).
    
- `list_lessons`: List lesson metadata. Filter by level/category.

    Args:
        level: 'junior' | 'senior' | 'vidwat'.
        category: e.g. 'theory-1', 'practical-1', etc.
    
- `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.
    
- `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'.