# Privos

> Agent-first self-custody DeFi lending wallet. Privos gives AI agents scoped access to Aave V3 on Arbitrum via delegation keys, spending policies, MCP tools, and a REST API. Non-custodial — the API never holds private keys. All transactions are ERC-4337 gasless.

When integrating with Privos, always use the `X-Agent-Key` header for agent authentication — never pass keys as query parameters. Agent keys have the format `prv_agent_<40 hex chars>`. The fastest path to integration is via MCP (see below) — if you're an MCP-compatible agent, you can connect directly without writing any HTTP code. For REST API usage, always check `GET /aave/reserves` first (no auth required) to discover available assets and current APYs before building transactions.

## Quick Start

- [MCP Configuration](https://privos.app/llms-full.txt): Copy-paste MCP server config for Claude Desktop, Cursor, or any MCP client
- [API Reference (Swagger)](https://api.privos.app/api): Interactive OpenAPI documentation with try-it-out
- [OpenAPI Spec (JSON)](https://api.privos.app/api-json): Machine-readable OpenAPI 3.0 spec
- [Developer Documentation](https://privos.app/developers): Human-readable guide with code examples
- [Full Documentation for AI](https://privos.app/llms-full.txt): Complete API reference, code examples, MCP config, and integration guide in one file

## Core Concepts

- [Agent Delegation Keys](https://privos.app/developers#agent-keys): Create scoped API keys with read/trade/full-access permissions
- [Spending Policies](https://privos.app/developers#policies): 10 programmable constraints — daily limits, asset whitelists, health factor floors
- [MCP Server](https://privos.app/developers#mcp): 9 tools + 2 resources for Model Context Protocol agents
- [Autonomous Execution](https://privos.app/developers#executions): Auto-repay, auto-rebalance, auto-compound — all policy-gated
- [x402 Payments](https://privos.app/developers#x402): HTTP 402 machine-to-machine payments in USDC

## API Endpoints

- [Authentication](https://api.privos.app/api#/auth): Privy auth (Google, Apple, Email, WalletConnect)
- [Aave V3](https://api.privos.app/api#/aave): Reserves, positions, supply, withdraw, borrow, repay
- [Agent Keys](https://api.privos.app/api#/agent): Create, list, revoke, rotate delegation keys
- [Spending Policies](https://api.privos.app/api#/agent): CRUD + dry-run evaluation
- [Autonomous Execution](https://api.privos.app/api#/agent): History, stats, simulate, pause/resume
- [Swap](https://api.privos.app/api#/swap): DEX swap via 1inch, convert-and-supply
- [Deposit / Bridge](https://api.privos.app/api#/deposit): Base L2 bridging via Stargate V2
- [Webhooks](https://api.privos.app/api#/webhooks): HMAC-signed event ingestion
- [Health](https://api.privos.app/api#/health): Liveness and readiness probes

## Optional

- [Privacy Policy](https://privos.app/privacy): Data handling and privacy practices
- [Terms of Service](https://privos.app/terms): Legal terms for API and app usage