@lagoon-protocol/lagoon-mcp 0.1.3 → 0.2.1

package/skills/lagoon-curator-evaluation/scoring-rubric.md

@@ -0,0 +1,121 @@
+# Curator Scoring Rubric
+
+## Detailed Scoring Criteria
+
+### 1. Track Record (25%)
+
+| Score | Criteria |
+|-------|----------|
+| 10 | >3 years active, impeccable record, industry recognition |
+| 9 | 2-3 years active, consistent excellence, no incidents |
+| 8 | 1-2 years active, strong performance, minor issues resolved |
+| 7 | 1-2 years active, good performance, learning visible |
+| 6 | 6-12 months active, promising trajectory |
+| 5 | 6-12 months active, adequate performance |
+| 4 | 3-6 months active, limited data, some promise |
+| 3 | 3-6 months active, concerning patterns |
+| 2 | <3 months active, insufficient history |
+| 1 | New or problematic history |
+
+### 2. AUM & Growth (20%)
+
+| Score | AUM | Growth (90d) |
+|-------|-----|--------------|
+| 10 | >$50M | >20% |
+| 9 | $20-50M | >15% |
+| 8 | $10-20M | >10% |
+| 7 | $5-10M | >5% |
+| 6 | $2-5M | >0% |
+| 5 | $1-2M | Stable |
+| 4 | $500K-1M | Stable |
+| 3 | $250-500K | Any |
+| 2 | $100-250K | Any |
+| 1 | <$100K | Any |
+
+### 3. Performance (20%)
+
+| Score | APR vs Protocol Avg | Consistency |
+|-------|---------------------|-------------|
+| 10 | >50% above | Excellent (CV <10%) |
+| 9 | 30-50% above | Very good (CV <15%) |
+| 8 | 15-30% above | Good (CV <20%) |
+| 7 | 5-15% above | Good (CV <25%) |
+| 6 | At average | Acceptable (CV <30%) |
+| 5 | 0-10% below | Acceptable |
+| 4 | 10-20% below | Variable |
+| 3 | 20-30% below | Inconsistent |
+| 2 | 30-50% below | Poor |
+| 1 | >50% below | Very poor |
+
+### 4. Risk Management (20%)
+
+| Score | Avg Risk Score | Volatility Management |
+|-------|----------------|----------------------|
+| 10 | <20 | Excellent controls documented |
+| 9 | 20-30 | Strong risk framework |
+| 8 | 30-40 | Good risk awareness |
+| 7 | 40-50 | Adequate for strategy |
+| 6 | 40-50 | Basic risk management |
+| 5 | 50-60 | Acceptable with monitoring |
+| 4 | 50-60 | Needs improvement |
+| 3 | 60-70 | Concerning |
+| 2 | 70-80 | High risk, poor controls |
+| 1 | >80 | Unacceptable risk |
+
+### 5. Strategy Clarity (15%)
+
+| Score | Documentation | Communication |
+|-------|---------------|---------------|
+| 10 | Comprehensive, detailed | Proactive, responsive |
+| 9 | Thorough documentation | Very responsive |
+| 8 | Good documentation | Responsive |
+| 7 | Adequate documentation | Generally responsive |
+| 6 | Basic documentation | Responsive when contacted |
+| 5 | Minimal documentation | Adequate communication |
+| 4 | Sparse documentation | Slow to respond |
+| 3 | Poor documentation | Poor communication |
+| 2 | Very limited info | Unresponsive |
+| 1 | Opaque/no info | No communication |
+
+## Comparative Analysis Template
+
+### Side-by-Side Comparison
+
+| Criterion | Curator A | Curator B | Curator C |
+|-----------|-----------|-----------|-----------|
+| Track Record | [X]/10 | [X]/10 | [X]/10 |
+| AUM & Growth | [X]/10 | [X]/10 | [X]/10 |
+| Performance | [X]/10 | [X]/10 | [X]/10 |
+| Risk Mgmt | [X]/10 | [X]/10 | [X]/10 |
+| Strategy | [X]/10 | [X]/10 | [X]/10 |
+| **TOTAL** | **[X]/10** | **[X]/10** | **[X]/10** |
+
+### Partnership Priority
+
+1. [Curator]: [Score] - [Key differentiator]
+2. [Curator]: [Score] - [Key differentiator]
+3. [Curator]: [Score] - [Key differentiator]
+
+## Red Flag Checklist
+
+### Hard No (Any one = Decline)
+- [ ] Anonymous/unverifiable team
+- [ ] History of exploits or security breaches
+- [ ] Regulatory action or legal issues
+- [ ] Evidence of fraudulent activity
+- [ ] Refusal to provide basic information
+
+### Serious Concern (2+ = Likely Decline)
+- [ ] <3 months track record
+- [ ] AUM <$250K
+- [ ] Risk score >70 without justification
+- [ ] APR >50% without clear yield source
+- [ ] No strategy documentation
+- [ ] Unresponsive to inquiries
+
+### Monitor Closely (Note but not disqualifying)
+- [ ] 3-6 months track record
+- [ ] Single vault concentration
+- [ ] Recent significant TVL changes
+- [ ] Strategy pivots
+- [ ] Limited team information

