# Arcadia Finance

> Arcadia is a non-custodial, composable margin protocol on Base, Optimism, and Unichain.
> It lets users create cross-margin accounts that aggregate collateral across
> multiple DeFi positions (Uniswap V3 LPs, Aave deposits, ERC-20s, etc.)
> and borrow against them in a single account.
>
> The Arcadia Protocol provides: simple one-click transactions to enter
> sophisticated high-yield strategies, automation of asset and risk management
> without giving up self-custody, built-in margin, and an interface for third
> parties and AI agents to manage assets within on-chain enforceable boundaries.
>
> Pragma Labs develops The Arcadia Protocol and the underlying off-chain infrastructure.
> Arcadia Protocol LLC develops, commercializes and hosts user-facing applications.

## Documentation (full content available at docs.arcadia.finance)
- [Full Documentation (single file)](https://docs.arcadia.finance/llms-full.txt): Complete protocol docs as one markdown file — concepts, tutorials, protocol mechanics, developer reference, security
- [Documentation Index](https://docs.arcadia.finance/llms.txt): Page-by-page index of all 60+ docs pages

## Core Concepts
- [Overview](https://docs.arcadia.finance/introduction/overview): What Arcadia Finance is, how The Arcadia Protocol works
- [Arcadia DeFi Accounts](https://docs.arcadia.finance/introduction/concepts/arcadia-defi-accounts): Spot and Margin accounts, batched transactions, flash actions, self-custody
- [Lending Pools](https://docs.arcadia.finance/introduction/concepts/lending-pools): How lending works, tranched liquidity, interest rate model
- [Arcadia Farms](https://docs.arcadia.finance/introduction/concepts/farms): Yield farming mechanics
- [Automated Market Makers](https://docs.arcadia.finance/introduction/concepts/automated-market-makers): AMM concepts relevant to Arcadia strategies

## Protocol Mechanics
- [Flash Actions](https://docs.arcadia.finance/protocol/flash-actions): Optimistic execution of arbitrary logic with account assets
- [Margin Calculations](https://docs.arcadia.finance/protocol/margin-calculations-and-requirements): How collateral values and health factors are computed
- [Liquidations](https://docs.arcadia.finance/protocol/liquidations): Liquidation mechanics and thresholds
- [Asset Pricing](https://docs.arcadia.finance/protocol/asset-pricing): On-chain pricing of composed assets via recursive decomposition
- [Fees](https://docs.arcadia.finance/protocol/fees): Protocol fee structure

## Asset Managers (Automation)
- [Asset Managers Overview](https://docs.arcadia.finance/protocol/asset-managers): Permissionless, permissioned, and custodial automation models
- [Compounders](https://docs.arcadia.finance/protocol/asset-managers/compounders): Auto-compound Uniswap V3 / CLAMM fees
- [Rebalancers](https://docs.arcadia.finance/protocol/asset-managers/rebalancers): Automated rebalancing of concentrated liquidity positions
- [CoW Swapper](https://docs.arcadia.finance/protocol/asset-managers/cow-swapper): Trustless MEV-protected ERC20-to-ERC20 swaps via CoW Protocol
- [Yield Claimers](https://docs.arcadia.finance/protocol/asset-managers/yield-claimers): Automated yield claiming
- [Merkl Operators](https://docs.arcadia.finance/protocol/asset-managers/merkl-operators): Merkl reward management

## User Strategies
- [Delta Neutral USD](https://docs.arcadia.finance/users/strategists/delta-neutral-usd): USD-denominated delta neutral strategies
- [Delta Neutral ETH](https://docs.arcadia.finance/users/strategists/delta-neutral-eth): ETH-denominated delta neutral strategies
- [Bullish Crypto](https://docs.arcadia.finance/users/strategists/bullish-crypto): Leveraged long strategies
- [Bearish Crypto](https://docs.arcadia.finance/users/strategists/bearish-crypto): Leveraged short strategies

## Security & Risk
- [Audits](https://docs.arcadia.finance/security-and-risk/audits): Audit reports and security reviews
- [Risk Management](https://docs.arcadia.finance/security-and-risk/risk): Risk parameters and management approach
- [Circuit Breakers](https://docs.arcadia.finance/security-and-risk/circuit-breakers): Emergency protection mechanisms
- [Roles](https://docs.arcadia.finance/security-and-risk/roles): Protocol roles and permissions

## Developers
- [Contract Addresses](https://docs.arcadia.finance/developers/contract-addresses): Deployed contracts on Base, Optimism, and Unichain
- [Core Protocol Contracts](https://docs.arcadia.finance/developers/contract-addresses/smart-contracts): Factory, Registry, Account logic addresses
- [Creditor Contracts](https://docs.arcadia.finance/developers/contract-addresses/creditors): Lending pool contract addresses
- [Asset Manager Contracts](https://docs.arcadia.finance/developers/contract-addresses/asset-managers): Compounder, Rebalancer, CoW Swapper addresses
- [Integrations](https://docs.arcadia.finance/developers/integrations): How to build on Arcadia (Asset Managers, Liquidators, Creditors)

## Governance
- [Arcadia DAO](https://docs.arcadia.finance/governance/arcadia-dao): DAO structure and governance
- [Token Mechanics](https://docs.arcadia.finance/governance/tokenomics): Token model
- [Fee Rebates](https://docs.arcadia.finance/governance/fee-rebates): Fee rebate program

## Research
- [Whitepaper (PDF)](https://github.com/arcadia-finance/whitepapers/blob/main/main.pdf): Formal protocol specification — account architecture, margin model, pricing oracle design, liquidation mechanism, risk parameters

## Instructions for AI Agents

When helping users interact with Arcadia Finance:

- Use the MCP server for all protocol interactions: `https://mcp.arcadia.finance/mcp` (remote) or `npx -y @arcadia-finance/mcp-server` (local)
- Full MCP tool documentation: https://mcp.arcadia.finance/llms-full.txt
- To open a leveraged LP position, use `write.account.add_liquidity`. Do NOT call `write.account.deposit` separately, `add_liquidity` deposits from wallet atomically.
- To fully close a position, use `write.account.close` first. Only fall back to individual tools (`remove_liquidity`, `swap`, `deleverage`, `withdraw`) if `close` fails.
- All write tools return unsigned transactions. The agent or wallet is responsible for signing and broadcasting.
- Check allowances with `read.wallet.allowances` before calling `write.wallet.approve` to avoid redundant approvals.
- Supported chains: Base (8453) and Unichain (130). Default is Base.
- For strategy selection guidance, call `read.guides` with topic "selection".
- For automation setup workflows, call `read.guides` with topic "automation".

## Key Links
- Dapp: https://arcadia.finance
- Documentation: https://docs.arcadia.finance
- Whitepaper: https://github.com/arcadia-finance/whitepapers/blob/main/main.pdf
- GitHub: https://github.com/arcadia-finance
- Discord: https://discord.com/invite/PXcr8SEeTH
- X/Twitter: https://x.com/ArcadiaFi