defi-mcp 0.1.0__tar.gz

defi_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthieu Ratsitohery
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

defi_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: defi-mcp
+Version: 0.1.0
+Summary: An MCP server giving AI agents access to DeFi data on EVM chains.
+Author-email: Matthieu Ratsitohery <matiosera3@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/matiosera3-ops/defi-mcp
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: web3>=7.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# defi-mcp
+
+An MCP (Model Context Protocol) server that gives AI agents direct, on-chain access to DeFi data on EVM chains — wallet balances, Aave v3 lending positions, and live token prices, with no centralized API in the middle.
+
+**Status:** Live and functional. 4 tools available today, more on the roadmap.
+
+## Why
+
+Most "DeFi + AI" integrations route through a centralized API that can rate-limit, paywall, or simply disappear. `defi-mcp` talks directly to the chain (via your own RPC provider) and to first-party oracles (Chainlink), so the data your AI agent gets is exactly what's on-chain — verifiable, and not dependent on a third-party API staying online.
+
+## Tools
+
+### `get_token_balance`
+Reads the ERC-20 balance of any wallet address for a supported token.
+
+Supported tokens on Polygon: `USDC`, `USDC.e`, `USDT`, `WETH`, `WMATIC`, `WBTC`, `DAI`, `AAVE`.
+
+```json
+// get_token_balance(address="0x...", token_symbol="USDC", chain="polygon")
+{
+  "address": "0x...",
+  "token": "USDC",
+  "chain": "polygon",
+  "balance": 268.21,
+  "raw_balance": "268210000",
+  "decimals": 6
+}
+```
+
+### `get_aave_position`
+Reads a user's full Aave v3 lending/borrowing position: collateral, debt, available borrowing power, and health factor — straight from the Aave v3 Pool contract.
+
+```json
+// get_aave_position(address="0x...", chain="polygon")
+{
+  "address": "0x...",
+  "chain": "polygon",
+  "total_collateral_usd": 969.78,
+  "total_debt_usd": 288.16,
+  "available_borrows_usd": 484.86,
+  "liquidation_threshold_pct": 82.79,
+  "ltv_pct": 79.71,
+  "health_factor": 2.79,
+  "has_active_position": true
+}
+```
+
+A `health_factor` below `1.0` means the position is at risk of liquidation. A `null` health factor means the user has no outstanding debt.
+
+### `get_token_price`
+Reads the current USD price of a token directly from a Chainlink price feed — the same oracle DeFi protocols use internally, so the price is consistent with what `get_aave_position` reports.
+
+Supported on Polygon: `ETH`/`WETH`, `MATIC`/`WMATIC`, `WBTC`, `USDC`, `USDT`.
+
+```json
+// get_token_price(token_symbol="WBTC", chain="polygon")
+{
+  "token": "WBTC",
+  "chain": "polygon",
+  "price_usd": 63835.77,
+  "decimals": 8,
+  "updated_at": 1782032816
+}
+```
+
+### `hello`
+Simple connectivity check — confirms the MCP server is reachable and responding.
+
+## Supported chains
+
+- Polygon
+
+More EVM chains are on the roadmap (see below).
+
+## Installation
+
+Requires Python 3.10+ and an RPC provider API key (e.g. [Alchemy](https://www.alchemy.com/), free tier works).
+
+```bash
+git clone https://github.com/matiosera3-ops/defi-mcp.git
+cd defi-mcp
+python -m venv venv
+
+# Windows
+.\venv\Scripts\Activate.ps1
+# macOS/Linux
+source venv/bin/activate
+
+pip install -e .
+```
+
+Create a `.env` file in the project root:
+
+```
+POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY
+```
+
+## Usage with Claude Desktop
+
+Add this to your Claude Desktop MCP config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "defi-mcp": {
+      "command": "python",
+      "args": ["/absolute/path/to/defi-mcp/server.py"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop, and the tools above will be available to the model.
+
+## Testing locally
+
+You can test the server directly with the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+```bash
+npx @modelcontextprotocol/inspector python server.py
+```
+
+## Roadmap
+
+- [ ] Track Uniswap v3 LP positions and impermanent loss
+- [ ] Simulate swaps with realistic slippage estimates
+- [ ] Monitor protocol TVLs
+- [ ] Additional chains (Ethereum, Arbitrum, Base)
+- [ ] `defi-mcp-cloud` — hosted tier with MEV-specific tools, caching, and higher rate limits
+
+## Architecture
+
+Open-core model: this repository (MIT licensed) covers standard on-chain read tools. A separate `defi-mcp-cloud` will offer a hosted version with MEV-related tools, request caching, and managed RPC access for users who don't want to run their own infrastructure.
+
+## Contributing
+
+Issues and PRs welcome. This is an early-stage project — feedback on what tools would actually be useful to you is especially valuable.
+
+## License
+
+MIT

defi_mcp-0.1.0/README.md

@@ -0,0 +1,141 @@
+# defi-mcp
+
+An MCP (Model Context Protocol) server that gives AI agents direct, on-chain access to DeFi data on EVM chains — wallet balances, Aave v3 lending positions, and live token prices, with no centralized API in the middle.
+
+**Status:** Live and functional. 4 tools available today, more on the roadmap.
+
+## Why
+
+Most "DeFi + AI" integrations route through a centralized API that can rate-limit, paywall, or simply disappear. `defi-mcp` talks directly to the chain (via your own RPC provider) and to first-party oracles (Chainlink), so the data your AI agent gets is exactly what's on-chain — verifiable, and not dependent on a third-party API staying online.
+
+## Tools
+
+### `get_token_balance`
+Reads the ERC-20 balance of any wallet address for a supported token.
+
+Supported tokens on Polygon: `USDC`, `USDC.e`, `USDT`, `WETH`, `WMATIC`, `WBTC`, `DAI`, `AAVE`.
+
+```json
+// get_token_balance(address="0x...", token_symbol="USDC", chain="polygon")
+{
+  "address": "0x...",
+  "token": "USDC",
+  "chain": "polygon",
+  "balance": 268.21,
+  "raw_balance": "268210000",
+  "decimals": 6
+}
+```
+
+### `get_aave_position`
+Reads a user's full Aave v3 lending/borrowing position: collateral, debt, available borrowing power, and health factor — straight from the Aave v3 Pool contract.
+
+```json
+// get_aave_position(address="0x...", chain="polygon")
+{
+  "address": "0x...",
+  "chain": "polygon",
+  "total_collateral_usd": 969.78,
+  "total_debt_usd": 288.16,
+  "available_borrows_usd": 484.86,
+  "liquidation_threshold_pct": 82.79,
+  "ltv_pct": 79.71,
+  "health_factor": 2.79,
+  "has_active_position": true
+}
+```
+
+A `health_factor` below `1.0` means the position is at risk of liquidation. A `null` health factor means the user has no outstanding debt.
+
+### `get_token_price`
+Reads the current USD price of a token directly from a Chainlink price feed — the same oracle DeFi protocols use internally, so the price is consistent with what `get_aave_position` reports.
+
+Supported on Polygon: `ETH`/`WETH`, `MATIC`/`WMATIC`, `WBTC`, `USDC`, `USDT`.
+
+```json
+// get_token_price(token_symbol="WBTC", chain="polygon")
+{
+  "token": "WBTC",
+  "chain": "polygon",
+  "price_usd": 63835.77,
+  "decimals": 8,
+  "updated_at": 1782032816
+}
+```
+
+### `hello`
+Simple connectivity check — confirms the MCP server is reachable and responding.
+
+## Supported chains
+
+- Polygon
+
+More EVM chains are on the roadmap (see below).
+
+## Installation
+
+Requires Python 3.10+ and an RPC provider API key (e.g. [Alchemy](https://www.alchemy.com/), free tier works).
+
+```bash
+git clone https://github.com/matiosera3-ops/defi-mcp.git
+cd defi-mcp
+python -m venv venv
+
+# Windows
+.\venv\Scripts\Activate.ps1
+# macOS/Linux
+source venv/bin/activate
+
+pip install -e .
+```
+
+Create a `.env` file in the project root:
+
+```
+POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY
+```
+
+## Usage with Claude Desktop
+
+Add this to your Claude Desktop MCP config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "defi-mcp": {
+      "command": "python",
+      "args": ["/absolute/path/to/defi-mcp/server.py"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop, and the tools above will be available to the model.
+
+## Testing locally
+
+You can test the server directly with the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+```bash
+npx @modelcontextprotocol/inspector python server.py
+```
+
+## Roadmap
+
+- [ ] Track Uniswap v3 LP positions and impermanent loss
+- [ ] Simulate swaps with realistic slippage estimates
+- [ ] Monitor protocol TVLs
+- [ ] Additional chains (Ethereum, Arbitrum, Base)
+- [ ] `defi-mcp-cloud` — hosted tier with MEV-specific tools, caching, and higher rate limits
+
+## Architecture
+
+Open-core model: this repository (MIT licensed) covers standard on-chain read tools. A separate `defi-mcp-cloud` will offer a hosted version with MEV-related tools, request caching, and managed RPC access for users who don't want to run their own infrastructure.
+
+## Contributing
+
+Issues and PRs welcome. This is an early-stage project — feedback on what tools would actually be useful to you is especially valuable.
+
+## License
+
+MIT

defi_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "defi-mcp"
+version = "0.1.0"
+description = "An MCP server giving AI agents access to DeFi data on EVM chains."
+authors = [{name = "Matthieu Ratsitohery", email = "matiosera3@gmail.com"}]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.0.0",
+    "web3>=7.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/matiosera3-ops/defi-mcp"
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

defi_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

defi_mcp-0.1.0/src/defi_mcp/config.py

@@ -0,0 +1,29 @@
+"""Token addresses and protocol configurations per chain."""
+
+TOKEN_ADDRESSES = {
+    "polygon": {
+        "USDC": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+        "USDC.e": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
+        "USDT": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
+        "WETH": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
+        "WMATIC": "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270",
+        "WBTC": "0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6",
+        "DAI": "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063",
+        "AAVE": "0xD6DF932A45C0f255f85145f286eA0b292B21C90B",
+    }
+}
+AAVE_POOL_ADDRESSES = {
+    "polygon": "0x794a61358D6845594F94dc1DB02A252b5b4814aD",
+}
+# Chainlink price feed addresses (token/USD), per chain.
+CHAINLINK_PRICE_FEEDS = {
+    "polygon": {
+        "ETH": "0xF9680D99D6C9589e2a93a78A04A279e509205945",
+        "WETH": "0xF9680D99D6C9589e2a93a78A04A279e509205945",
+        "MATIC": "0xAB594600376Ec9fD91F8e885dADF0CE036862dE0",
+        "WMATIC": "0xAB594600376Ec9fD91F8e885dADF0CE036862dE0",
+        "WBTC": "0xDE31F8bFBD8c84b5360CFACCa3539B938dd78ae6",
+        "USDC": "0xfe4A8cc5b5B2366C1B58Bea3858e81843581b2F7",
+        "USDT": "0x0A6513e40db6EB1b165753AD52E80663aeA50545",
+    }
+}

defi_mcp-0.1.0/src/defi_mcp/lib/abis.py

@@ -0,0 +1,63 @@
+"""ABIs for common smart contract standards."""
+
+ERC20_ABI = [
+    {
+        "constant": True,
+        "inputs": [{"name": "_owner", "type": "address"}],
+        "name": "balanceOf",
+        "outputs": [{"name": "balance", "type": "uint256"}],
+        "type": "function",
+    },
+    {
+        "constant": True,
+        "inputs": [],
+        "name": "decimals",
+        "outputs": [{"name": "", "type": "uint8"}],
+        "type": "function",
+    },
+    {
+        "constant": True,
+        "inputs": [],
+        "name": "symbol",
+        "outputs": [{"name": "", "type": "string"}],
+        "type": "function",
+    },
+]
+AAVE_POOL_ABI = [
+    {
+        "inputs": [{"name": "user", "type": "address"}],
+        "name": "getUserAccountData",
+        "outputs": [
+            {"name": "totalCollateralBase", "type": "uint256"},
+            {"name": "totalDebtBase", "type": "uint256"},
+            {"name": "availableBorrowsBase", "type": "uint256"},
+            {"name": "currentLiquidationThreshold", "type": "uint256"},
+            {"name": "ltv", "type": "uint256"},
+            {"name": "healthFactor", "type": "uint256"},
+        ],
+        "stateMutability": "view",
+        "type": "function",
+    },
+]
+CHAINLINK_AGGREGATOR_ABI = [
+    {
+        "inputs": [],
+        "name": "latestRoundData",
+        "outputs": [
+            {"name": "roundId", "type": "uint80"},
+            {"name": "answer", "type": "int256"},
+            {"name": "startedAt", "type": "uint256"},
+            {"name": "updatedAt", "type": "uint256"},
+            {"name": "answeredInRound", "type": "uint80"},
+        ],
+        "stateMutability": "view",
+        "type": "function",
+    },
+    {
+        "inputs": [],
+        "name": "decimals",
+        "outputs": [{"name": "", "type": "uint8"}],
+        "stateMutability": "view",
+        "type": "function",
+    },
+]

defi_mcp-0.1.0/src/defi_mcp/lib/chains.py

@@ -0,0 +1,21 @@
+"""Web3 connection management per chain."""
+import os
+from dotenv import load_dotenv
+from web3 import Web3
+
+load_dotenv()
+
+RPC_URLS = {
+    "polygon": os.getenv("POLYGON_RPC_URL"),
+}
+
+
+def get_web3(chain: str) -> Web3:
+    """Return a Web3 instance connected to the given chain."""
+    rpc_url = RPC_URLS.get(chain.lower())
+    if not rpc_url:
+        raise ValueError(f"Chain '{chain}' not supported or RPC URL not configured")
+    return Web3(Web3.HTTPProvider(rpc_url))
+
+
+SUPPORTED_CHAINS = list(RPC_URLS.keys())

defi_mcp-0.1.0/src/defi_mcp/tools/aave_position.py

@@ -0,0 +1,73 @@
+"""Aave v3 user position tool."""
+from web3 import Web3
+from defi_mcp.lib.chains import get_web3
+from defi_mcp.lib.abis import AAVE_POOL_ABI
+from defi_mcp.config import AAVE_POOL_ADDRESSES
+
+# Aave v3 base currency on Polygon is USD with 8 decimals (price feed precision).
+BASE_CURRENCY_DECIMALS = 8
+
+
+def get_aave_position(address: str, chain: str = "polygon") -> dict:
+    """Get a user's Aave v3 lending/borrowing position on a given chain.
+
+    Args:
+        address: The wallet address to check
+        chain: The blockchain to query. Default: polygon.
+
+    Returns:
+        A dictionary with total collateral, total debt, available borrows,
+        liquidation threshold, LTV, and health factor (all in USD where applicable).
+    """
+    chain = chain.lower()
+
+    if chain not in AAVE_POOL_ADDRESSES:
+        return {"error": f"Chain '{chain}' not supported. Supported: {list(AAVE_POOL_ADDRESSES.keys())}"}
+
+    try:
+        w3 = get_web3(chain)
+
+        if not Web3.is_address(address):
+            return {"error": f"Invalid address: {address}"}
+        address = Web3.to_checksum_address(address)
+
+        pool_address = Web3.to_checksum_address(AAVE_POOL_ADDRESSES[chain])
+        contract = w3.eth.contract(address=pool_address, abi=AAVE_POOL_ABI)
+
+        result = contract.functions.getUserAccountData(address).call()
+        (
+            total_collateral_base,
+            total_debt_base,
+            available_borrows_base,
+            current_liquidation_threshold,
+            ltv,
+            health_factor_raw,
+        ) = result
+
+        # Base amounts use the price feed's decimals (8 on Polygon's main market).
+        total_collateral_usd = total_collateral_base / (10 ** BASE_CURRENCY_DECIMALS)
+        total_debt_usd = total_debt_base / (10 ** BASE_CURRENCY_DECIMALS)
+        available_borrows_usd = available_borrows_base / (10 ** BASE_CURRENCY_DECIMALS)
+
+        # Health factor and LTV/liquidation threshold are 18-decimal fixed point.
+        # If there's no debt, Aave returns max uint256 for health factor -> treat as infinite.
+        max_uint256 = 2**256 - 1
+        if health_factor_raw == max_uint256:
+            health_factor = None  # represents infinite / no debt
+        else:
+            health_factor = health_factor_raw / (10 ** 18)
+
+        return {
+            "address": address,
+            "chain": chain,
+            "total_collateral_usd": total_collateral_usd,
+            "total_debt_usd": total_debt_usd,
+            "available_borrows_usd": available_borrows_usd,
+            "liquidation_threshold_pct": current_liquidation_threshold / 100,
+            "ltv_pct": ltv / 100,
+            "health_factor": health_factor,
+            "has_active_position": total_collateral_usd > 0 or total_debt_usd > 0,
+        }
+
+    except Exception as e:
+        return {"error": f"Failed to fetch Aave position: {str(e)}"}

defi_mcp-0.1.0/src/defi_mcp/tools/balance.py

@@ -0,0 +1,56 @@
+"""Token balance tool."""
+from web3 import Web3
+from defi_mcp.lib.chains import get_web3
+from defi_mcp.lib.abis import ERC20_ABI
+from defi_mcp.config import TOKEN_ADDRESSES
+
+
+def get_token_balance(address: str, token_symbol: str, chain: str = "polygon") -> dict:
+    """Get the balance of an ERC-20 token for a given wallet address.
+
+    Args:
+        address: The wallet address to check
+        token_symbol: The token symbol (e.g. USDC, USDT, WETH, USDC.e)
+        chain: The blockchain to query. Default: polygon.
+
+    Returns:
+        A dictionary with the address, token symbol, balance, and raw balance.
+    """
+    chain = chain.lower()
+
+    if chain not in TOKEN_ADDRESSES:
+        return {"error": f"Chain '{chain}' not supported. Supported: {list(TOKEN_ADDRESSES.keys())}"}
+
+    # Case-insensitive token symbol matching
+    token_map = {k.upper(): k for k in TOKEN_ADDRESSES[chain].keys()}
+    token_key = token_map.get(token_symbol.upper())
+
+    if not token_key:
+        supported = list(TOKEN_ADDRESSES[chain].keys())
+        return {"error": f"Token '{token_symbol}' not supported on {chain}. Supported: {supported}"}
+
+    try:
+        w3 = get_web3(chain)
+
+        if not Web3.is_address(address):
+            return {"error": f"Invalid address: {address}"}
+        address = Web3.to_checksum_address(address)
+
+        token_address = Web3.to_checksum_address(TOKEN_ADDRESSES[chain][token_key])
+        contract = w3.eth.contract(address=token_address, abi=ERC20_ABI)
+
+        raw_balance = contract.functions.balanceOf(address).call()
+        decimals = contract.functions.decimals().call()
+        balance = raw_balance / (10 ** decimals)
+
+        return {
+            "address": address,
+            "token": token_key,
+            "chain": chain,
+            "balance": balance,
+            "raw_balance": str(raw_balance),
+            "decimals": decimals,
+        }
+
+    except Exception as e:
+        return {"error": f"Failed to fetch balance: {str(e)}"}

defi_mcp-0.1.0/src/defi_mcp/tools/price.py

@@ -0,0 +1,51 @@
+"""Token price tool using Chainlink price feeds."""
+from web3 import Web3
+from defi_mcp.lib.chains import get_web3
+from defi_mcp.lib.abis import CHAINLINK_AGGREGATOR_ABI
+from defi_mcp.config import CHAINLINK_PRICE_FEEDS
+
+
+def get_token_price(token_symbol: str, chain: str = "polygon") -> dict:
+    """Get the current USD price of a token from a Chainlink price feed.
+
+    Args:
+        token_symbol: The token symbol (e.g. ETH, WETH, MATIC, WMATIC, WBTC, USDC, USDT)
+        chain: The blockchain to query. Default: polygon.
+
+    Returns:
+        A dictionary with the token symbol, USD price, and feed update timestamp.
+    """
+    chain = chain.lower()
+
+    if chain not in CHAINLINK_PRICE_FEEDS:
+        return {"error": f"Chain '{chain}' not supported. Supported: {list(CHAINLINK_PRICE_FEEDS.keys())}"}
+
+    # Case-insensitive token symbol matching
+    feed_map = {k.upper(): k for k in CHAINLINK_PRICE_FEEDS[chain].keys()}
+    feed_key = feed_map.get(token_symbol.upper())
+
+    if not feed_key:
+        supported = list(CHAINLINK_PRICE_FEEDS[chain].keys())
+        return {"error": f"Token '{token_symbol}' has no price feed on {chain}. Supported: {supported}"}
+
+    try:
+        w3 = get_web3(chain)
+        feed_address = Web3.to_checksum_address(CHAINLINK_PRICE_FEEDS[chain][feed_key])
+        contract = w3.eth.contract(address=feed_address, abi=CHAINLINK_AGGREGATOR_ABI)
+
+        round_data = contract.functions.latestRoundData().call()
+        _, answer, _, updated_at, _ = round_data
+
+        decimals = contract.functions.decimals().call()
+        price_usd = answer / (10 ** decimals)
+
+        return {
+            "token": feed_key,
+            "chain": chain,
+            "price_usd": price_usd,
+            "decimals": decimals,
+            "updated_at": updated_at,
+        }
+
+    except Exception as e:
+        return {"error": f"Failed to fetch price: {str(e)}"}

defi_mcp-0.1.0/src/defi_mcp.egg-info/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: defi-mcp
+Version: 0.1.0
+Summary: An MCP server giving AI agents access to DeFi data on EVM chains.
+Author-email: Matthieu Ratsitohery <matiosera3@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/matiosera3-ops/defi-mcp
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: web3>=7.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# defi-mcp
+
+An MCP (Model Context Protocol) server that gives AI agents direct, on-chain access to DeFi data on EVM chains — wallet balances, Aave v3 lending positions, and live token prices, with no centralized API in the middle.
+
+**Status:** Live and functional. 4 tools available today, more on the roadmap.
+
+## Why
+
+Most "DeFi + AI" integrations route through a centralized API that can rate-limit, paywall, or simply disappear. `defi-mcp` talks directly to the chain (via your own RPC provider) and to first-party oracles (Chainlink), so the data your AI agent gets is exactly what's on-chain — verifiable, and not dependent on a third-party API staying online.
+
+## Tools
+
+### `get_token_balance`
+Reads the ERC-20 balance of any wallet address for a supported token.
+
+Supported tokens on Polygon: `USDC`, `USDC.e`, `USDT`, `WETH`, `WMATIC`, `WBTC`, `DAI`, `AAVE`.
+
+```json
+// get_token_balance(address="0x...", token_symbol="USDC", chain="polygon")
+{
+  "address": "0x...",
+  "token": "USDC",
+  "chain": "polygon",
+  "balance": 268.21,
+  "raw_balance": "268210000",
+  "decimals": 6
+}
+```
+
+### `get_aave_position`
+Reads a user's full Aave v3 lending/borrowing position: collateral, debt, available borrowing power, and health factor — straight from the Aave v3 Pool contract.
+
+```json
+// get_aave_position(address="0x...", chain="polygon")
+{
+  "address": "0x...",
+  "chain": "polygon",
+  "total_collateral_usd": 969.78,
+  "total_debt_usd": 288.16,
+  "available_borrows_usd": 484.86,
+  "liquidation_threshold_pct": 82.79,
+  "ltv_pct": 79.71,
+  "health_factor": 2.79,
+  "has_active_position": true
+}
+```
+
+A `health_factor` below `1.0` means the position is at risk of liquidation. A `null` health factor means the user has no outstanding debt.
+
+### `get_token_price`
+Reads the current USD price of a token directly from a Chainlink price feed — the same oracle DeFi protocols use internally, so the price is consistent with what `get_aave_position` reports.
+
+Supported on Polygon: `ETH`/`WETH`, `MATIC`/`WMATIC`, `WBTC`, `USDC`, `USDT`.
+
+```json
+// get_token_price(token_symbol="WBTC", chain="polygon")
+{
+  "token": "WBTC",
+  "chain": "polygon",
+  "price_usd": 63835.77,
+  "decimals": 8,
+  "updated_at": 1782032816
+}
+```
+
+### `hello`
+Simple connectivity check — confirms the MCP server is reachable and responding.
+
+## Supported chains
+
+- Polygon
+
+More EVM chains are on the roadmap (see below).
+
+## Installation
+
+Requires Python 3.10+ and an RPC provider API key (e.g. [Alchemy](https://www.alchemy.com/), free tier works).
+
+```bash
+git clone https://github.com/matiosera3-ops/defi-mcp.git
+cd defi-mcp
+python -m venv venv
+
+# Windows
+.\venv\Scripts\Activate.ps1
+# macOS/Linux
+source venv/bin/activate
+
+pip install -e .
+```
+
+Create a `.env` file in the project root:
+
+```
+POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY
+```
+
+## Usage with Claude Desktop
+
+Add this to your Claude Desktop MCP config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "defi-mcp": {
+      "command": "python",
+      "args": ["/absolute/path/to/defi-mcp/server.py"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop, and the tools above will be available to the model.
+
+## Testing locally
+
+You can test the server directly with the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+```bash
+npx @modelcontextprotocol/inspector python server.py
+```
+
+## Roadmap
+
+- [ ] Track Uniswap v3 LP positions and impermanent loss
+- [ ] Simulate swaps with realistic slippage estimates
+- [ ] Monitor protocol TVLs
+- [ ] Additional chains (Ethereum, Arbitrum, Base)
+- [ ] `defi-mcp-cloud` — hosted tier with MEV-specific tools, caching, and higher rate limits
+
+## Architecture
+
+Open-core model: this repository (MIT licensed) covers standard on-chain read tools. A separate `defi-mcp-cloud` will offer a hosted version with MEV-related tools, request caching, and managed RPC access for users who don't want to run their own infrastructure.
+
+## Contributing
+
+Issues and PRs welcome. This is an early-stage project — feedback on what tools would actually be useful to you is especially valuable.
+
+## License
+
+MIT

defi_mcp-0.1.0/src/defi_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+src/defi_mcp/__init__.py
+src/defi_mcp/config.py
+src/defi_mcp.egg-info/PKG-INFO
+src/defi_mcp.egg-info/SOURCES.txt
+src/defi_mcp.egg-info/dependency_links.txt
+src/defi_mcp.egg-info/requires.txt
+src/defi_mcp.egg-info/top_level.txt
+src/defi_mcp/lib/__init__.py
+src/defi_mcp/lib/abis.py
+src/defi_mcp/lib/chains.py
+src/defi_mcp/tools/__init__.py
+src/defi_mcp/tools/aave_position.py
+src/defi_mcp/tools/balance.py
+src/defi_mcp/tools/price.py
+tests/test_connection.py

defi_mcp-0.1.0/src/defi_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

defi_mcp-0.1.0/src/defi_mcp.egg-info/requires.txt

@@ -0,0 +1,3 @@
+mcp>=1.0.0
+web3>=7.0.0
+python-dotenv>=1.0.0

defi_mcp-0.1.0/src/defi_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+defi_mcp

defi_mcp-0.1.0/tests/test_connection.py

@@ -0,0 +1,25 @@
+import os
+from dotenv import load_dotenv
+from web3 import Web3
+
+# Charge le .env
+load_dotenv()
+
+# Récupère l'URL Alchemy
+rpc_url = os.getenv("POLYGON_RPC_URL")
+
+if not rpc_url:
+    print("ERREUR: POLYGON_RPC_URL non trouvée dans .env")
+    exit(1)
+
+print(f"URL chargée: {rpc_url[:50]}...")
+
+# Connexion à Polygon
+w3 = Web3(Web3.HTTPProvider(rpc_url))
+
+if w3.is_connected():
+    print("Connecte a Polygon")
+    print(f"Bloc actuel: {w3.eth.block_number}")
+    print(f"Chain ID: {w3.eth.chain_id}")
+else:
+    print("Echec de la connexion")