mcp-rubber-duck 1.6.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,10 @@
1
+ ## [1.6.1](https://github.com/nesquikm/mcp-rubber-duck/compare/v1.6.0...v1.6.1) (2026-01-09)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **docs:** add missing get_usage_stats tool to README ([c507f07](https://github.com/nesquikm/mcp-rubber-duck/commit/c507f07092018ad48aa24f6e9115a0761d0d7d49))
7
+
1
8
  # [1.6.0](https://github.com/nesquikm/mcp-rubber-duck/compare/v1.5.2...v1.6.0) (2026-01-08)
2
9
 
3
10
 
package/README.md CHANGED
@@ -43,6 +43,7 @@ An MCP (Model Context Protocol) server that acts as a bridge to query multiple O
43
43
  - 💾 **Response Caching**: Avoid duplicate API calls with intelligent caching
44
44
  - 🔁 **Automatic Failover**: Falls back to other providers if primary fails
45
45
  - 📊 **Health Monitoring**: Real-time health checks for all providers
46
+ - 💰 **Usage Tracking**: Track requests, tokens, and estimated costs per provider
46
47
  - 🔗 **MCP Bridge**: Connect ducks to other MCP servers for extended functionality
47
48
  - 🛡️ **Granular Security**: Per-server approval controls with session-based approvals
48
49
  - 🎨 **Fun Duck Theme**: Rubber duck debugging with personality!
@@ -510,6 +511,19 @@ Get responses from all configured ducks - like a panel discussion!
510
511
  }
511
512
  ```
512
513
 
514
+ #### 📊 get_usage_stats
515
+ Get usage statistics and estimated costs for your duck queries.
516
+
517
+ ```typescript
518
+ {
519
+ "period": "today" // Optional: "today", "7d", "30d", or "all"
520
+ }
521
+ ```
522
+
523
+ Returns requests, tokens (prompt/completion), cache hits, errors, and estimated costs broken down by provider and model.
524
+
525
+ Usage data is stored in `~/.mcp-rubber-duck/data/usage.json`.
526
+
513
527
  ### Multi-Agent Consensus & Debate Tools
514
528
 
515
529
  Research-backed tools for multi-agent coordination.
@@ -695,6 +709,15 @@ await duck_debate({
695
709
  });
696
710
  ```
697
711
 
712
+ ### Check Usage Stats
713
+ ```javascript
714
+ // See today's usage
715
+ await get_usage_stats({ period: "today" });
716
+
717
+ // See last 7 days with cost breakdown
718
+ await get_usage_stats({ period: "7d" });
719
+ ```
720
+
698
721
  ## Provider-Specific Setup
699
722
 
700
723
  ### Ollama (Local)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-rubber-duck",
3
- "version": "1.6.0",
3
+ "version": "1.6.1",
4
4
  "description": "An MCP server that bridges to multiple OpenAI-compatible LLMs - your AI rubber duck debugging panel",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",