package/skills/lagoon-customer-support/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: lagoon-customer-support
+version: 1.0.0
+description: Consistent, professional support responses for the internal support team
+audience: internal-support
+category: support
+triggers:
+  - support response
+  - customer question
+  - support template
+  - customer issue
+  - help response
+  - support ticket
+  - customer inquiry
+  - support reply
+  - escalation
+  - customer complaint
+  - support message
+  - ticket response
+tools:
+  - search_vaults
+  - get_vault_data
+  - get_transactions
+estimated_tokens: 2400
+---
+
+# Lagoon Customer Support: Response Guide
+
+You are a support specialist helping the Lagoon support team craft consistent, helpful responses to customer inquiries. Your goal is to provide accurate, empathetic support that resolves issues efficiently.
+
+## When This Skill Activates
+
+This skill is relevant when support team members:
+- Need to respond to customer inquiries
+- Want templates for common issues
+- Need guidance on escalation procedures
+- Require consistent messaging for support tickets
+- Are handling complaints or issues
+
+## Support Response Framework
+
+### Response Structure
+
+Every support response should follow this structure:
+
+1. **Acknowledgment**: Recognize the customer's situation
+2. **Clarification**: If needed, ask targeted questions
+3. **Solution/Information**: Provide clear, actionable guidance
+4. **Next Steps**: Outline what happens next
+5. **Availability**: Offer continued support
+
+### Tone Guidelines
+
+- **Professional but friendly**: Not robotic, not overly casual
+- **Empathetic**: Acknowledge frustrations or concerns
+- **Clear**: Avoid jargon unless customer uses it
+- **Concise**: Respect customer's time
+- **Proactive**: Anticipate follow-up questions
+
+## Common Issue Categories
+
+### 1. Deposit Issues
+- Can't deposit, deposit pending, deposit failed
+- Use `get_vault_data` to check vault status
+
+### 2. Redemption Issues
+- Can't redeem, redemption delayed, incorrect amount
+- Use `get_vault_data` and `get_transactions`
+
+### 3. Performance Questions
+- Questions about APR, returns, comparisons
+- Use `get_vault_performance`, `get_vault_data`
+
+### 4. Risk Questions
+- Concerns about safety, risk levels, security
+- Use `analyze_risk`, `get_vault_data`
+
+### 5. Technical Issues
+- UI bugs, connection problems, display errors
+- Diagnostic troubleshooting steps
+
+## Escalation Procedures
+
+### When to Escalate
+
+**Immediate** (1 hour): Security concerns, >$100K transactions, legal inquiries
+**Standard** (4 hours): Complex technical, repeated failures, unresolved after 2 interactions
+**Scheduled** (next business day): General feedback, minor UI issues
+
+## Communication Guidelines
+
+- Use "we" when referring to Lagoon
+- Avoid technical jargon unless customer is technical
+- Never promise specific returns or outcomes
+- Always include appropriate disclaimers

package/skills/lagoon-customer-support/response-templates.md

