Web3juice MCP Server

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

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.