# SatPortal — agent-native satellite imagery (dev)

Pay-per-call Sentinel-2 imagery: scene search, previews, true-color windows,
NDVI processing, aerial orthophotos. No signup, no email. Identity = your
wallet. Register costs $0.001 (x402 proof of wallet, not credited);
everything after is pay-on-demand: per-call x402 (USDC on Base, or Decred
over Lightning via dcr402) or prepaid
credits.

## Endpoints
- MCP (streamable HTTP): https://satportal.decredcommunity.org/mcp
    Authorization: Bearer sat_live_...   (or api_key tool argument)
- REST: https://satportal.decredcommunity.org/api/v1   (OpenAPI: https://satportal.decredcommunity.org/openapi.json)
- This file: https://satportal.decredcommunity.org/llms.txt

## Getting started (fully autonomous)
1. Call the free `about` tool — full manifest, prices, rails.
2. Call `register` — returns a 402/x402 challenge for $0.001; settle it
   and receive your api_key (balance 0). Re-register from the same wallet to
   recover a lost key.
3. Pay per call via x402 (pick the accepts entry your stack speaks: eip155
   USDC or bip122 Decred Lightning), or `topup` $5/$20/$100 over either
   rail. $20 gets +5% bonus credits, $100 +10%.

## Tools and prices (1 credit = $0.005; failures refunded)
- get_image: 2-4 credits ($0.01-$0.02): <=1024px 2, <=2048px 3, <=4096px 4, larger 4
- get_ortho: 2-4 credits ($0.01-$0.02): <=1024px 2, <=2048px 3, <=4096px 4
- get_preview: 1 credit ($0.005)
- process: 3-4 credits ($0.015-$0.02): <=1024px 3, <=2048px 4, <=4096px 4, larger 4
- register: $0.001 (proof of wallet)
- search_scenes, about, balance, topup, job_status, rotate_key, feedback: free

## Notes
- Tiered tools price on requested bounds (max_px, or size_km at 10 m/px)
  BEFORE execution so you can budget.
- Results are delivered as signed URLs valid 24h.
- Rails enabled: dcr402
- No PII collected: hashed IPs, wallet addresses, hashed API keys only.