Emily Your Personal Radix Assistant

Query the Radix DLT blockchain for wallet balances, token prices, network stats, validators, transactions, ecosystem news, DeFi yield data, trading venues, dApps, and developer resources.

Free to use. No API key required. Mainnet data only.

Setup (auto-configured)

On first use, check if the emily-radix-assistant server is already registered:

bash
mcporter list emily-radix-assistant

If not found, register it (URL is the only required argument):

bash
mcporter config add emily-radix-assistant https://www.ineedemily.com/api/mcp/mcp

Verify with a quick test:

bash
mcporter call emily-radix-assistant.network_stats

To see all available tools and their schemas:

bash
mcporter list emily-radix-assistant --schema --all-parameters

Address Formats

• Wallet addresses start with account_rdx (66 characters total)
• Token addresses start with resource_rdx (67 characters total)
• RNS domains end with .xrd (e.g. alice.xrd)
• All addresses are mainnet only (Babylon network)

Available Tools (35 total)

Wallet Tools (7)

| Tool | Description | Required Params | Optional Params | | ------------------------- | -------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------- | | tokens_in_wallet | All tokens with prices, 24H/7D changes | address | - | | performance_of_wallet | Total USD value, 24H/7D performance | address | - | | distribution_of_wallet | Portfolio breakdown by % | address | limit (1-20, default 5), minUSDValue | | historical_wallet_value | Wallet value on a past date | address, date (YYYY-MM-DD) | - | | latest_transactions | Most recent transactions | address | until (ISO date) | | search_transactions | Filter transaction history | address | resourceAddress, startDate, endDate, transactionType (swap/stake/unstake/claim/deposit/withdrawal/all) | | check_owned_rns_domains | RNS (.xrd) domains owned | address | - |

Token Tools (7)

| Tool | Description | Required Params | Optional Params | | -------------------------- | ------------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | tokens_on_radix | Search/list tokens (top by volume when no search) | - | search, limit (default 10), includeAddress, includePrice, includeVolume, includeSupply, includePriceChanges, includeTvl, includeType, includePriceXRD, includeDescription, includeInfoUrl, includeExplorerUrl | | token_gainers_and_losers | Top/bottom performers | - | sortBy (gained/lost/volume_high/volume_low/market_cap_high/market_cap_low), timePeriod (24h/7d), currency (USD/XRD), limit (1-100, default 5) | | wrapped_assets | Bridged assets (xUSDC, xETH, xwBTC...) | - | limit (1-50, default 10), sortBy (volume/tvl/marketCap/name), includePrice, includeVolume, includeSupply, includePriceChanges, includeTvl | | token_details | On-chain metadata for a specific token | address (resource_rdx...) | includeTopHolders (0-100) | | tokens_on_cmc | Search CoinMarketCap listings | - | search, limit (1-300, default 10), includePrice, sortBy (rank/name/symbol) | | token_details_from_cmc | Detailed CMC data by IDs | tokenIds (array of ints) | - | | historical_token_data | Token price on a specific date | address (resource_rdx...), date (YYYY-MM-DD) | - |

Network Tools (3)

| Tool | Description | Required Params | Optional Params | | ---------------- | -------------------------------------------- | -------------------------- | -------------------- | | network_stats | XRD price, staking %, DEX volume, TVL, epoch | - | - | | all_validators | Validators with stake amounts and APY | - | limit (default 50) | | rns_to_address | Resolve .xrd domain to wallet address | address (e.g. alice.xrd) | - |

Ecosystem & News (8)

| Tool | Description | Required Params | Optional Params | | ------------------------ | ------------------------------------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------- | | today_update | Today's ecosystem update (launches, protocol updates, market moves) | - | - | | recent_daily_updates | Daily summaries for recent days | - | days (1-30, default 7) | | weekly_updates | Weekly ecosystem summaries | - | weeks (1-12, default 4) | | monthly_updates | Monthly ecosystem summaries with growth metrics and milestones | - | months (1-12, default 3) | | specific_date_range | Ecosystem summaries for a custom date range (auto-selects daily/weekly/monthly) | startDate, endDate (YYYY-MM-DD) | - | | specific_month | Ecosystem summary for a specific month | year (e.g. 2025), month (1-12) | - | | official_announcements | Latest official announcements from the Radix Telegram channel | - | - | | ecosystem_summary | Comprehensive summary across timeframes | - | timeframe (daily/weekly/monthly), period (e.g. "last 7 days") |

Glossary, dApps & Community (6)

