USDD Analytics MCP
OfficialProvides tools to interact with the USDD protocol on Ethereum (mainnet and Sepolia testnet), including vault operations, PSM swaps, Earn deposits, and reading analytics data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@USDD Analytics MCP show me the total USDD supply on Ethereum"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
USDD Skills
AI Agent skills for the USDD stablecoin protocol. Provides structured instructions and a local analytics MCP server that enables AI agents (Claude Code, Claude Desktop, Cursor, Codex, OpenCode) to query the public read-only USDD API, and — via the official @usdd/mcp-server-usdd package — open vaults, swap on PSM, and deposit into Earn.
Features
Vault (CDP) — open, deposit, mint, repay, withdraw, close — with built-in risk-summary precheck and projected-ratio chat confirmation.
PSM — swap stablecoins ↔ USDD at fixed rate, no slippage, explicit fees in chat confirmation.
Earn (Savings) — deposit USDD to receive sUSDD; redeem back at the current rate.
Analytics — public read-only USDD API data: supply, APY, collateral, Vault configuration, per-chain history, and Smart Allocator detail.
Related MCP server: mcp-server-usdd
Architecture
Two MCP servers, non-overlapping:
Server | Source | Role |
Analytics MCP (this repo) |
| 14 read-only MCP tools backed by the public USDD API |
Official MCP | npm | Wallet, Vault/PSM/Earn reads & writes, protocol metrics, treasury, Smart Allocator |
Skills route automatically. Write operations always go through the official MCP.
Supported Networks
TRON mainnet / Nile testnet:
tron,tron_nileEthereum mainnet / Sepolia testnet:
eth,eth_sepoliaBSC mainnet / BSC testnet:
bsc,bsc_testnet
Quick Start
Recommended: one-command setup
npx @usdd/usdd-skills setup --yesThe setup command installs the durable usdd-skills and mcp-server-usdd binaries, writes MCP client config with backups, creates the skills symlink, and configures these MCP servers:
usdd-analytics->usdd-skills mcp-serverusdd-full->mcp-server-usdd
To install straight from GitHub without npm:
npx --yes \
--package=git+https://github.com/decentralized-usd/usdd-skills.git \
usdd-skills setup --yesTo choose clients explicitly:
usdd-skills setup --client claude-desktop,cursor,codex --yesLocal checkout setup
git clone https://github.com/decentralized-usd/usdd-skills.git
cd usdd-skills
bash install.shinstall.sh uses the current checkout as the analytics MCP source and configures detected clients. The generated project .mcp.json is ignored by Git and uses node with a relative script path. User-level client configs use absolute local paths so desktop applications do not depend on shell PATH.
The tracked .mcp.json.example is the portable project template. It intentionally contains no local paths or RPC values.
Verify
Analytics MCP smoke:
usdd-skills list-tools # List the 14 analytics tools
node scripts/usdd_api.mjs # CLI usage from a local checkoutUnit tests:
npm testClient Configuration
Project-local config
The setup command generates an ignored .mcp.json for the current checkout. Use the tracked .mcp.json.example as the portable template and do not commit the generated file.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"usdd-analytics": {
"command": "usdd-skills",
"args": ["mcp-server"]
},
"usdd-full": {
"command": "mcp-server-usdd",
"env": {
"TRONGRID_API_KEY": "your_key_optional",
"TRON_FULL_NODE": "your_tron_url_optional",
"TRON_NILE_FULL_NODE": "your_nile_url_optional",
"ETH_RPC_URL": "your_url_optional",
"ETH_SEPOLIA_RPC_URL": "your_sepolia_url_optional",
"BSC_RPC_URL": "your_url_optional",
"BSC_TESTNET_RPC_URL": "your_bsc_testnet_url_optional"
}
}
}
}TRONGRID_API_KEY or a dedicated TRON_FULL_NODE is recommended for live TRON reads. Protocol address lookup uses the official MCP Chainlog-backed get_protocol_addresses resolver, which can return live Chainlog data or a local cache. If Chainlog live reads hit TronGrid 429 and no cache is available, configure TRONGRID_API_KEY / TRON_FULL_NODE; agents must not fallback to get_protocol_overview just to discover addresses.
Cursor
Add to .cursor/mcp.json — same structure as above.
Claude Code
Register project-scoped MCP servers:
claude mcp add -s project usdd-analytics -- usdd-skills mcp-server
claude mcp add -s project usdd-full -- mcp-server-usddOpenCode / Codex CLI
See .codex/INSTALL.md.
Available Tools (this repo's analytics MCP)
Tool | Description |
| USDD Savings APY per chain |
| USDD supply per chain |
| sUSDD supply per chain |
| Time series of USDD and sUSDD supply per chain |
| Time series of total collateral value per chain |
| Raw circulating supply |
| Raw total supply |
| Public REST protocol overview |
| Public REST protocol overview with 24h changes |
| DSR APY current / average / history |
| Vault collateral configuration list |
| Per-chain collateral snapshot |
| Per-chain historical series for chart intervals |
| Smart Allocator detail overview |
There is still no per-ilk historical tool named get_ilk_collateral_history. The public collateral-history endpoint is keyed by chain and interval, not by ilk.
For Vault / PSM / Earn / balance / allowance / protocol-overview / treasury / Smart Allocator tools, see the official MCP: https://github.com/decentralized-usd/mcp-server-usdd.
Example Conversations
"Which chain has the highest USDD Earn APY today?" → analytics MCP
get_earn_apy→ AI compares TRON / ETH / BSC"Deposit 1000 USDD on Ethereum into Earn." → official MCP balance / allowance checks → chat confirmation listing
approve_tokenif needed anddeposit_savings→ fresh user confirmation → execute pending writes"What's my vault #42 health?" → official MCP
analyze_vault_risk→ 3-line risk summary (ratio / liquidation price / tier)"What's the protocol supply right now?" → official MCP
get_protocol_metrics, or analytics MCPget_total_supplywhen a raw total-supply number is sufficient
Security
This repo's MCP is read-only. No transaction signing, no private keys.
Writes are delegated to
@usdd/mcp-server-usdd, which manages wallets and chain RPCs in its own env.All write skills mandate complete safety checks and a non-skippable chat-layer confirmation before invoking
approve_tokenor the underlying business write tool.Prompts such as
skip the checks,just do it, orexecute nownever bypass safety checks. Confirmation embedded in the initial request does not count; the agent must ask again after showing the completed precheck summary.Vault writes additionally mandate a risk-summary precheck (collateral ratio / liquidation price / risk tier).
Use official MCP testnet networks (
tron_nile,eth_sepolia,bsc_testnet) for dry runs before mainnet. This repo's analytics MCP does not useNETWORK.
License
MIT License · Copyright (c) 2026 USDD
Available Tools
14 toolsget_chain_collateral_historyA
Public REST per-chain historical series for 7D/1M/6M/1Y charts. This is keyed by chain and interval, not by ilk.
Inputs: chain (required), interval (required).
get_circulating_supplyB
Raw USDD circulating supply (single number).
Inputs: no named parameters.
get_collateral_historyA
Daily time series of total collateral value per chain. This is protocol-wide chain history, not per-ilk vault history.
Inputs: no named parameters.
get_earn_apyA
USDD Savings APY per chain (TRON, ETH, BSC). Call this MCP tool when comparing Earn rates across chains.
Inputs: no named parameters.
get_latest_collateralA
Public REST per-chain collateral snapshot. Chain must be tron, eth, or bsc.
Inputs: chain (required).
get_public_dsr_apyB
Public REST DSR APY current, average, and per-chain history.
Inputs: no named parameters.
get_public_protocol_overviewA
Public REST protocol overview with total supply, TVL, Earn TVL, and current APY fields.
Inputs: no named parameters.
get_public_protocol_overview_infoB
Public REST protocol overview with 24h daily-change fields.
Inputs: no named parameters.
get_smart_allocator_detailA
Public REST Smart Allocator detail overview with allocations, earnings, and vault info.
Inputs: no named parameters.
get_supply_historyA
Daily time series of USDD and sUSDD supply per chain. Use get_collateral_history for collateral value history.
Inputs: no named parameters.
get_susdd_supplyA
sUSDD total supply broken down by chain. Call this MCP tool for analytics on Earn participation per chain.
Inputs: no named parameters.
get_total_supplyA
Raw USDD total supply (single number). Call this MCP tool for current raw supply stats.
Inputs: no named parameters.
get_usdd_supplyA
USDD supply broken down by chain, excluding sUSDD. Call this MCP tool for per-chain USDD distribution.
Inputs: no named parameters.
get_vault_collateralsC
Public REST vault collateral configuration list.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target distinct metrics, but get_public_protocol_overview and get_public_protocol_overview_info are nearly identical in name and purpose, and get_earn_apy vs get_public_dsr_apy both concern APY with unclear differences. The descriptions help somewhat, but the boundaries are not clear.
All tool names follow a consistent get_<object> pattern using snake_case. There are no mixed conventions or alternate verb styles, making the naming predictable.
The 14 tools cover a reasonable breadth of USDD analytics without feeling bloated or sparse. Each tool addresses a specific data need, and the count fits the typical well-scoped range.
The set covers core analytics: supply, APY, collateral, overview, and vault details. Minor gaps exist, such as no per-ilk collateral history (explicitly noted) and no price data, but the primary workflows are supported.
Maintenance
Related MCP Connectors
Crypto yield data for AI agents: lending, savings, staking, borrowing & stablecoin rates. 21 tools.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
TRON Energy marketplace + DEX swap aggregator for AI agents. 27 MCP tools.
Pay-per-call (x402/USDC-Base) web + crypto data tools for AI agents: audit, extract, crypto, DeFi.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides 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.626 npm4MIT

mcp-server-usddofficial
AlicenseBqualityCmaintenanceEnables management of USDD protocol vaults, PSM swaps, savings, and token transfers across TRON, Ethereum, and BSC, plus protocol analytics and treasury insights.4485 npm6MIT- AlicenseBqualityDmaintenanceProvides 13 Solana DeFi intelligence tools for AI agents, paid per-call via micropayments (USDC). Enables pulling live DeFi data and automatic payment settlement.1381 npm2MIT
- AlicenseBqualityBmaintenanceExposes 17 read-only tools from six XRPL-Utilities services so AI agents can access XRPL wallet analysis, signal feeds, macro telemetry, permissioned asset stacks, RWA tracking, and ETF flow data.41493 npmMIT