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:
mcporter list emily-radix-assistant
If not found, register it (URL is the only required argument):
mcporter config add emily-radix-assistant https://www.ineedemily.com/api/mcp/mcp
Verify with a quick test:
mcporter call emily-radix-assistant.network_stats
To see all available tools and their schemas:
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:
- Search first with
tokens_on_cmc to get CMC IDs
- Then query details with
token_details_from_cmc using those IDs
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.
1---2name: emily-radix-assistant3description: Query Radix DLT blockchain data including wallet balances and performance, token prices and market movers, validator staking info, transaction history, network statistics, ecosystem news, DeFi yield pools, XRD trading venues, dApp directory, and developer resources. Use when users ask about Radix, XRD, wallets starting with account_rdx, tokens starting with resource_rdx, staking, DeFi on Radix, .xrd domains, Attos Earn, or buying/bridging XRD.4---5
6# Emily Your Personal Radix Assistant
7
8Query the Radix DLT blockchain for wallet balances, token prices, network stats, validators, transactions, ecosystem news, DeFi yield data, trading venues, dApps, and developer resources.
9
10Free to use. No API key required. Mainnet data only.
11
12## Setup (auto-configured)
13
14**On first use**, check if the `emily-radix-assistant` server is already registered:
15
16```bash
17mcporter list emily-radix-assistant
18```
19
20If not found, register it (URL is the only required argument):
21
22```bash
23mcporter config add emily-radix-assistant https://www.ineedemily.com/api/mcp/mcp
24```
25
26Verify with a quick test:
27
28```bash
29mcporter call emily-radix-assistant.network_stats
30```
31
32To see all available tools and their schemas:
33
34```bash
35mcporter list emily-radix-assistant --schema --all-parameters
36```
37
38## Address Formats
39
40- **Wallet addresses** start with `account_rdx` (66 characters total)
41- **Token addresses** start with `resource_rdx` (67 characters total)
42- **RNS domains** end with `.xrd` (e.g. `alice.xrd`)
43- All addresses are **mainnet only** (Babylon network)
44
45## Available Tools (35 total)
46
47### Wallet Tools (7)
48
49| Tool | Description | Required Params | Optional Params |
50| ------------------------- | -------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------- |
51| `tokens_in_wallet` | All tokens with prices, 24H/7D changes | `address` | - |
52| `performance_of_wallet` | Total USD value, 24H/7D performance | `address` | - |
53| `distribution_of_wallet` | Portfolio breakdown by % | `address` | `limit` (1-20, default 5), `minUSDValue` |
54| `historical_wallet_value` | Wallet value on a past date | `address`, `date` (YYYY-MM-DD) | - |
55| `latest_transactions` | Most recent transactions | `address` | `until` (ISO date) |
56| `search_transactions` | Filter transaction history | `address` | `resourceAddress`, `startDate`, `endDate`, `transactionType` (swap/stake/unstake/claim/deposit/withdrawal/all) |
57| `check_owned_rns_domains` | RNS (.xrd) domains owned | `address` | - |
58
59### Token Tools (7)
60
61| Tool | Description | Required Params | Optional Params |
62| -------------------------- | ------------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
63| `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` |
64| `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) |
65| `wrapped_assets` | Bridged assets (xUSDC, xETH, xwBTC...) | - | `limit` (1-50, default 10), `sortBy` (volume/tvl/marketCap/name), `includePrice`, `includeVolume`, `includeSupply`, `includePriceChanges`, `includeTvl` |
66| `token_details` | On-chain metadata for a specific token | `address` (resource_rdx...) | `includeTopHolders` (0-100) |
67| `tokens_on_cmc` | Search CoinMarketCap listings | - | `search`, `limit` (1-300, default 10), `includePrice`, `sortBy` (rank/name/symbol) |
68| `token_details_from_cmc` | Detailed CMC data by IDs | `tokenIds` (array of ints) | - |
69| `historical_token_data` | Token price on a specific date | `address` (resource_rdx...), `date` (YYYY-MM-DD) | - |
70
71### Network Tools (3)
72
73| Tool | Description | Required Params | Optional Params |
74| ---------------- | -------------------------------------------- | -------------------------- | -------------------- |
75| `network_stats` | XRD price, staking %, DEX volume, TVL, epoch | - | - |
76| `all_validators` | Validators with stake amounts and APY | - | `limit` (default 50) |
77| `rns_to_address` | Resolve .xrd domain to wallet address | `address` (e.g. alice.xrd) | - |
78
79### Ecosystem & News (8)
80
81| Tool | Description | Required Params | Optional Params |
82| ------------------------ | ------------------------------------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------- |
83| `today_update` | Today's ecosystem update (launches, protocol updates, market moves) | - | - |
84| `recent_daily_updates` | Daily summaries for recent days | - | `days` (1-30, default 7) |
85| `weekly_updates` | Weekly ecosystem summaries | - | `weeks` (1-12, default 4) |
86| `monthly_updates` | Monthly ecosystem summaries with growth metrics and milestones | - | `months` (1-12, default 3) |
87| `specific_date_range` | Ecosystem summaries for a custom date range (auto-selects daily/weekly/monthly) | `startDate`, `endDate` (YYYY-MM-DD) | - |
88| `specific_month` | Ecosystem summary for a specific month | `year` (e.g. 2025), `month` (1-12) | - |
89| `official_announcements` | Latest official announcements from the Radix Telegram channel | - | - |
90| `ecosystem_summary` | Comprehensive summary across timeframes | - | `timeframe` (daily/weekly/monthly), `period` (e.g. "last 7 days") |
91
92### Glossary, dApps & Community (6)
93
94| Tool | Description | Required Params | Optional Params |
95| --------------------------- | --------------------------------------------------------------------------------------- | --------------- | -------------------------------------------------------------- |
96| `radix_glossary` | Radix terminology (Cerberus, Scrypto, Xi'an, Radix Engine, etc.) | - | `themes` (array of theme names; omit for available list) |
97| `radix_core_concepts` | Core blockchain and Radix technical concepts (sharding, consensus, atomic transactions) | - | `concepts` (array of concept names; omit for available list) |
98| `radix_dapps` | Discover dApps in the ecosystem | - | `name`, `tags` (array), `category` (DeFi/NFT/Utility/Meme/Dao) |
99| `radix_developer_resources` | Developer docs, SDKs, tools, and learning resources | - | - |
100| `xrd_trading_venues` | Where to buy, trade, bridge, or leverage XRD | - | `type` (leverage/onramp/bridge/spot), `all` (boolean) |
101| `radix_socials` | Community channels, official accounts, developer chats | - | `category` (community/official/resources/developer/market) |
102
103### Attos Earn - DeFi Yield (4)
104
105| Tool | Description | Required Params | Optional Params |
106| ------------------------- | -------------------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
107| `attos_earn_pools` | Liquidity pools with TVL, volume, APR/bonuses | - | `sortBy` (tvl/volume_24h/volume_7d/bonus_24h/bonus_7d), `limit` (default 10) |
108| `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) |
109| `attos_earn_lp_positions` | LP positions for a wallet with PnL data | `walletAddress` | `sortBy` (invested/investedXrd/currentValue/pnlPercentage) |
110| `attos_earn_stats` | Platform overview: total pools and strategies count | - | - |
111
112### CoinMarketCap Workflow (2 steps)
113
114To get detailed market data for any cryptocurrency:
115
1161. **Search first** with `tokens_on_cmc` to get CMC IDs
1172. **Then query details** with `token_details_from_cmc` using those IDs
118
119```bash
120mcporter call emily-radix-assistant.tokens_on_cmc search=Bitcoin limit=1
121# Returns tokenId, e.g. 1
122mcporter call emily-radix-assistant.token_details_from_cmc --args '{"tokenIds": [1]}'
123```
124
125## Usage Examples
126
127**Wallet analysis:**
128
129- "What tokens are in account_rdx16x..." → `tokens_in_wallet`
130- "How is this wallet performing?" → `performance_of_wallet`
131- "Show portfolio breakdown for account_rdx..." → `distribution_of_wallet`
132- "What was this wallet worth on 2024-06-15?" → `historical_wallet_value`
133- "Show recent swaps for account_rdx..." → `search_transactions` with `transactionType=swap`
134
135**Token research:**
136
137- "Top 10 tokens on Radix by volume" → `tokens_on_radix`
138- "Biggest gainers this week" → `token_gainers_and_losers` with `sortBy=gained`, `timePeriod=7d`
139- "Show me wrapped assets on Radix" → `wrapped_assets`
140- "Who are the top holders of HUG?" → `token_details` with `includeTopHolders=10`
141- "What was XRD price on 2024-01-01?" → `historical_token_data`
142
143**Network & staking:**
144
145- "Radix network stats" → `network_stats`
146- "Top 10 validators by APY" → `all_validators` with `limit=10`
147- "Resolve alice.xrd" → `rns_to_address`
148
149**DeFi yield:**
150
151- "Best pools by APR on Attos Earn" → `attos_earn_pools` with `sortBy=bonus_24h`
152- "Show lending strategies" → `attos_earn_strategies` with `strategyType=Lending`
153- "My LP positions" → `attos_earn_lp_positions` with wallet address
154- "Attos Earn overview" → `attos_earn_stats`
155
156**Ecosystem & news:**
157
158- "What happened in the Radix ecosystem today?" → `today_update`
159- "Weekly updates from the last month" → `weekly_updates` with `weeks=4`
160- "What happened in June 2025?" → `specific_month` with `year=2025`, `month=6`
161- "Ecosystem news from Jan to March 2025" → `specific_date_range`
162- "Latest official announcements" → `official_announcements`
163- "Monthly ecosystem summaries" → `monthly_updates`
164
165**Knowledge & community:**
166
167- "Explain Cerberus consensus" → `radix_glossary` with `themes=["cerberus"]`
168- "What is sharding?" → `radix_core_concepts` with `concepts=["sharding"]`
169- "Find DeFi dApps" → `radix_dapps` with `category="DeFi"`
170- "Where can I buy XRD?" → `xrd_trading_venues` with `type="onramp"`
171- "Radix Discord and Telegram links" → `radix_socials`
172
173**Multi-tool workflows:**
174
175- Resolve an RNS domain, then check wallet tokens: `rns_to_address` → `tokens_in_wallet`
176- Research a token on Radix, then compare to CMC data: `token_details` → `tokens_on_cmc` → `token_details_from_cmc`
177- Full wallet analysis: `tokens_in_wallet` + `performance_of_wallet` + `distribution_of_wallet` + `latest_transactions`
178- DeFi overview: `attos_earn_stats` + `attos_earn_pools` + `attos_earn_strategies`
179
180## Data Sources & Freshness
181
182- **Token prices**: Astrolescent API, cached up to 24 hours, updated hourly via cron
183- **Wallet data**: Radix Gateway API (Babylon mainnet), real-time
184- **CoinMarketCap**: Live API queries
185- **Ecosystem updates**: Aggregated daily/weekly/monthly from Telegram channels and official sources
186- **Validators**: Radix Gateway API, real-time
187- **dApps directory**: Curated dataset, periodically updated
188- **Attos Earn**: Live API queries to earn-api.attos.world (Beta)
189- **Trading venues & socials**: Curated static datasets
190
191## Rate Limits
192
19360 requests per minute per IP. Returns HTTP 429 with `Retry-After` header when exceeded.
194
195## About
196
197Powered by [Emily](https://www.ineedemily.com) - an AI assistant for the Radix DLT ecosystem.
198Data sourced from the [Radix Gateway API](https://docs.radixdlt.com/docs/network-apis), [Astrolescent](https://astrolescent.com), [CoinMarketCap](https://coinmarketcap.com), and [Attos Earn](https://earn.attos.world).
modbender