NSIP Plugin
Access NSIP (National Sheep Improvement Program) sheep breeding data through Claude Code with one-command installation.
Features
- 9 MCP tools for sheep breeding data access
- 10 slash commands for quick workflows
- 1 expert agent (shepherd) for breeding consultation
- 14 automatic hooks for enhanced functionality
- Automatic package installation via
uvx
- No manual setup required
Installation
From GitHub
claude plugin install zircote/nsip
Manual Installation
Clone and add to Claude Code:
git clone https://github.com/zircote/nsip.git
claude --plugin-dir /path/to/nsip
Verify Installation
After installing, verify the MCP tools and commands are working:
# Test API connectivity
/nsip:test-api
# Get database info (should show last update date)
/nsip:discover
# Verify MCP tools are available
"Use nsip_list_breeds to show available sheep breeds"
Commands
| Command | Purpose | Example |
|---|
/nsip:consult | Expert breeding consultation (uses shepherd agent) | /nsip:consult I need a terminal sire |
/nsip:discover | Show database info, breeds, statuses | /nsip:discover |
/nsip:lookup | Get animal details by LPN ID | /nsip:lookup 6####92020###249 |
/nsip:profile | Complete animal profile | /nsip:profile 6####92020###249 |
/nsip:health | Server performance metrics | /nsip:health |
/nsip:test-api | Validate API connectivity | /nsip:test-api |
/nsip:search | Search animals with filters | /nsip:search |
/nsip:traits | Get trait ranges for breed | /nsip:traits 486 |
/nsip:lineage | Get pedigree tree | /nsip:lineage 6####92020###249 |
/nsip:progeny | List offspring | /nsip:progeny 6####92020###249 |
Expert Agent
/nsip:consult invokes the nsip:shepherd expert agent, which provides:
- Breeding decision support with NSIP data analysis
- Health diagnosis and treatment recommendations
- Nutrition planning across production stages
- Flock management and culling guidance
- Genetic trait interpretation and selection strategies
MCP Tools
Ask Claude to use these tools directly:
nsip_get_last_update: Database update datensip_list_breeds: Available breed groupsnsip_get_statuses: Animal statuses by breednsip_get_trait_ranges: Trait ranges for breednsip_search_animals: Search with paginationnsip_get_animal: Detailed animal informationnsip_get_lineage: Pedigree treensip_get_progeny: Offspring listnsip_search_by_lpn: Complete animal profile
Enhanced Features (Hooks)
The plugin includes 14 intelligent hooks that automatically enhance your workflow:
Hook Categories
Error Resilience (3 hooks)
- Auto-retry with exponential backoff
- Fallback to cached data on failures
- Alert tracking for repeated errors
Context Enhancement (2 hooks)
- Breed-specific characteristics injection
- Comprehensive trait definitions
Data Export (2 hooks)
- Pedigree tree visualizations
- Breeding analysis reports
Workflow Intelligence (2 hooks)
- Smart LPN ID detection in prompts
- Comparative analysis suggestions
Core Operations (5 hooks)
- API health monitoring
- LPN format validation
- Query logging
- Result caching
- CSV exports
See hooks/README.md for detailed documentation.
Hook Data Locations
Logs: ~/.claude-code/nsip-logs/
Cache: ~/.claude-code/nsip-cache/ (60-min TTL)
Exports: ~/.claude-code/nsip-exports/
File Structure
nsip/
├── .claude-plugin/
│ └── plugin.json
├── agents/
│ └── shepherd.md
├── commands/
│ ├── consult.md
│ ├── discover.md
│ ├── health.md
│ ├── lineage.md
│ ├── lookup.md
│ ├── profile.md
│ ├── progeny.md
│ ├── search.md
│ ├── test-api.md
│ └── traits.md
├── hooks/
│ ├── hooks.json
│ ├── README.md
│ └── scripts/
│ ├── api_health_check.py
│ ├── auto_retry.py
│ ├── breed_context_injector.py
│ ├── breeding_report.py
│ ├── comparative_analyzer.py
│ ├── csv_exporter.py
│ ├── error_notifier.py
│ ├── fallback_cache.py
│ ├── lpn_validator.py
│ ├── pedigree_visualizer.py
│ ├── query_logger.py
│ ├── result_cache.py
│ ├── smart_search_detector.py
│ └── trait_dictionary.py
├── tests/
│ ├── unit/
│ ├── integration/
│ └── fixtures/
├── nsip.mcp.json
├── CHANGELOG.md
├── LICENSE
└── README.md
Prerequisites