English Français العربية

Web3Juice

السجل الرسمي المالية والمدفوعات

Evidence-backed DeFi yield data for ~17,000 pools: rates, yield sources, 90-day history. Read-only.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http web3juice 'https://web3juice.com/api/mcp' --header 'Authorization: <Optional: Bearer w3j_... API key from web3juice.com/?view=account for higher limits and (on Pro) your saved alerts and notebook.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "web3juice": {
            "type": "http",
            "url": "https://web3juice.com/api/mcp",
            "headers": {
                "Authorization": "<Optional: Bearer w3j_... API key from web3juice.com/?view=account for higher limits and (on Pro) your saved alerts and notebook.>"
            }
        }
    }
}
NPM package web3juice-mcp
Claude Code 
claude mcp add web3juice -e 'WEB3JUICE_API_KEY=<your web3juice_api_key>' -- npx -y web3juice-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "web3juice": {
            "command": "npx",
            "args": [
                "-y",
                "web3juice-mcp@1.0.0"
            ],
            "env": {
                "WEB3JUICE_API_KEY": "<your web3juice_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • WEB3JUICE_API_KEY سري Optional Web3Juice API key (w3j_...).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. web3juice-mcp
  2. Quick start
  3. Other clients
  4. Tools
  5. Limits and pricing
  6. Configuration
  7. Security
  8. Troubleshooting
  9. Licence

web3juice-mcp

Evidence-backed DeFi yield data for your AI assistant. Ask Claude, Cursor or any MCP client what ~17,000 DeFi pools pay, where the yield comes from (base vs reward tokens), how it has moved over 90 days and how pools compare — with every number dated and linked to its source.

This package is a tiny, dependency-free bridge from a local stdio MCP client to the hosted Web3Juice MCP server at https://web3juice.com/api/mcp. Clients that support remote servers can connect to that URL directly; see web3juice.com/mcp.

Read-only: it never sees a wallet's keys, signs a transaction or moves funds. Not financial advice.

Quick start

Claude Desktop → Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "web3juice": {
      "command": "npx",
      "args": ["-y", "web3juice-mcp"]
    }
  }
}

Restart Claude Desktop and ask: "What does USDC lending pay on each chain right now?"

Requires Node.js 18.17 or newer.

With an API key (higher limits, your own alerts and notebook on Pro)

Create a key on your Web3Juice account page and add it as an environment variable:

{
  "mcpServers": {
    "web3juice": {
      "command": "npx",
      "args": ["-y", "web3juice-mcp"],
      "env": {"WEB3JUICE_API_KEY": "w3j_your_key_here"}
    }
  }
}

Other clients

Claude Code (remote, no install):

claude mcp add --transport http web3juice https://web3juice.com/api/mcp

Claude Code plugin (this repository is also a plugin marketplace):

claude plugin marketplace add jimbob1414/web3juice-mcp
claude plugin install web3juice@web3juice

Set WEB3JUICE_API_KEY in your environment to use your own limits.

Cursor, VS Code, ChatGPT, Claude.ai and others: see web3juice.com/mcp.

Claude Desktop extension: download web3juice.mcpb from the latest release and open it.

Tools

ToolWhat it does
summarize_yieldsMarket overview for any filter: median and TVL-weighted APY by chain, protocol or strategy.
search_poolsFind and rank pools by token, chain, protocol, APY and TVL.
get_poolOne pool: APY split, TVL, data age, contract and token addresses, deposit and source links, assessment.
get_pool_history7/30/90-day APY trend with dated samples.
compare_pools2–5 pools side by side with 30-day ranges.
get_data_sourcesFeed health and last update.
get_methodologyHow the experimental evidence assessment works.

With a Pro, Power or Team key, read-only workspace tools are added: list_alerts, get_alert, list_notebook_entries, get_notebook_entry, list_investments, list_wallets, get_wallet_positions.

Prompts: find_stablecoin_yields, analyse_pool, compare_yields, yield_market_snapshot. Resources: web3juice://guide, web3juice://methodology, web3juice://data-sources, web3juice://pool/{poolId}.

Limits and pricing

No keyFree account keyPro (£10/month)Power (£39/month)
Calls per day500 per address50010,00050,000
Calls per minute3030120300
Your alerts, notebook, investments, wallets——yesyes

Current prices: web3juice.com/pricing.

Configuration

VariableDefaultPurpose
WEB3JUICE_API_KEYnoneOptional key (w3j_…). Without it you get the free limits.
WEB3JUICE_MCP_URLhttps://web3juice.com/api/mcpServer URL. Must be https:// (plain http only for localhost).
WEB3JUICE_MCP_DEBUGoffSet to 1 to log to stderr.

Security

  • The bridge writes only MCP messages to stdout; diagnostics go to stderr.
  • Your API key is sent only to the configured HTTPS URL, in the Authorization header. It is never logged.
  • Keys can only read. Revoke a key at any time on your account page; the next call fails with a clear message.
  • Pool names and labels come from third-party data sources and are treated as data, not instructions.

Troubleshooting

ProblemFix
npx not found / server fails to startInstall Node.js 18.17+ from nodejs.org, then restart your client.
"API key is not valid or has been revoked"Create a new key on your account page and update WEB3JUICE_API_KEY.
"Daily MCP limit reached"Wait until 00:00 UTC, add a key, or upgrade at web3juice.com/pricing.
Search returns nothingResults default to pools with at least $100K TVL and data under 60 minutes old; ask for smaller pools or older data.
Rates look 100× too bigFilters use fractions: 0.05 means 5%.

Licence

MIT for this bridge. The data and service at web3juice.com are not covered by this licence.

الأسئلة الشائعة

ما هو Web3Juice؟

Evidence-backed DeFi yield data for ~17,000 pools: rates, yield sources, 90-day history. Read-only.

كيف أثبّت Web3Juice؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http web3juice 'https://web3juice.com/api/mcp' --header 'Authorization: <Optional: Bearer w3j_... API key from web3juice.com/?view=account for higher limits and (on Pro) your saved alerts and notebook.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Web3Juice إلى مفتاح API؟

نعم. يتطلب WEB3JUICE_API_KEY, Authorization، وتضبطها في إعداداته.

هل Web3Juice مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Web3Juice؟

ينشره jimbob1414. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.