Web3Juice
Evidence-backed DeFi yield data for ~17,000 pools: rates, yield sources, 90-day history. Read-only.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
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.>'{
"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.>"
}
}
}
}web3juice-mcpclaude mcp add web3juice -e 'WEB3JUICE_API_KEY=<your web3juice_api_key>' -- npx -y web3juice-mcp@1.0.0{
"mcpServers": {
"web3juice": {
"command": "npx",
"args": [
"-y",
"web3juice-mcp@1.0.0"
],
"env": {
"WEB3JUICE_API_KEY": "<your web3juice_api_key>"
}
}
}
}Environment variables
WEB3JUICE_API_KEYsecret Optional Web3Juice API key (w3j_...).
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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/mcpClaude Code plugin (this repository is also a plugin marketplace):
claude plugin marketplace add jimbob1414/web3juice-mcpclaude plugin install web3juice@web3juiceSet 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
Authorizationheader. 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.
Frequently asked questions
What is Web3Juice?
Evidence-backed DeFi yield data for ~17,000 pools: rates, yield sources, 90-day history. Read-only.
How do I install Web3Juice?
It runs as a remote server. In 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.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Web3Juice need an API key?
Yes. It expects WEB3JUICE_API_KEY, Authorization, which you set in its configuration.
Is Web3Juice open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Web3Juice?
It is published by jimbob1414. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.