# SynthOS

AI-powered DeFi yield routing. Deposit into risk-scored yield bundles, analyze wallets, get AI recommendations via bull/bear/moderator debate, and manage cross-chain positions. 11 tools, zero API key…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add theSynthOS/yield

# Browse available tools
npx -y @smithery/cli@latest tool list theSynthOS/yield

# Get full schema for a tool
npx -y @smithery/cli@latest tool get theSynthOS/yield synthos_check_yields

# Call a tool
npx -y @smithery/cli@latest tool call theSynthOS/yield synthos_check_yields '{}'
```

## Direct MCP Connection

Endpoint: `https://yield--thesynthos.run.tools`

**Optional config:**
- `walletAddress` (query) — Your default Ethereum wallet address (0x...). Used as the default for all tool calls.
- `preferredChain` (query) — Preferred chain for operations (e.g., scroll, base, arbitrum). Default: scroll.
- `riskTolerance` (query) — Your risk tolerance level. Affects AI recommendations.

## Tools (13)

- `synthos_check_yields` — Browse current DeFi yield opportunities across EVM chains with APY and risk data. Use this to see what's available befo…
- `synthos_portfolio` — Check current SynthOS positions, allocation breakdown, and weighted APY for a wallet.
- `synthos_deposit` — Deposit assets into your SynthOS vault. The vault holds funds that can then be allocated to yield strategies.
- `synthos_withdraw` — Withdraw assets from your SynthOS vault back to your wallet or a specified address.
- `synthos_strategy_deposit` — Deposit into a specific cross-chain yield strategy by protocol ID. Use synthos_check_yields first to find protocol IDs.
- `synthos_strategy_withdraw` — Withdraw from a specific strategy position. Use synthos_portfolio to see your position indices.
- `synthos_get_recommendation` — Get an AI-recommended diversified yield bundle tailored to the wallet's risk profile. Analyzes the wallet first (if not…
- `synthos_analyze_wallet` — Perform a full AI analysis of a wallet — risk profile, on-chain behavior, DeFi positions, idle assets, and personalized…
- `synthos_rebalance` — Compare current positions against optimal allocation and get rebalance suggestions. Optionally auto-execute the rebalan…
- `synthos_set_preferences` — Set yield selection rules for a wallet. These preferences are applied to recommendations and rebalance suggestions for …
- `synthos_migrate` — Find yield migration opportunities — compare external DeFi positions against SynthOS protocols to find better risk-adju…
- `synthos_get_risk_scores` — Get detailed risk scores and risk component breakdown for all yield protocols. Shows security, liquidity, maturity, and…
- `synthos_buy_crypto` — Generate a payment link to buy crypto (USDC/USDT) with a credit card or bank transfer. The user clicks the link, comple…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get theSynthOS/yield <tool-name>
```

## Prompts (5)

- `start-earning-yield` (walletAddress) — Get started with DeFi yield — analyzes your wallet, recommends strategies, and guides you through your first deposit.
- `portfolio-review` (walletAddress) — Review your current yield positions — check performance, compare against optimal allocation, and suggest improvements.
- `find-best-yields` (token, minApy) — Browse and compare the best yield opportunities across all supported chains and protocols.
- `migration-check` (walletAddress) — Check if you're earning the best yield — compare your external DeFi positions against SynthOS alternatives.
- `buy-and-earn` (fiatAmount, walletAddress) — Buy crypto with fiat and start earning yield in one flow — generates a payment link, then guides you through depositing…