Metadata-Version: 2.4
Name: meok-koikeeper-ai-mcp
Version: 1.0.3
Summary: Koi-pond MCP server — varieties database (Gosanke + secondary), pond stocking calc, koi-specific diseases (KHV notifiable!), seasonal temperature-gated feeding schedule, UK winter-prep checklist. Powers koikeeper.ai. From MEOK AI Labs.
Project-URL: Homepage, https://koikeeper.ai
Project-URL: Repository, https://github.com/CSOAI-ORG/meok-koikeeper-ai-mcp
Project-URL: Pricing, https://meok.ai/pricing
Author-email: MEOK AI Labs <nicholas@meok.ai>
License: MIT License
        
        Copyright (c) 2026 Nicholas Templeman / MEOK AI Labs
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: aquaculture,japanese-koi,khv,koi,koikeeper,mcp,meok,pond
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: mcp>=1.28.0
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.CSOAI-ORG/meok-koikeeper-ai-mcp -->
[![MCP Scorecard: 80/100](https://img.shields.io/badge/proofof.ai-80%2F100-5b21b6)](https://proofof.ai/scorecard/meok-koikeeper-ai-mcp.html)

<div align="center">

# MEOK KoiKeeper AI MCP

**Koi-pond MCP companion — varieties, diseases, seasonal feeding, winter prep. Powers koikeeper.ai.**

[![PyPI](https://img.shields.io/pypi/v/meok-koikeeper-ai-mcp)](https://pypi.org/project/meok-koikeeper-ai-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![MEOK AI Labs](https://img.shields.io/badge/MEOK_AI_Labs-MCP_Server-purple)](https://meok.ai)

</div>

## Why this exists

Koi keepers operate under a different rulebook to aquarium fish: bigger ponds, longer-lived fish (30-70 years), specialist disease list including **KHV (notifiable under AAHR 2009)** and Carp Edema Virus, and a feeding regime entirely gated on water temperature. This MCP is the koi-pond companion to `meok-fishkeeper-ai-mcp` and the brain behind `koikeeper.ai`.

## Tools

| Tool | Description |
|------|-------------|
| `identify_koi` | Look up koi by variety name (Kohaku, Sanke, Showa, Tancho, Asagi, Shusui, Bekko, Utsurimono, Goshiki, Ogon, Kumonryu, Doitsu Kohaku, Ginrin Kohaku, Chagoi) or by physical description. |
| `pond_stocking` | Pond stocking calc — 1000 L per adult koi rule adjusted for filtration, UV, aeration. |
| `seasonal_feeding` | Temperature-gated feed schedule — wheatgerm at 8-14°C, growth at 14-20°C, **NO FOOD below 4°C**. |
| `diagnose_koi_disease` | Diagnose by symptoms + temp window. Flags KHV as notifiable + provides CEFAS contact. |
| `winter_prep_checklist` | September → February UK winter-prep checklist (netting, aeration, salt overwinter). |
| `list_varieties` | All supported varieties + group classification. |

## Installation

```bash
pip install meok-koikeeper-ai-mcp
```

## Usage with Claude Desktop

```json
{
  "mcpServers": {
    "meok-koikeeper-ai": {
      "command": "python",
      "args": ["-m", "meok_koikeeper_ai_mcp.server"]
    }
  }
}
```

## Pricing (consumer ladder — match koikeeper.ai Stripe)

| Tier | Price | What you get |
|------|-------|--------------|
| Free | £0 | 30 calls/hour. Identify + variety lookup. |
| Pro | £7.99/mo | Unlimited variety/disease lookups + seasonal feeding + winter prep. |
| Premium | £19.99/mo | Pro + multi-pond profiles + KHV/disease early-warning push + private vet referral. |

[koikeeper.ai](https://koikeeper.ai)

## License

MIT © MEOK AI Labs

<!-- meok-moat-footer-v1 -->
---

## Pairs with MEOK Aquatic Suite

- **meok-fishkeeper-ai-mcp** — tropical/marine/coldwater aquarium companion
- **meok-aquaponics-monitor-mcp** (£29-£79/mo) — Sensor layer for koi-pond chemistry (pH/DO/NH3/NO2/NO3/temp)
- **meok-laia-aquatic-mcp** (£29/mo) — England Animal Activities Licensing for koi dealers + breeders
- **meok-uk-fhi-mcp** (£79/mo) — Step up to commercial-scale carp/koi compliance (KHV notification, EA permits)

→ Full catalogue: [meok.ai/aquaponics](https://meok.ai/aquaponics)

<!-- BUY-LADDER:START -->

## Get started (consumer)

- Try free at **[koikeeper.ai](https://koikeeper.ai)** — 3 AI consultations, no signup.
- **KoiKeeper Pro £7.99/mo** — unlimited variety/disease lookups + seasonal feeding + winter prep.
- **KoiKeeper Premium £19.99/mo** — multi-pond profiles + KHV early-warning + vet referral.

For koi-dealer / breeder compliance, see meok-laia-aquatic-mcp (£29/mo) + meok-uk-fhi-mcp (£79/mo).

<!-- BUY-LADDER:END -->

