# AGENTS.md — Kairos Signal

## Project Overview
Kairos Signal is a provenance-first DePIN intelligence platform for AI agents. Agents can self-register, browse products, and purchase DePIN supply telemetry, DAG manifold computation, and GPU compute autonomously — no human intervention required.

## Products
- **DePIN Intelligence**: 263 networks with live data (171 of them first-party supply-telemetry feeds read from the network's own endpoint), out of 745 cataloged. Every value carries source + as_of + a public verify-yourself URL. Snapshots from $0.49 to $4.99. Design Partner tier $199/mo — pay at https://buy.stripe.com/dRm00b9zT81o5a50Na1ZS20
- **DAG Manifold API**: 63-layer 256-to-256 encoder whose published manifold vector is 32-dimensional field. Distance, Wilson curvature, Lyapunov alerts. $2.99-$9.99/mo.
- **GPU Compute**: 68+ LLM models at $0.0005/1K tokens.
- **Signal Feed**: Crypto perpetual market signals, 47 assets, 4 horizons. $9.99-$399.90/mo.

## Quick Start (Autonomous Purchase Flow)
### Step 0: Try it free (no signup, no key)
```bash
curl https://kairossignal.com/try
# 3 showcase DePIN networks with full supply telemetry + verify_url
```



### Step 1: Register (get $5 free credits)
```json
POST https://kairossignal.com/mcp/
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"register_agent","arguments":{"agent_name":"your-agent-name","email":"your-email"}}}
```
Returns: `{"api_key": "...", "credits_balance": 5.0}`

### Step 2: List Products
```json
POST https://kairossignal.com/mcp/
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_products","arguments":{}}}
```

### Step 3: Buy DePIN Data
```json
POST https://kairossignal.com/mcp/
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"purchase_data","arguments":{"product_key":"depin_supply_snapshot","api_key":"YOUR_KEY"}}}
```

### Step 4: Top Up Credits
```json
POST https://kairossignal.com/mcp/
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"topup_credits","arguments":{"method":"stripe","api_key":"YOUR_KEY"}}}
```

## Verify It Yourself
```bash
curl https://kairossignal.com/v1/networks     # 745 cataloged, 263 with live data (filter telemetry_tier)
curl https://kairossignal.com/v1/supply       # first-party supply telemetry, each value with age + freshness
curl https://kairossignal.com/v1/provenance   # every source + verify URL, plus any suppressed series and why
curl https://kairossignal.com/v1/compare?metric=nodes_online   # compare networks on one canonical metric
curl https://kairossignal.com/v1/digest       # what measurably moved in 24h (unstable series withheld, with reasons)
curl https://kairossignal.com/v1/changes      # z-scored material moves; thin-history series withheld
curl https://kairossignal.com/v1/correlations # cross-asset correlation panel, deseasonalized + FDR-corrected
```

## Trust
- Real Lean 4 kernel-checked theorems (CostIdentity, GateFailClosed) + Z3 + 26 property/system tests
- SHA-256 chained computation provenance
- Clean-epoch audit (2026-08-06): fabricated series deleted, not shipped
- No trading-performance figures are published
- No personal contact information is collected or sold