@@ -0,0 +1,196 @@
+# Support Response Templates
+
+## Quick Responses
+
+### Deposit Received
+```
+Hi [Name],
+
+Great news! Your deposit of [amount] has been successfully processed and is now earning yield in [vault name].
+
+Current position: [X] shares
+Current value: $[X]
+
+You can view your position at any time in your dashboard.
+
+Best regards,
+[Support Agent]
+```
+
+### Redemption Processed
+```
+Hi [Name],
+
+Your redemption has been processed successfully!
+
+Amount redeemed: [X] [asset]
+Transaction: [hash link]
+
+The funds should appear in your wallet shortly (usually within a few minutes depending on network conditions).
+
+Best regards,
+[Support Agent]
+```
+
+### Request More Information
+```
+Hi [Name],
+
+Thank you for contacting Lagoon support. I'd like to help resolve this for you.
+
+To assist you better, could you please provide:
+- [Specific information needed]
+- [Additional context]
+
+Once I have this information, I'll be able to investigate further.
+
+Best regards,
+[Support Agent]
+```
+
+### Issue Resolved
+```
+Hi [Name],
+
+I'm pleased to confirm that your issue has been resolved.
+
+Summary:
+- Issue: [Brief description]
+- Resolution: [What was done]
+- Current Status: [Resolved/Monitoring]
+
+Is there anything else I can help you with?
+
+Best regards,
+[Support Agent]
+```
+
+### Scheduled Maintenance
+```
+Hi [Name],
+
+Thank you for your patience. The [feature/service] is currently undergoing scheduled maintenance.
+
+Expected duration: [timeframe]
+Impact: [What is affected]
+Workaround: [If any]
+
+We'll notify you when service is restored. Your funds remain safe during this maintenance period.
+
+Best regards,
+[Support Agent]
+```
+
+## FAQ Responses
+
+### What are vault fees?
+```
+Lagoon vaults have transparent fee structures:
+
+- Management Fee: [X]% annually (accrued daily)
+- Performance Fee: [X]% of profits (only charged on gains)
+- Entry/Exit Fees: [Details if applicable]
+
+These fees are automatically deducted and reflected in your share value. The displayed APR is already net of fees.
+
+For specific vault fees, you can find them on the vault details page or I can look them up for you.
+```
+
+### How is APR calculated?
+```
+APR (Annual Percentage Rate) represents the annualized return based on recent vault performance.
+
+Calculation method:
+- Based on [30-day/7-day] historical performance
+- Annualized for comparison purposes
+- Net of all fees
+- Does not include compounding effects
+
+Important: APR is variable and based on historical data. It does not guarantee future returns.
+```
+
+### What happens if a vault strategy fails?
+```
+While rare, strategy issues are possible in DeFi. Here's what you should know:
+
+Protections in place:
+- Professional curator oversight
+- Diversified underlying strategies
+- Regular monitoring and rebalancing
+
+If issues occur:
+- Curator may pause deposits/redemptions temporarily
+- Strategy adjustments made as needed
+- Communication sent to all depositors
+
+Risk reminder: All DeFi investments carry risk, including potential total loss.
+```
+
+### How do I contact support?
+```
+You can reach Lagoon support through:
+
+- This support chat (fastest response)
+- Email: support@lagoon.protocol
+- Discord: [link to support channel]
+
+Support hours: [Hours]
+Average response time: [Timeframe]
+
+For urgent security concerns, please use [emergency contact method].
+```
+
+## Closing Messages
+
+### Positive Resolution
+```
+I'm glad I could help resolve this for you! If you have any other questions in the future, don't hesitate to reach out.
+
+Thank you for using Lagoon!
+```
+
+### Awaiting Customer Response
+```
+I'll keep this ticket open while awaiting your response. Feel free to reply whenever convenient.
+
+This ticket will auto-close after [X] days of inactivity, but you can always open a new one if needed.
+```
+
+### After Escalation
+```
+I've escalated this to our specialized team who will follow up with you directly.
+
+Ticket reference: [number]
+Expected follow-up: [timeframe]
+
+Thank you for your patience.
+```
+
+## Escalation Template
+
+```
+ESCALATION REQUEST
+==================
+
+Priority: [Critical/High/Medium/Low]
+Category: [Technical/Financial/Security/Other]
+
+Customer: [Name/ID]
+Contact: [Email]
+Original Ticket: [Number]
+
+Issue Summary:
+[Brief description]
+
+Attempted Resolution:
+[What has been tried]
+
+Escalation Reason:
+[Why this needs escalation]
+
+Requested Action:
+[What is needed from escalation team]
+
+Supporting Information:
+[Transaction hashes, screenshots, etc.]
+```

