docs: comprehensive README — tool catalog, pricing, MCP connect, ToolOracle ecosystem

Author: ToolOracle

README.md

@@ -1,56 +1,61 @@
-# YieldOracle — DeFi Yield Intelligence MCP Server
+# 📈 yieldOracle
 
-> Top yields, risk-adjusted APY, stablecoin safe havens, RWA yields, protocol comparison. 19,000+ pools, 100+ chains.
+**Market & Crypto MCP Server** — 0 tools | Part of [ToolOracle](https://tooloracle.io)
 
-**Part of [ToolOracle](https://tooloracle.io) — Policy-enforced, tier-gated, usage-metered tool execution**
+![Tools](https://img.shields.io/badge/MCP_Tools-0-10B898?style=flat-square)
+![Status](https://img.shields.io/badge/Status-Live-00C853?style=flat-square)
+![Tier](https://img.shields.io/badge/Tier-Free-2196F3?style=flat-square)
 
-## Connect
+## Quick Connect
 
 ```bash
+# Claude Desktop / Cursor / Windsurf
 npx -y mcp-remote https://tooloracle.io/yield/mcp/
 ```
 
-## x402 Pay-per-call (autonomous agents)
-
-```
-POST https://tooloracle.io/x402/yield/mcp/
-→ 402 with structured pricing → Send USDC on Base → Retry with X-PAYMENT header
+```json
+// claude_desktop_config.json
+{
+  "mcpServers": {
+    "yieldoracle": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://tooloracle.io/yield/mcp/"]
+    }
+  }
+}
 ```
 
-## 8 Tools · 1 unit = $0.01
+## Tools (0)
 
-| Tool | Units | Price | Tier |
-|------|-------|-------|------|
-| `risk_adjusted` | 10 | $0.10 | Premium |
-| `yield_compare` | 8 | $0.08 | Deep |
-| `rwa_yield` | 5 | $0.05 | Deep |
-| `top_yields` | 3 | $0.03 | Standard |
-| `stablecoin_yield` | 3 | $0.03 | Standard |
-| `chain_yields` | 3 | $0.03 | Standard |
-| `yield_scan` | 2 | $0.02 | Standard |
-| `health_check` | 0 | free | — |
+| Tool | Description |
+|------|-------------|
 
-## Risk-adjusted scoring
+## Pricing
 
-`risk_adjusted` calculates real expected return: APY × (1 - risk_score/100). Risk factors: APY sustainability, TVL depth, impermanent loss, APY volatility, stablecoin status.
+| Tier | Rate Limit | Price |
+|------|-----------|-------|
+| Free | 100 calls/day | €0 |
+| Pro | 10,000 calls/day | €29/month |
+| Enterprise | Unlimited | Custom |
 
-## RWA tracking
+> Free tier includes all tools with rate limiting. Upgrade for higher limits and priority support.
 
-`rwa_yield` tracks tokenized treasury and Real World Asset yields from Ondo, BlackRock, Mountain Protocol, Maple, Centrifuge, Goldfinch, and 10+ more.
+## Part of ToolOracle
 
-## Tier gating
+yieldOracle is one of **42 specialized MCP servers** in the [ToolOracle](https://tooloracle.io) ecosystem — the largest collection of production-ready MCP tools for AI agents.
 
-| Tier | Max/call | Blocked |
-|------|----------|---------|
-| Free ($0) | 3 units | risk_adjusted |
-| Starter ($49/mo) | 8 units | — |
-| Pro+ / x402 | 15 units | — |
 
-## Data
 
-19,000+ pools · 100+ chains · 500+ protocols · DeFiLlama Yields API (free, no key) · 5-min cache
+**Related Oracles:**
+- [FeedOracle](https://feedoracle.io) — Evidence-grade compliance data infrastructure
+- [ToolOracle](https://tooloracle.io) — 42 Oracles, 390+ MCP Tools
 
 ## Links
 
-- [ToolOracle](https://tooloracle.io) · [x402 Gateway](https://tooloracle.io/x402/)
-- [RankOracle](https://github.com/ToolOracle/rankoracle) · [ShopOracle](https://github.com/ToolOracle/shoporacle) · [MemeOracle](https://github.com/ToolOracle/memeoracle) · [SmartMoneyOracle](https://github.com/ToolOracle/smartmoneyoracle)
+- 🌐 Live: `https://tooloracle.io/yield/mcp/`
+- 📚 Docs: [tooloracle.io/docs](https://tooloracle.io/docs)
+- 🏠 Platform: [tooloracle.io](https://tooloracle.io)
+
+---
+
+*Built by [FeedOracle](https://feedoracle.io) — Evidence by Design*