
An MCP server for the across (plus internal testnets). Covers , , , , and .
概览
An MCP server for the across (plus internal testnets). Covers , , , , and . - Vault lifecycle: open, deposit collateral, mint USDD, repay, withdraw, close - PSM lifecycle: inspect fees and routes, swap into USDD, swap out of USDD - Savings lifecycle: inspect USDD Savings, deposit, withdraw - Risk and monitoring for vaults: summaries, oracle status, collateral buffers - Token preflight checks: balances, allowances, approvals - Token transfers: two-step preview → confirm flow for TRX, TRC20, and EVM native/ERC20 - Protocol analytics: chain metrics, collateral prices, PSM route metrics, treasury, Smart Allocator, proof of reserve - Node.js 24.22.1 LTS is required exactly for development and deployment (nvm use reads the repository's .nvmrc) - Every other Node.
README
以下为原文 README 节选,完整内容请查看原文。
mcp-server-usdd
An MCP server for the USDD protocol across TRON, Ethereum, and BNB Smart Chain (plus internal testnets). Covers Vault/CDP, PSM, USDD Savings, token transfers, and protocol analytics.
Scope
Current implementation covers:
- Vault lifecycle: open, deposit collateral, mint USDD, repay, withdraw, close
- PSM lifecycle: inspect fees and routes, swap into USDD, swap out of USDD
- Savings lifecycle: inspect USDD Savings, deposit, withdraw
- Risk and monitoring for vaults: summaries, oracle status, collateral buffers
- Token preflight checks: balances, allowances, approvals
- Token transfers: two-step preview → confirm flow for TRX, TRC20, and EVM native/ERC20
- Protocol analytics: chain metrics, collateral prices, PSM route metrics, treasury, Smart Allocator, proof of reserve
Supported Networks
| Network | Key | Notes |
|---|---|---|
| TRON | tron |
TRON-native vault and PSM support |
| Ethereum | eth |
Vault, PSM, USDD Savings |
| BNB Smart Chain | bsc |
Mirrors ETH deployment structure |
| TRON Nile | tron_nile |
Internal testnet deployment |
| Ethereum Sepolia | eth_sepolia |
Internal testnet deployment |
| BSC Testnet | bsc_testnet |
Internal testnet deployment |
Prerequisites
- Node.js
24.22.1LTS is required exactly for development and deployment (nvm usereads the repository’s.nvmrc)- Every other Node.js version is rejected so the tested runtime and the 2026-10-21 security fixes remain consistent across environments
- Optional but recommended:
TRONGRID_API_KEYfor more reliable TRON access- dedicated
TRON_FULL_NODEandTRON_NILE_FULL_NODE - dedicated
ETH_RPC_URL - dedicated
BSC_RPC_URL - dedicated
ETH_SEPOLIA_RPC_URLandBSC_TESTNET_RPC_URL
Developer
Installation
git clone https://github.com/decentralized-usd/mcp-server-usdd
cd mcp-server-usdd
nvm install
nvm use
npm ci
Usage
npm start
npm run start:http
npm run dev
Configuration
Wallet Modes
The server supports two signing modes:
- Browser mode (recommended): connect a TronLink-compatible browser wallet and sign in browser.
- Agent mode: use encrypted local private keys stored in
~/.agent-wallet/.
For TRON writes, each Claude session shows a one-time signing-mode confirmation reminder before the first write.
You can also manage wallets via CLI or MCP tools:
CLI (agent-wallet)
安装
npx -y @usdd/mcp-server-usdd配置
{
"mcpServers": {
"mcp-server-usdd": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@usdd/mcp-server-usdd"],
"env": {
"TRONGRID_API_KEY": "your_trongrid_api_key"
}
}
}
}