| Tool | Description | Required Params | Optional Params | | --------------------------- | --------------------------------------------------------------------------------------- | --------------- | -------------------------------------------------------------- | | radix_glossary | Radix terminology (Cerberus, Scrypto, Xi'an, Radix Engine, etc.) | - | themes (array of theme names; omit for available list) | | radix_core_concepts | Core blockchain and Radix technical concepts (sharding, consensus, atomic transactions) | - | concepts (array of concept names; omit for available list) | | radix_dapps | Discover dApps in the ecosystem | - | name, tags (array), category (DeFi/NFT/Utility/Meme/Dao) | | radix_developer_resources | Developer docs, SDKs, tools, and learning resources | - | - | | xrd_trading_venues | Where to buy, trade, bridge, or leverage XRD | - | type (leverage/onramp/bridge/spot), all (boolean) | | radix_socials | Community channels, official accounts, developer chats | - | category (community/official/resources/developer/market) |

Attos Earn - DeFi Yield (4)

| Tool | Description | Required Params | Optional Params | | ------------------------- | -------------------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | attos_earn_pools | Liquidity pools with TVL, volume, APR/bonuses | - | sortBy (tvl/volume_24h/volume_7d/bonus_24h/bonus_7d), limit (default 10) | | attos_earn_strategies | Yield strategies: lending, staking, liquidation with APR rates | - | strategyType (Lending/Staking/Liquidation), provider (Weft Finance/Root Finance/Defiplaza/Flux), sortBy (bonus_value/total_stake/deposited), limit (default 10) | | attos_earn_lp_positions | LP positions for a wallet with PnL data | walletAddress | sortBy (invested/investedXrd/currentValue/pnlPercentage) | | attos_earn_stats | Platform overview: total pools and strategies count | - | - |

CoinMarketCap Workflow (2 steps)

To get detailed market data for any cryptocurrency:

1. Search first with tokens_on_cmc to get CMC IDs
2. Then query details with token_details_from_cmc using those IDs

bash
mcporter call emily-radix-assistant.tokens_on_cmc search=Bitcoin limit=1
# Returns tokenId, e.g. 1
mcporter call emily-radix-assistant.token_details_from_cmc --args '{"tokenIds": [1]}'

Usage Examples

Wallet analysis:

• "What tokens are in account_rdx16x..." → tokens_in_wallet
• "How is this wallet performing?" → performance_of_wallet
• "Show portfolio breakdown for account_rdx..." → distribution_of_wallet
• "What was this wallet worth on 2024-06-15?" → historical_wallet_value
• "Show recent swaps for account_rdx..." → search_transactions with transactionType=swap

Token research:

• "Top 10 tokens on Radix by volume" → tokens_on_radix
• "Biggest gainers this week" → token_gainers_and_losers with sortBy=gained, timePeriod=7d
• "Show me wrapped assets on Radix" → wrapped_assets
• "Who are the top holders of HUG?" → token_details with includeTopHolders=10
• "What was XRD price on 2024-01-01?" → historical_token_data

Network & staking:

• "Radix network stats" → network_stats
• "Top 10 validators by APY" → all_validators with limit=10
• "Resolve alice.xrd" → rns_to_address

DeFi yield:

• "Best pools by APR on Attos Earn" → attos_earn_pools with sortBy=bonus_24h
• "Show lending strategies" → attos_earn_strategies with strategyType=Lending
• "My LP positions" → attos_earn_lp_positions with wallet address
• "Attos Earn overview" → attos_earn_stats

Ecosystem & news:

• "What happened in the Radix ecosystem today?" → today_update
• "Weekly updates from the last month" → weekly_updates with weeks=4
• "What happened in June 2025?" → specific_month with year=2025, month=6
• "Ecosystem news from Jan to March 2025" → specific_date_range
• "Latest official announcements" → official_announcements
• "Monthly ecosystem summaries" → monthly_updates

Knowledge & community:

• "Explain Cerberus consensus" → radix_glossary with themes=["cerberus"]
• "What is sharding?" → radix_core_concepts with concepts=["sharding"]
• "Find DeFi dApps" → radix_dapps with category="DeFi"
• "Where can I buy XRD?" → xrd_trading_venues with type="onramp"
• "Radix Discord and Telegram links" → radix_socials

Multi-tool workflows:

• Resolve an RNS domain, then check wallet tokens: rns_to_address → tokens_in_wallet
• Research a token on Radix, then compare to CMC data: token_details → tokens_on_cmc → token_details_from_cmc
• Full wallet analysis: tokens_in_wallet + performance_of_wallet + distribution_of_wallet + latest_transactions
• DeFi overview: attos_earn_stats + attos_earn_pools + attos_earn_strategies

Data Sources & Freshness

• Token prices: Astrolescent API, cached up to 24 hours, updated hourly via cron
• Wallet data: Radix Gateway API (Babylon mainnet), real-time
• CoinMarketCap: Live API queries
• Ecosystem updates: Aggregated daily/weekly/monthly from Telegram channels and official sources
• Validators: Radix Gateway API, real-time
• dApps directory: Curated dataset, periodically updated
• Attos Earn: Live API queries to earn-api.attos.world (Beta)
• Trading venues & socials: Curated static datasets

Rate Limits

60 requests per minute per IP. Returns HTTP 429 with Retry-After header when exceeded.

About

Powered by Emily - an AI assistant for the Radix DLT ecosystem. Data sourced from the Radix Gateway API, Astrolescent, CoinMarketCap, and Attos Earn.