Metadata-Version: 2.4
Name: meok-aquaponics-monitor-mcp
Version: 1.0.0
Summary: Unified sensor + actuator schema MCP for aquaculture / aquaponic / koi systems. Wraps Atlas Scientific EZO, Whitebox Tentacle T1 MkII, Seneye, GHL ProfiLux, Bluelab Edenic, DFRobot Gravity. Species welfare safe-ranges, care-gated actuation, SOV3 attestation handoff. Underwrites MEOK PondSense open hardware. From MEOK AI Labs.
Project-URL: Homepage, https://meok.ai/aquaponics
Project-URL: Repository, https://github.com/CSOAI-ORG/meok-aquaponics-monitor-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 (CSOAI LTD, UK Companies House 16939677)
        
        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.
License-File: LICENSE
Keywords: aquaculture,aquaponics,atlas-scientific,koi,mcp,meok,pondsense,sensor,tentacle
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: System :: Hardware
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

<div align="center">

# MEOK Aquaponics Monitor MCP

**Unified sensor + actuator schema for aquaculture, aquaponics, and koi systems**

[![PyPI](https://img.shields.io/pypi/v/meok-aquaponics-monitor-mcp)](https://pypi.org/project/meok-aquaponics-monitor-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

Every aquaculture monitoring product on the market today picks one hardware family and locks you in: Bluelab cloud-only, Edenic, GHL ProfiLux web API, Atlas Scientific raw I²C, Seneye USB. There is no single SaaS layer that lets a UK trout farm, a hobbyist aquaponic grower, and a high-end koi keeper read their water chemistry through one API — and certainly none that gates every reading against the welfare safe-range for the species in the tank, or routes any actuation through a care membrane before firing a peristaltic pump at live animals.

This MCP is that layer. It is the software side of the **MEOK PondSense** open hardware kit (fork of the OSHWA-certified Whitebox Labs Tentacle T1 MkII baseboard, PA12-CF printed IP67 enclosure on Qidi Max4, optional RPi5 or ESP32-S3 compute, CSOAI stamp).

## Tools

| Tool | Description |
|------|-------------|
| `list_supported_hardware` | Vendor matrix — Atlas Scientific, Whitebox Tentacle, Seneye, GHL ProfiLux, Bluelab, DFRobot. |
| `register_rig` | One-time registration of a sensor rig + species + probes installed. |
| `report_readings` | Push readings; per-parameter status against species safe-range; welfare alerts; signed attestation fingerprint. |
| `safe_range_check` | Stateless: check arbitrary readings against any supported species. |
| `species_catalogue` | List supported species + their welfare safe-range library (RSPCA / WOAH / Stirling OWI derived). |
| `dose_actuator` | Record actuation INTENT (dose pump volume + reason); care-gated by default — routes through SOV3 attestation API before firing. |
| `rig_status` | Last-known state for a registered rig. |

## Installation

```bash
pip install meok-aquaponics-monitor-mcp
```

## Supported species

`rainbow_trout`, `atlantic_salmon_smolt`, `koi`, `tilapia`, `aquaponic_lettuce_companion`, `tropical_community`. Each carries pH / DO / NH3-N / NO2-N / NO3-N / temp / EC / alkalinity safe-ranges sourced from RSPCA Assured, WOAH Aquatic Code, and the Stirling Institute of Aquaculture welfare-indicator toolboxes.

## MEOK PondSense — open-hardware kit

Baseboard fork: [Whitebox Labs Tentacle T1 MkII](https://github.com/whitebox-labs/tentacle) (OSHWA-certified UID CH000003, KiCad public, CC-BY-SA-4.0).

- 4× Atlas Scientific EZO carrier (pH, DO, EC, RTD-temp standard; optional NH3, turbidity, ORP, peristaltic doser)
- Compute: RPi5 or ESP32-S3 (two SKUs)
- Enclosure: PA12-CF printed on Qidi Max4, IP67 gasket, CSOAI stamp 10 mm
- Firmware: ships pre-flashed with this MCP and a care-membrane subscriber
- BoM: £180-£280 hobby / £450-£550 assembled pro with 1yr Pro subscription
- Licence: CERN-OHL-S-2.0 hardware, MIT firmware, AGPL-3.0 MCP

## Pricing

| Tier | Price | What you get |
|------|-------|--------------|
| Hobbyist | £29/mo | 60 calls/hour. 1 rig. Safe-range check + intent attestation. |
| Pro | £79/mo | Unlimited. Multi-rig. Dose actuator hook + welfare-alert webhooks. |
| Enterprise | Custom | Pro + private SOV3 deployment + fleet management. |

[Sign up at meok.ai/pricing](https://meok.ai/pricing)

## License

MIT © MEOK AI Labs

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

## Pairs with MEOK Aquaculture Suite

- **meok-rspca-aquaculture-mcp** (£499/mo) — RSPCA Assured trout + salmon welfare moat.
- **meok-uk-fhi-mcp** (£79/mo) — CEFAS + APHA + EA permit stack.
- **meok-asc-rspca-crosswalk-mcp** (£999/mo) — one audit pack for ASC + RSPCA + GlobalG.A.P.
- **meok-laia-aquatic-mcp** (£29/mo) — England Animal Activities Licensing for ornamental/koi retailers.
- **meok-koikeeper-ai-mcp** (consumer) — koi-specific companion for koikeeper.ai users.

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