Metadata-Version: 2.4
Name: ivpools
Version: 3.0.0
Summary: Official Python SDK for IVPools AI Engineering API — pool, PV, sauna, and irrigation quotations for AI agents.
Author-email: Ivpools LTD <sales@ivpools.eu>
License: MIT
Project-URL: Homepage, https://ivpools.eu
Project-URL: Repository, https://github.com/ivpools/agent-sdk-python
Project-URL: Issues, https://github.com/ivpools/agent-sdk-python/issues
Keywords: ivpools,ai,agent,mcp,pool,engineering,saas,api
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0

# ivpools

Official Python SDK for **IVPools AI Engineering API**.

Pool, PV, sauna, and irrigation engineering calculations for AI agents.

## Install

```bash
pip install ivpools
```

## Quick Start

```python
import os
from ivpools import IVPools

client = IVPools(api_key=os.environ['IVPOOLS_API_KEY'])

# Get product price ($0.001)
price = client.get_price(category='pump', volume=20)

# Generate engineering quote ($0.005)
quote = client.create_quote(
    type='overflow_pool', length=8, width=4, depth=1.5
)

# Solve complete engineering problem ($0.100)
solution = client.solve(
    pool={'length': 8, 'width': 4, 'depth': 1.5, 'type': 'overflow_pool'},
    budget=20000,
    requirements=['heat pump', 'LED lighting']
)

print(f"Cost: €{solution['cost']}")
print(f"Status: {solution['engineering']['status']}")
print(f"Certificate: {solution['certificate']['certificate_id']}")
```

## Sandbox (no API key needed)

```python
sandbox = IVPools(sandbox=True)
price = sandbox.get_price(category='pump', volume=20)
```

## MCP Integration

```python
mcp = IVPools(api_key=os.environ['IVPOOLS_API_KEY'])
tools = mcp.list_tools()
result = mcp.call_tool('ivpools_solve', {
    'pool': {'length': 8, 'width': 4, 'depth': 1.5},
    'budget': 20000
})
```

## Features

- ✅ MCP 2026-07-28 compliant (stateless HTTP)
- ✅ Reserve-then-commit billing (atomic)
- ✅ Idempotency support (safe retries)
- ✅ Deterministic engineering engine
- ✅ Signed certificates (Ed25519)
- ✅ No dependencies (pure Python stdlib)

## License

MIT
