DeFi Orbit AI: MCP Server for DeFi Position Data A hosted MCP server with read-only tools for LP and lending data. Connect Claude or Cursor and ask about positions in plain language. Canonical: https://defiorbit.xyz/products/defi-orbit-ai --- [Products](/#products)/DeFi Orbit AI # Position-level DeFi data for AI agents Our MCP server gives Claude, Cursor and any compatible agent direct access to LP and lending positions: value, PnL, fees, health factor and history. Read-only, with the same key and credits as the API. [Connect your agent](#connect)[Get API key](https://platform.defiorbit.xyz) Works with Claude, Cursor, VS Code and any MCP-compatible client. agent · defiorbitexample Is my Aave position on Base at risk of liquidation? tool call · Aave V3 position risk✓ 8 credits Your health factor is **1.42**. You have $5,085.89 in collateral against $2,854.38 of debt, for a net worth of $2,231.51. The collateral is WETH and WSTETH. 01 / Connect ## Connect in three steps Nothing to install or host. The server runs on our side, and your client connects to it with an API key. 01 Create an account Sign up at [platform.defiorbit.xyz ↗](https://platform.defiorbit.xyz). It is self-serve. 02 Generate an API key The same key works for the REST API and for DeFi Orbit AI. 03 Add the server to your client Paste the config, replace with your key and restart the client. If your client cannot send custom headers, a query-parameter form is available in the platform. MCP config · headerrecommended⧉ Copy ``` { "mcpServers": { "defiorbit": { "url": "https://mcp.defiorbit.xyz/mcp", "headers": { "Authorization": "Bearer " } } } } ``` ![Claude](https://cdn.simpleicons.org/claude) ### Claude Desktop and Claude Code ![Cursor](https://cdn.simpleicons.org/cursor) ### Cursor Agent and chat ![VS Code](/assets/ext/si/visualstudiocode.svg) ### VS Code MCP-enabled assistants ![Any MCP client](https://cdn.simpleicons.org/modelcontextprotocol) ### Any MCP client Custom agents and internal tools 02 / What your agent can do ## Ask in plain language, get position-level answers The agent picks the right tool, calls it and reads the result. You do not write queries or parse responses. LP positionsuniswapv3-listActive and closed positions for a wallet, with range status, value, fees and PnL.Lending riskaavev3-riskHealth factor, liquidation distance, collateral and debt per asset.History and performanceuniswapv3-snapshotsDeposits, withdrawals, fee collections and daily snapshots for any position.Whole-wallet portfolioportfolioTokens, protocols and chain exposure for an EVM wallet, with a total USD value. agent · defiorbitexample Which of my Uniswap V3 positions are out of range right now? tool call · uniswapv3-list✓ 2 credits 2 of your 7 active positions are out of range. Both are on Base and have earned no fees since they left range. PairChainRangeValue WETH/USDC 0.05%BaseOut$12,408.20 cbBTC/WETH 0.3%BaseOut$4,915.66 USDC/HYPE 0.3%UnichainIn$8,262.86 How far is this wallet from liquidation on Aave? tool call · aavev3-risk✓ 8 credits Health factor is 1.42. WETH would need to fall 29.6%, to $1,812.40, before the position can be liquidated. AssetSideValueLiq. price WETHCollateral$3,412.10$1,812.40 WSTETHCollateral$1,673.79$2,140.55 USDCDebt$2,854.38— Summarise what this position earned in fees last month. tool call · uniswapv3-snapshots✓ 2 credits Position #119128 earned $412.88 in fees in September, an average of $13.76 a day, at a 21.84% APR. WeekFeesAPR Sep 1–7$88.1219.10% Sep 8–14$121.4026.32% Sep 15–21$97.5521.15% Sep 22–30$105.8120.79% What is this wallet worth, and how is it split across chains? tool call · portfolio✓ The wallet holds $1,388,136.22 across 4 chains. 70.3% of it sits on Polygon. ChainValueShare Polygon$975,770.6970.3% Base$214,402.1815.4% Arbitrum$118,331.058.5% Ethereum$79,632.305.8% 03 / Tools ## 54 read-only tools, grouped by protocol Every tool is read-only. None of them can move funds or change on-chain state. Uniswap V310Aerodrome10Orca4Aave V38Morpho Blue8Kamino8Portfolio2Usage2 Uniswap V3 tool What it returns uniswapv3-summary Wallet-level position counts, active and inactive. uniswapv3-list LP positions for a wallet, with detailed payloads on request and closed positions by status. uniswapv3-batch Positions for multiple wallets in one call, up to 20. uniswapv3-get Raw on-chain state for a single position: ticks, pool, tokens, liquidity. uniswapv3-events Position history: deposits, withdrawals, collections, token prices and transaction hash. uniswapv3-snapshots Historical performance, one row per UTC day: value, fees, rewards, APR. uniswapv3-snapshot Current health check: value, in or out of range, PnL and APR. uniswapv3-pnl Position profit and loss: PnL, impermanent loss, HODL benchmark, realized and unrealized. uniswapv3-yield Fee and reward accrual: APR, total, claimed and unclaimed fees and rewards. uniswapv3-full Full position detail: state, events, PnL, IL, fees, APR and TWIC in one call. Aerodrome tool What it returns aerodromev3-summary Wallet-level Slipstream position counts on Base, active and inactive. aerodromev3-list Slipstream LP positions for a wallet on Base, with closed positions by status. aerodromev3-batch Positions for multiple wallets in one call, up to 20. aerodromev3-get Raw on-chain state for a single Slipstream position: ticks, pool, tokens, liquidity. aerodromev3-events Position history: deposits, withdrawals, collections, token prices and transaction hash. aerodromev3-snapshots Historical performance, one row per UTC day: value, fees, AERO rewards, APR. aerodromev3-snapshot Current health check: value, in or out of range, PnL and APR. aerodromev3-pnl Position profit and loss: PnL, impermanent loss, HODL benchmark, realized and unrealized. aerodromev3-yield Fee and AERO reward accrual: APR, total, claimed and unclaimed. aerodromev3-full Full position detail: state, events, PnL, IL, fees, AERO rewards and APR. Orca tool What it returns orca-summary Wallet-level position counts on Solana, active and inactive. orca-list LP positions for a Solana wallet, with detailed payloads on request. orca-batch Positions for multiple Solana wallets in one call, up to 25. orca-get Raw position state by position ID. Aave V3 tool What it returns aavev3-summary Wallet summary per chain: at-risk flag (health factor below 1.5) and activity status. aavev3-bundle Live positions with calculations per chain. Optional market and target health factor. aavev3-list-positions Raw live positions per chain, without full calculations. aavev3-batch Bundles for multiple wallets in one call, up to 10. aavev3-events Supply, withdraw, borrow, repay and liquidation history for a wallet on one chain. aavev3-snapshots Historical performance as daily snapshots. aavev3-risk Risk metrics: health factor, LTV, safe borrow and withdraw amounts, asset metrics. aavev3-yield Yield metrics: daily interest, net APY, leverage, weighted supply and borrow APY, projections. Morpho Blue tool What it returns morpho-summary Wallet summary per chain: at risk when any isolated market has a health factor below 1.5. morpho-bundle Live positions with calculations, one bundle per chain. Each position is an isolated market. morpho-list-positions Raw live positions per chain, without full calculations. morpho-batch Bundles for multiple wallets in one call, up to 10. morpho-events Supply, withdraw, borrow, repay and liquidation history, by market. morpho-snapshots Historical performance as daily snapshots, optionally by market. morpho-risk Risk for one isolated market: health factor, LTV, LLTV, safe borrow and withdraw. morpho-yield Yield for one isolated market: daily interest, net APY, leverage, projections. Kamino tool What it returns kamino-summary Wallet summary on Solana: total obligations and at-risk flag (health factor below 1.5). kamino-bundle Obligations with calculations per wallet: position data, health factor, APY, projections. kamino-list-positions Obligations without calculations. A lighter read for discovering obligation addresses. kamino-batch Bundles for multiple Solana wallets in one call, up to 5. kamino-events Raw obligation history. kamino-snapshots Historical performance: collateral, debt, net worth and health factor over time. kamino-risk Risk metrics for a single obligation: health factor, LTV, safe borrow and withdraw amounts. kamino-yield Yield metrics for a single obligation: daily interest, net APY, weighted supply and borrow APY. Portfolio tool What it returns portfolio-assets Full DeFi portfolio breakdown for an EVM wallet: tokens, protocols, chain exposure. portfolio-balance Wallet total USD value and per-chain exposure summary. Usage tool What it returns usage-logs Paginated API request logs for your organization. Filter by time range, API key, path and status. usage-credits Remaining credits for your organization, split into grants and purchased credits. 54 tools across six protocols, plus wallet portfolio and account usage. [See all endpoints and credit costs →](/products/api-platform) 04 / AI or API ## Same data, two ways to reach it Use DeFi Orbit AI when an agent is doing the work. Use the API when your own code is. DeFi Orbit AI (MCP)When an agent does the work API Platform (REST)When your code does the work Who calls it An AI agent, during a conversation Your own code Setup Paste a config into your client Write an integration Authentication Your API key The same API key Billing Credits, same cost as the matching endpoint Credits, fixed cost per endpoint Rate limit Same limit as the key Per key Best for Research, monitoring, reports and internal assistants Products, dashboards and data pipelines Writing code with an AI assistant? The platform includes LLM instructions you can hand to it so it calls the REST API correctly. 05 / Control ## An agent that can read, and nothing else Giving an agent access to financial data should not mean giving it access to funds. ### Read-only No tool can sign, send or change anything on-chain. ### No wallet connection The agent works from public wallet addresses. No private keys, no custody. ### Spend you can cap Calls draw from prepaid credits, so an agent cannot spend more than you loaded. ### A key you can revoke Give each agent its own key and turn it off whenever you need to. 06 / FAQ ## Questions What is DeFi Orbit AI? It’s our hosted MCP server, which is the standard way to give an AI assistant tools it can call. Connect it to the assistant you already use and it can read your LP and lending positions with live data, so you can ask “which of my positions are out of range?” and get an answer from the chain, not from the model’s memory. There’s nothing to install or run on your side. Which clients work? Any client that supports MCP, which today includes Claude Desktop, Claude Code and Cursor, among others. Setup is a few lines of configuration with the server address and your API key, and the connection guide in the docs covers each client. Does it cost extra? No. DeFi Orbit AI uses the same API key and the same credits as the API, and each tool call costs the same as the endpoint behind it. Two of the 54 tools report your usage, so the assistant itself can tell you what you’ve spent. Can the agent move my funds? No. All 54 tools are read-only: they return data and cannot sign, send, approve or change anything on-chain. The server never holds keys, so there’s nothing it could act with even if an agent asked. Do I need an account? You need an API key, which you create at platform.defiorbit.xyz. The Starter pack is 500 credits for $10, enough to connect an assistant and try every tool against real wallets. Which protocols are covered? Uniswap V3, Aerodrome and Orca for liquidity, and Aave, Morpho and Kamino for lending, with portfolio tools for EVM wallets. That’s 54 tools in total, and new API endpoints become tools as they ship. What can I ask it? Anything the data can answer: the fees a position has earned this month, which positions are out of range, the health factor on a lending position, or a summary of a wallet’s performance. The assistant picks the right tools and combines them, so you ask in plain language rather than learning endpoints. Where does my data go? DeFi Orbit returns data only to the client that requested it. What happens next depends on the assistant you use, since its model provider processes the conversation, so choose a client whose data terms you’re comfortable with. ## Connect your agent today Start with 500 credits for $10. No subscription. [Get API key](https://platform.defiorbit.xyz)[Book a demo](/book-a-demo) × Book a demo ## See how DeFi Orbit fits your stack Thirty minutes with the team. Bring a wallet address and the report you wish you had. - A walkthrough using your positions, not sample data - Which product fits: Portfolio, the API or both - Pricing for your wallets, clients and volume Just want to try it? [Get an API key](https://platform.defiorbit.xyz) or[launch the app](https://app.defiorbit.xyz). 1. 1 · Your details 2. 2 · Pick a time ## Pick a time, there 30 minutes · Video call · Your details are filled in for you ← Edit details[Open the calendar in a new tab ↗](#)