EDUCHAIN Agent Kit
This MCP (Model Context Protocol) server provides tools and resources for interacting with EDUCHAIN. It allows Claude to query information about tokens and pools and perform swaps through SailFish DEX.
Features
Token and Pool Information
- Get token prices and details
- Get pool information and statistics
- View historical data for tokens and pools
- Get top tokens and pools by TVL
Wallet Operations
- Check EDU and token balances
- Get wallet overviews including tokens and NFTs
- Send EDU and ERC20 tokens
Swap Operations
- Get swap quotes with price impact and route information
- Swap tokens for tokens
- Swap EDU for tokens (using WEDU internally)
- Swap tokens for EDU (using WEDU internally)
Note: SailFish DEX, like other Uniswap v3 forks, doesn't support native token swaps directly. Instead, it uses WEDU (Wrapped EDU) internally. When you use the swap functions for EDU, the system automatically handles the wrapping/unwrapping process, so you can work directly with EDU in your transactions. If you need more control, you can also use the
wrap_eduandunwrap_wedufunctions to manually convert between EDU and WEDU.
Arbitrage Operations
- Get external market data for EDU from centralized exchanges
- Check for arbitrage opportunities between CEX and SailFish DEX
- Configurable external market data API
- Customizable arbitrage detection threshold
Tools
Token and Pool Information
get_token_price: Get the current price of a token on SailFish DEXget_token_info: Get detailed information about a token on SailFish DEXget_pool_info: Get detailed information about a liquidity pool on SailFish DEXget_top_tokens: Get a list of top tokens by TVL on SailFish DEXget_top_pools: Get a list of top liquidity pools by TVL on SailFish DEXget_total_tvl: Get the total value locked (TVL) in SailFish DEXget_24h_volume: Get the 24-hour trading volume on SailFish DEXget_token_historical_data: Get historical data for a token on SailFish DEXget_pool_historical_data: Get historical data for a liquidity pool on SailFish DEX
Wallet Operations
get_edu_balance: Get the EDU balance of a wallet addressget_token_balance: Get the token balance of a wallet address with USD valueget_multiple_token_balances: Get multiple token balances for a wallet addressget_nft_balance: Get the NFT balance of a wallet address for a specific NFT collectionget_wallet_overview: Get an overview of a wallet including EDU, tokens, and NFTsget_wallet_address_from_private_key: Get wallet address from private keysend_edu: Send EDU native token to another wallet addresssend_erc20_token: Send ERC20 token to another wallet address
Swap Operations
get_swap_quote: Get a quote for swapping tokens on SailFish DEXswap_tokens: Swap tokens on SailFish DEX (token to token)swap_edu_for_tokens: Swap EDU for tokens on SailFish DEXswap_tokens_for_edu: Swap tokens for EDU on SailFish DEXwrap_edu: Wrap EDU to WEDU (Wrapped EDU)unwrap_wedu: Unwrap WEDU (Wrapped EDU) to EDU
Arbitrage Operations
get_external_market_data: Get external market data for EDU from centralized exchangescheck_arbitrage_opportunities: Check for arbitrage opportunities between CEX and SailFish DEXupdate_external_market_config: Update the configuration for external market data APIget_external_market_config: Get the current configuration for external market data API
Configuration
set_rpc_url: Set the RPC URL for blockchain interactionsget_rpc_url: Get the current RPC URL used for blockchain interactions
Resources
sailfish://overview: Overview of SailFish DEX including TVL, volume, and other metricssailfish://token/{tokenId}: Information about a specific token on SailFish DEXsailfish://pool/{poolId}: Information about a specific liquidity pool on SailFish DEX
Installation
- Make sure you have Node.js installed
- Clone this repository
- Install dependencies:
npm install - Build the project:
npm run build - Add the MCP server to your Claude Desktop configuration file:
{ "mcpServers": { "sailfish": { "command": "node", "args": ["/path/to/SubgraphMCP/build/index.js"], "env": { "RPC_URL": "https://your-edu-rpc-url.com" } } } }
Usage Examples
Get Token Price
use_mcp_tool("sailfish", "get_token_price", {
"tokenId": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342"
});
Get Swap Quote
use_mcp_tool("sailfish", "get_swap_quote", {
"tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
"tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
"amountIn": "10"
});
Swap Tokens
use_mcp_tool("sailfish", "swap_tokens", {
"privateKey": "YOUR_PRIVATE_KEY",
"tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
"tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
"amountIn": "10",
"slippagePercentage": 0.5
});
Check Arbitrage Opportunities
use_mcp_tool("sailfish", "check_arbitrage_opportunities", {
"threshold": 1.5
});
Update External Market API Configuration
use_mcp_tool("sailfish", "update_external_market_config", {
"apiUrl": "https://api.example.com/crypto/prices",
"apiKey": "YOUR_API_KEY",
"symbols": {
"EDU": "EDU",
"USD": "USDT"
}
});
Wrap EDU to WEDU
use_mcp_tool("sailfish", "wrap_edu", {
"privateKey": "YOUR_PRIVATE_KEY",
"amount": "10"
});
Unwrap WEDU to EDU
use_mcp_tool("sailfish", "unwrap_wedu", {
"privateKey": "YOUR_PRIVATE_KEY",
"amount": "10"
});
Testing
You can run the test script to verify the functionality:
node build/test.js
This will test the routing and swap quote functionality without executing actual swaps.
License
This project is licensed under the MIT License - see the LICENSE file for details.