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:
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:
Other clients
Claude Code (remote, no install):
Claude Code plugin (this repository is also a plugin marketplace):
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
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
Current prices: web3juice.com/pricing.
Configuration
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
Licence
MIT for this bridge. The data and service at web3juice.com are not covered by this licence.