ivpools

Official Python SDK for IVPools AI Engineering API.

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

Install

pip install ivpools

Quick Start

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)

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

MCP Integration

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