Skip to main content
Glama

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"}
    }
  }
}

Related MCP server: MoltLlama

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

Tool

What it does

summarize_yields

Market overview for any filter: median and TVL-weighted APY by chain, protocol or strategy.

search_pools

Find and rank pools by token, chain, protocol, APY and TVL.

get_pool

One pool: APY split, TVL, data age, contract and token addresses, deposit and source links, assessment.

get_pool_history

7/30/90-day APY trend with dated samples.

compare_pools

2–5 pools side by side with 30-day ranges.

get_data_sources

Feed health and last update.

get_methodology

How 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 key

Free account key

Pro (£10/month)

Power (£39/month)

Calls per day

500 per address

500

10,000

50,000

Calls per minute

30

30

120

300

Your alerts, notebook, investments, wallets

—

—

yes

yes

Current prices: web3juice.com/pricing.

Configuration

Variable

Default

Purpose

WEB3JUICE_API_KEY

none

Optional key (w3j_…). Without it you get the free limits.

WEB3JUICE_MCP_URL

https://web3juice.com/api/mcp

Server URL. Must be https:// (plain http only for localhost).

WEB3JUICE_MCP_DEBUG

off

Set 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

Problem

Fix

npx not found / server fails to start

Install 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 nothing

Results 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 big

Filters use fractions: 0.05 means 5%.

Licence

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Provides AI assistants with access to real-time DeFi lending rates and yield data across 14+ protocols and multiple blockchains. Enables querying borrow/supply rates, comparing platforms, calculating leverage strategies, and finding best earn opportunities.
    6
    9 npm
    4
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Enables AI agents to discover verifiable DeFi yield opportunities, generate algorithmic portfolio plans, and track cryptographic proof receipts, bridging LLMs with blockchain yield protocols.
    9
    -