wemush-mycology-assistant
npx machina-cli add skill wemush/wemush-skills/wemush-mycology-assistant --openclawWeMush Mycology Assistant
Overview
This skill helps researchers and cultivators interact with WeMush, a decentralized mycology platform for mushroom cultivation management, specimen tracking, and collaborative research.
Use this skill when users want to:
- Manage research projects (create, join, view progress)
- Track specimens and cultivation observations
- Analyze research outcomes and trends
- Search the mycology catalog (strains, species)
- Record and review cultivation data
Prerequisites
Before using WeMush tools, users need:
- A WeMush account at https://wemush.com
- OAuth authorization via the WeMush MCP server
- Appropriate scopes granted during authorization
Available OAuth Scopes
| Scope | Description |
|---|---|
research:read | View research projects and observations |
research:write | Create projects, submit observations |
specimens:read | View specimen data and lineage |
specimens:write | Record specimen observations |
analytics:read | Access research analytics |
catalog:read | Search strains and species |
Workflows
1. Research Project Management
List available projects:
Use list_research_projects to show public research projects the user can join.
Join a project:
Use enroll_in_project with the project ID to join a research initiative.
View project details:
Use get_research_project to see full project details, protocols, and progress.
Create new research:
Use create_research_project with title, description, target strain IDs, and protocol details.
2. Specimen Tracking
View specimens:
Use list_my_specimens to see all specimens the user has access to. Filter by status, strain, or date range.
Get specimen details:
Use get_specimen_details with specimen ID for full information including current status, lineage, and observation history.
View lineage:
Use get_specimen_lineage to see the specimen's ancestry and descendants. Helpful for tracking genetics and cultivation history.
Record observations:
Use record_specimen_observation to log cultivation data including growth measurements, environmental conditions, health assessments, and notes.
3. Analytics & Insights
Project analytics:
Use get_project_analytics for aggregate statistics including participant count, observation rates, and completion stats.
Outcome analysis:
Use get_outcome_breakdown to see success/failure rates broken down by strain, technique, or conditions.
Equipment analysis:
Use get_equipment_analysis to identify which equipment correlates with better cultivation outcomes.
Research trends:
Use get_research_trends to see patterns over time including seasonal variations and technique evolution.
4. Catalog Exploration
Search strains:
Use search_strains to find mushroom strains by name, species, cultivation difficulty, or characteristics.
Search species:
Use search_species to find species information by scientific name, common name, or genus.
Get details:
Use get_strain_details or get_species_details for comprehensive information including taxonomy, cultivation requirements, and images.
5. Profile & Activity
View profile:
Use get_my_research_profile to see the user's research contributions, project memberships, and observation statistics.
Activity feed:
Use get_research_activity_feed to see recent activity across projects the user participates in.
Examples
Starting a Research Project
User: "I want to start a research project comparing Lion's Mane growth on different substrates"
- Search for Lion's Mane strains:
search_strainswith query "Lion's Mane" - Create the project:
create_research_projectwith:- Title: "Lion's Mane Substrate Comparison Study"
- Description: Research goals and methodology
- Target strain IDs from the search results
- Protocol: Data collection requirements
Tracking Cultivation Progress
User: "I need to log today's observations for my Pink Oyster grow"
- List specimens:
list_my_specimensfiltered by strain - Record observation:
record_specimen_observationwith:- Specimen ID
- Growth measurements
- Environmental readings (temp, humidity)
- Health assessment
- Any notes or photos
Analyzing Research Results
User: "How are participants doing in the substrate comparison study?"
- Get project details:
get_research_projectfor context - Get analytics:
get_project_analyticsfor aggregate stats - Get outcomes:
get_outcome_breakdownby substrate type - Summarize findings and trends for the user
Privacy & Security
WeMush protects user data with:
- K-Anonymity (k=5): Analytics aggregate data from at least 5 participants before sharing
- Scope-Based Access: Tools only access data within approved OAuth scopes
- Token Expiration: Access tokens expire after 1 hour
- Audit Logging: All tool calls are logged for security
Users can revoke access anytime via WeMush Settings > Connected Apps.
When to Use
Invoke this skill when users:
- Ask about mushroom cultivation or mycology research
- Want to track specimens or cultivation progress
- Need to analyze research data or outcomes
- Want to explore mushroom strains or species
- Ask about WeMush features or workflows
- Mention research projects, observations, or analytics
Do NOT use this skill for:
- General mushroom identification without catalog search
- Medical or consumption advice
- Topics unrelated to mycology research
Support
- Documentation: https://wemush.com/docs/claude-connector
- Email: support@wemush.com
- Status: https://wemush.com/status
See references/REFERENCE.md for complete tool documentation.
Source
git clone https://github.com/wemush/wemush-skills/blob/main/wemush-mycology-assistant/SKILL.mdView on GitHub Overview
Guides researchers and cultivators through WeMush MCP-driven workflows for specimen tracking, research projects, analytics, and catalog exploration. It streamlines managing projects, recording cultivation data, and analyzing results on a decentralized mycology platform.
How This Skill Works
Connects to the WeMush MCP server via OAuth 2.0 and exposes actions such as list_research_projects, enroll_in_project, list_my_specimens, record_specimen_observation, and search_strains. It returns structured data (projects, specimens, analytics, and catalog details) to support decision making.
When to Use It
- You want to start or join a research project and track its progress.
- You need to log cultivation observations or view specimen lineage.
- You want analytics insights on outcomes, trends, or equipment performance.
- You are searching the catalog for strains or species to study or cultivate.
- You want to review your research profile, activity, and contributions.
Quick Start
- Step 1: Connect to the WeMush MCP server using OAuth 2.0 and authorize required scopes.
- Step 2: List projects or create a new one, then join or start tracking progress.
- Step 3: Record a cultivation observation or search the catalog to begin exploration.
Best Practices
- Verify your OAuth scopes (e.g., research:read/write, specimens:read/write, analytics:read, catalog:read) before performing actions.
- Use consistent IDs for projects, specimens, and strains to avoid mismatches.
- Record observations with date, conditions, and notes to ensure traceable cultivation histories.
- Prefetch project analytics and trends before making experimental decisions.
- Cross-check specimen lineage and get_details when tracing genetics or provenance.
Example Use Cases
- Create a new research project with a target strain and protocol using create_research_project.
- Join an available project with enroll_in_project and view full details via get_research_project.
- Log growth measurements and environmental conditions with record_specimen_observation and get_specimen_details.
- Search strains and species to compare cultivation requirements using search_strains and get_strain_details.
- Review project analytics and trends with get_project_analytics and get_research_trends to guide experiments.
