Crypto Pegmon MCP

1# Crypto-Pegmon-MCP
2 
3An MCP server that tracks stablecoin peg integrity across multiple blockchains, helping AI agents detect depegging risks before they escalate.
4 
5<a href="https://glama.ai/mcp/servers/@kukapay/crypto-pegmon-mcp">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kukapay/crypto-pegmon-mcp/badge" alt="crypto-pegmon-mcp MCP server" />
7</a>
8 
9![License](https://img.shields.io/badge/license-MIT-green)
10![Python](https://img.shields.io/badge/python-3.10%2B-blue)
11![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
12 
13## Features
14 
15- **Stability Reports**: Generate detailed reports assessing stablecoin peg stability, including maximum deviation and status (Stable, Moderately Stable, Unstable).
16- **Real-Time Price Monitoring**: Fetch current prices and calculate peg deviation from $1 for USD-pegged stablecoins.
17- **Historical Data Analysis**: Retrieve historical price data (up to 7 days by default) in Markdown table format.
18- **Supported Stablecoins**: Monitor 17 USD-pegged stablecoins, such as Tether (USDT), USD Coin (USDC), Dai (DAI), and yield-bearing tokens like Ethena Staked USDe (eUSDe).
19- **User-Friendly Output**: All data is presented in clean Markdown format for easy integration into reports or dashboards.
20 
21## Supported Stablecoins
22 
23The server supports the following USD-pegged stablecoins:
24 
25| Symbol     | Description                                            |
26|------------|--------------------------------------------------------|
27| USDT       | Tether's USD-pegged stablecoin, centrally issued.      |
28| USDC       | Circle's USD-backed stablecoin, widely used in DeFi.   |
29| DAI        | Decentralized stablecoin by MakerDAO, collateralized by crypto. |
30| BUSD       | Binance's USD-pegged stablecoin, centrally managed.    |
31| TUSD       | TrueUSD, a USD-backed stablecoin by TrustToken.        |
32| FRAX       | Fractional-algorithmic USD stablecoin by Frax Finance. |
33| USDD       | TRON's USD-pegged stablecoin, centrally issued.        |
34| USDS       | USD-pegged stablecoin, focused on stability.           |
35| SUSDS      | Staked USDS, yield-bearing stablecoin.                 |
36| EUSDE      | Ethena's staked USD stablecoin, yield-bearing.         |
37| USDY       | Ondo's USD yield stablecoin, designed for returns.     |
38| PYUSD      | PayPal's USD-pegged stablecoin for payments.           |
39| GUSD       | Gemini Dollar, USD-backed by Gemini Trust.             |
40| USDP       | Paxos Standard, a regulated USD stablecoin.            |
41| AAVE-USDC  | Aave's USD-pegged stablecoin for lending.              |
42| CURVE-USD  | Curve Finance's USD stablecoin for DeFi pools.         |
43| MIM        | Magic Internet Money, a decentralized USD stablecoin.  |
44 
45## Installation
46 
47### Prerequisites
48 
49- Python 3.10 or higher
50- [uv](https://github.com/astral-sh/uv) (recommended for dependency management and running)
51 
52### Steps
53 
541. **Clone the Repository**:
55   ```bash
56   git clone https://github.com/kukapay/crypto-pegmon-mcp.git
57   cd crypto-pegmon-mcp
58   ```
59 
602. **Install Dependencies**:
61   Using uv (recommended):
62   ```bash
63   uv sync
64   ```
65 
663. **Run the Server**:
67   Using uv (recommended):
68   ```bash
69   uv run main.py
70   ```
71 
72## Usage
73 
74The server provides four tools, accessible via the MCP interface. Below are examples for each tool and prompt.
75 
76### 1. List Supported Stablecoins
77Retrieve a list of supported stablecoins with their descriptions.
78 
79- **Prompt**:
80  ```plaintext
81  List all supported stablecoins with their descriptions.
82  ```
83- **Output**:
84  ```markdown
85  **Supported USD-Pegged Stablecoins**:
86 
87  | Symbol     | Description                                            |
88  |------------|--------------------------------------------------------|
89  | USDT       | Tether's USD-pegged stablecoin, centrally issued.      |
90  | USDC       | Circle's USD-backed stablecoin, widely used in DeFi.   |
91  | ...        | ...                                                    |
92  ```
93 
94### 2. Fetch Current Price
95Get the current price and peg deviation for a specific stablecoin.
96 
97- **Prompt**:
98  ```plaintext
99  Get the current price of USDT.
100  ```
101- **Output**:
102  ```markdown
103  **USDT Current Price**: $1.0002, Peg Deviation: 0.02%
104  ```
105 
106### 3. Fetch Historical Data
107Retrieve historical price data for a stablecoin over a specified number of days (default: 7).
108 
109- **Prompt**:
110  ```plaintext
111  Show the price history of USDC for the last 7 days.
112  ```
113- **Output**:
114  ```markdown
115  **USDC Historical Data (Last 7 Days)**:
116 
117  | Date       | Price  | Deviation (%) |
118  |------------|--------|---------------|
119  | 2025-04-29 | 1.0001 | 0.0100        |
120  | 2025-04-30 | 0.9998 | -0.0200       |
121  | ...        | ...    | ...           |
122  ```
123 
124### 4. Analyze Peg Stability
125Generate a comprehensive stability report for a stablecoin, including historical data, current price, and analysis.
126 
127- **Prompt**:
128  ```plaintext
129  Analyze the peg stability of DAI over the past week.
130  ```
131- **Output**:
132  ```markdown
133  - **DAI Historical Data (Last 7 Days)**:
134    | Date       | Price  | Deviation (%) |
135    |------------|--------|---------------|
136    | 2025-04-29 | 1.0003 | 0.0300        |
137    | ...        | ...    | ...           |
138  - **DAI Current Price**: $1.0000, Peg Deviation: 0.00%
139  - **Stability Analysis for DAI**:
140    - Maximum Deviation: 0.15%
141    - Stability Status: Stable
142    - Note: Deviations > 3% indicate potential depegging risks.
143  ```
144 
145## License
146 
147This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.