zircote

NSIP API Client

active
View on GitHub
Tech Stack:
Python MCP Agriculture AsyncIO

NSIP API Client is a comprehensive Python toolkit for accessing the National Sheep Improvement Program (NSIP) genetic evaluation database, providing both a programmatic API and an MCP server for AI-assisted breeding decisions.

Components

  • nsip-client: Async Python library for direct API access
  • nsip-mcp-server: MCP server enabling Claude to query sheep genetics data
  • Shepherd Agent: AI-powered breeding advisor with regional awareness

Features

  • Access to Expected Breeding Values (EBVs) for 20+ sheep breeds
  • Multi-generational pedigree retrieval
  • Progeny performance analysis
  • Trait-based search and filtering
  • Regional disease and nutrition guidance

Quick Start

from nsip_api_client import NSIPClient

async with NSIPClient() as client:
    # Search for top rams
    results = await client.search_animals(
        breed="Katahdin",
        gender="Ram",
        min_birth_date="2023-01-01"
    )

    # Get pedigree
    lineage = await client.get_lineage("123456", generations=3)

MCP Integration

# Run the MCP server
uvx nsip-mcp-server

Enables natural language queries like:

  • “Find Katahdin rams with WWT above 15”
  • “Calculate ROI for this $2,500 ram purchase”
  • “Show parasite management calendar for Southeast operations”