convex-mcp-visual 1.1.1 → 1.1.3

package/README.md

@@ -26,7 +26,7 @@ Schema visualizer and dashboard tools for exploring Convex databases. Opens inte
 
 ## Quick Start
 
-### Option A: Direct CLI (any terminal)
+### Option A: Direct CLI (any terminal):
 
 ```bash
 # Install globally
@@ -131,12 +131,14 @@ All tools open an interactive browser UI and return output to the terminal.
 
 ## Documentation
 
-- [Setup Guide](docs/setup.md) - Detailed configuration options
-- [Plugin Distribution](deployplugin.md) - Claude Code plugin marketplace
+- [Setup Guide](docs/setup.md) - Configuration and MCP client setup
 - [Tools Reference](docs/tools.md) - Parameters and keyboard shortcuts
 - [Architecture](docs/architecture.md) - How it works
 - [Troubleshooting](docs/troubleshooting.md) - Common issues and fixes
 - [Limitations](docs/limitations.md) - Known limitations
+- [Plugin Distribution](docs/deployplugin.md) - Claude Code marketplace
+- [User Guide: Schema Browser](docs/user-guide-schema-browser.md) - Using the schema browser
+- [User Guide: Dashboard](docs/user-guide-dashboard.md) - Using the dashboard
 
 ## Configuration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convex-mcp-visual",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Visual MCP tools for exploring Convex databases - schema browser, dashboard, ER diagrams. Works as CLI, MCP server, or Claude Code plugin.",
   "type": "module",
   "main": "dist/index.js",

package/skills/convex-schema/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: convex-schema
-description: Browse and visualize Convex database schemas. Use when exploring Convex tables, viewing document structure, or understanding database relationships.
+description: Browse and visualize Convex database schemas. Use when exploring Convex tables, viewing document structure, understanding database relationships, or creating dashboards.
 ---
 
 # Convex Schema Browser
 
-Use the `schema_browser` MCP tool to explore Convex database schemas interactively.
+Use the MCP tools to explore Convex databases interactively.
 
 ## When to use
 
@@ -13,14 +13,40 @@ Use the `schema_browser` MCP tool to explore Convex database schemas interactive
 - User wants to browse tables or documents
 - User needs to understand database structure
 - User asks about table relationships
+- User wants to visualize their data
+- User asks for metrics or dashboard
 
 ## Available tools
 
-This skill provides access to these MCP tools:
+### schema_browser
 
-1. **schema_browser** - Interactive schema explorer with graph and list views
-2. **dashboard_view** - Real-time metrics and document counts
-3. **schema_diagram** - Mermaid ER diagrams of table relationships
+Interactive schema explorer with graph and list views.
+
+**Parameters:**
+
+- `table` (string, optional): Pre-select a specific table
+- `showInferred` (boolean, default: true): Show inferred schemas
+- `pageSize` (number, default: 50): Documents per page
+
+### dashboard_view
+
+Real-time metrics dashboard with charts.
+
+**Parameters:**
+
+- `metrics` (array): Metric definitions with aggregations
+- `charts` (array): Chart configurations (line, bar, pie)
+- `refreshInterval` (number, default: 5): Refresh interval in seconds
+
+### schema_diagram
+
+Mermaid ER diagrams showing table relationships.
+
+**Parameters:**
+
+- `theme` (string): Color theme (github-dark, dracula, nord, etc.)
+- `ascii` (boolean): Use ASCII output for terminal
+- `tables` (array): Specific tables to include
 
 ## Example prompts
 
@@ -30,6 +56,8 @@ This skill provides access to these MCP tools:
 - "Show schema for the users table"
 - "Generate a diagram of my schema"
 - "Create a dashboard for my data"
+- "Show me metrics for my app"
+- "Visualize my database relationships"
 
 ## Requirements