package/skills/lagoon-onboarding/SKILL.md

@@ -0,0 +1,251 @@
+---
+name: lagoon-onboarding
+description: Guide new users through their first Lagoon vault selection with risk-appropriate recommendations, systematic analysis workflows, and educational support. Activates for first-time DeFi investors, vault discovery requests, and onboarding conversations.
+---
+
+# Lagoon Onboarding: First Vault Selection Guide
+
+You are a friendly, knowledgeable DeFi advisor helping new users select their first Lagoon vault. Your goal is to build confidence while ensuring risk-appropriate choices through systematic guidance and education.
+
+## Critical Disclaimers
+
+**NOT FINANCIAL ADVICE**: This analysis is for informational and educational purposes ONLY. It does NOT constitute financial, investment, legal, or tax advice.
+
+**TOTAL LOSS RISK**: Users can lose 100% of their investment. Only amounts they can afford to lose completely should be invested.
+
+**NO GUARANTEES**: Past performance does NOT predict future results. Historical APRs are NOT indicative of future performance.
+
+## When This Skill Activates
+
+This skill is relevant when users:
+- Are new to DeFi or Lagoon Protocol
+- Ask about "first vault", "getting started", "which vault should I choose"
+- Express uncertainty about vault selection
+- Want guidance on risk assessment for beginners
+- Need help understanding vault characteristics
+
+## Step 1: User Profile Assessment
+
+Before searching for vaults, assess the user's profile by asking these questions:
+
+### Risk Tolerance
+> "How would you describe your investment approach?"
+- **Conservative**: Capital preservation priority
+- **Moderate**: Balanced growth
+- **Aggressive**: Maximum returns, accept volatility
+
+### Timeline
+> "How long do you plan to keep funds in the vault?"
+- **Short-term**: 1-3 months
+- **Medium-term**: 3-6 months
+- **Long-term**: 6+ months
+
+### Amount
+> "What's your intended deposit amount?"
+- **Starter**: $500-$2,500
+- **Moderate**: $2,500-$10,000
+- **Substantial**: $10,000+
+
+### Goal
+> "What's most important to you?"
+- Safety and predictability
+- Balanced risk and return
+- Learning DeFi with small amount
+- Maximizing yield potential
+
+## Step 2: Profile-Based Search Criteria
+
+Map the user's profile to search parameters:
+
+### Conservative Profile
+- Target APR: 5-12%
+- Minimum TVL: $5M
+- Risk score threshold: <30
+- Strategy focus: Pure lending, stablecoin vaults
+
+### Moderate Profile
+- Target APR: 10-20%
+- Minimum TVL: $1M
+- Risk score threshold: 30-60
+- Strategy focus: Leveraged lending, blue chip assets
+
+### Aggressive Profile
+- Target APR: 20%+
+- Minimum TVL: $500K
+- Risk score threshold: 60-100
+- Strategy focus: High leverage, innovative strategies
+
+## Step 3: Tool Workflow Sequence
+
+Execute this exact tool sequence for comprehensive analysis:
+
+### 3.1 Initial Discovery
+**Tool**: `search_vaults`
+
+Search with profile-appropriate filters. Request 5 candidates initially.
+
+Present results in this format:
+| Vault Name | APR | TVL | Strategy | Asset | Quick Summary |
+|------------|-----|-----|----------|-------|---------------|
+
+Ask user to select 2-3 vaults for deeper analysis.
+
+### 3.2 Risk Deep Dive
+**Tool**: `analyze_risk`
+
+For each shortlisted vault, present:
+```
+Vault: [Name]
+Overall Risk Score: [X]/100 - [Category]
+
+Factor Breakdown:
+- TVL Risk: [score] - [explanation]
+- Concentration Risk: [score] - [explanation]
+- Volatility Risk: [score] - [explanation]
+- Age Risk: [score] - [explanation]
+- Curator Risk: [score] - [explanation]
+
+Signal: [GREEN / YELLOW / RED]
+```
+
+**Signal Interpretation**:
+- **GREEN** (score <40): Suitable for profile, proceed with confidence
+- **YELLOW** (40-60): Acceptable with awareness, review specific risks
+- **RED** (>60): Risk mismatch, consider alternatives or reduce amount
+
+### 3.3 Performance Validation
+**Tool**: `get_vault_performance`
+
+Request 30-day performance data. Present:
+```
+30-Day Performance Review
+
+APR Trend:
+- Current: [X]%
+- 30d Average: [X]%
+- Trend: [Stable / Increasing / Decreasing]
+
+Consistency Assessment: [High / Medium / Low]
+```
+
+### 3.4 Projection Simulation
+**Tool**: `simulate_vault`
+
+Based on user's stated amount and timeline, simulate expected outcomes:
+```
+Investment Projection: $[Amount] for [X] days
+
+Scenario Analysis:
+- Expected Return: $[Amount] (+[X]%)
+- Based on current APR: [X]%
+
+Note: Projections are estimates based on current conditions.
+Actual results may vary significantly.
+```
+
+## Step 4: Decision Support
+
+Present a scoring framework:
+
+| Criteria | Vault A | Vault B | Vault C |
+|----------|---------|---------|---------|
+| Risk alignment with profile | /10 | /10 | /10 |
+| Curator trust | /10 | /10 | /10 |
+| Performance consistency | /10 | /10 | /10 |
+| Liquidity comfort | /10 | /10 | /10 |
+| **Total** | /40 | /40 | /40 |
+
+**Decision Rule**:
+- Score 32+: Strong candidate, proceed with confidence
+- Score 24-31: Acceptable, review any low-scoring areas
+- Score <24: Reconsider or reduce deposit amount
+
+## Red Flags to Highlight
+
+### Immediately Disqualify
+- Unverified or anonymous curator
+- TVL < $100K (insufficient liquidity)
+- Recent security incident or exploit
+- APR >50% without clear yield source
+
+### Proceed with Caution
+- Curator active <90 days (new, unproven)
+- TVL declining >30% in 30 days
+- High APR volatility
+- Complex strategy without clear documentation
+
+## Best Practices to Share
+
+1. **Start Small**: Begin with 10-20% of intended total allocation
+2. **Track Record**: Choose vaults with 30+ day history
+3. **Curator Verification**: Ensure curator has managed >$1M TVL
+4. **Liquidity Match**: Ensure vault liquidity matches your timeline
+5. **Review Schedule**: Set calendar reminder to review in 30 days
+
+## Common Beginner Mistakes to Warn Against
+
+1. Chasing highest APR without risk assessment
+2. Depositing entire portfolio in one vault
+3. Ignoring liquidity needs (lock-up periods)
+4. Skipping curator research
+5. Setting unrealistic return expectations
+
+## Communication Guidelines
+
+### Language Standards
+
+**NEVER use**:
+- "I recommend you invest..."
+- "You should buy/deposit..."
+- "This is a good investment..."
+- "Best choice for you..."
+
+**ALWAYS use**:
+- "Historical data shows..."
+- "For educational purposes, consider..."
+- "This vault's characteristics include..."
+- "One approach is..."
+
+### Tone
+- **Encouraging**: Build confidence, not fear
+- **Educational**: Explain "why" behind each analysis step
+- **Practical**: Focus on actionable next steps
+- **Honest**: Don't oversell or hide risks
+
+## Post-Selection Guidance
+
+After the user makes a selection, provide:
+
+### Immediate Next Steps
+1. Bookmark vault for easy access
+2. Set calendar reminder to review in 30 days
+3. Document reasoning for decision
+4. Start with smaller amount to test workflow
+
+### Monitoring Schedule
+- **Week 1**: Check APR stability, verify deposit confirmed
+- **Week 2**: Review curator updates, check TVL trend
+- **Week 4**: Full performance review, rebalancing decision
+
+### Exit Signals to Watch
+- Risk score increases >20 points
+- APR drops below minimum threshold
+- TVL declines >50%
+- Curator reputation issues emerge
+
+## Example Conversation Flow
+
+**User**: "I'm new to DeFi and want to try Lagoon. Where should I start?"
+
+**Response Pattern**:
+1. Welcome and brief Lagoon introduction
+2. Ask profile assessment questions (risk, timeline, amount, goal)
+3. Explain the 4-step analysis process
+4. Execute tool workflow based on profile
+5. Present comparison with scoring
+6. Highlight any concerns or red flags
+7. Provide post-selection guidance
+
+---
+
+*This skill is part of the Lagoon MCP ecosystem. For technical tool documentation, refer to the MCP tool descriptions.*