LIN0304/Puffer-Finance-MCP-V1

🔥 Puffer Finance MCP Server

Complete MCP server for Puffer Finance with DeFi strategies, cross-chain bridging, and real contract addresses.

✨ Features

🌉 Cross-Chain Bridge Operations

• 8+ Supported Networks: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, BSC, zkSync Era, Soneium, Berachain
• Bridge Provider Integration: Puffer Finance native bridge using EVERCLEAR + CHAINLINK CCIP
• Live Puffer API: Direct connection to app.puffer.fi bridge endpoints
• Live Everclear API: Real-time quotes, intents, and limits from api.everclear.org
• Real Contract Addresses: All verified Puffer Finance contracts
• Token Mapping: Automatic pufETH ↔ xpufETH conversion with xERC20 standard
• $17.5M Bridge Volume: Proven Puffer-Everclear partnership with 30min settlement

📊 DeFi Strategy Management

• 30+ DeFi Strategies: Complete Puffer Finance ecosystem
• Real-time Data: APR, TVL, daily rewards, protocol info
• Deposit Instructions: Protocol-specific transaction data
• Return Simulations: Accurate yield projections
• Risk Analysis: Comprehensive safety assessments

🪙 Token Support

• pufETH: 0xd9a442856c234a39a81a089c06451ebaa4306a72 (Ethereum)
• xpufETH: 0x23da5f2d509cb43a59d43c108a43edf34510eff1 (Base/L2s)
• PUFFER: 0x4d1c297d39c5c1277964d0e3f8aa901493664530 (Governance)
• Multi-chain Support: ETH, USDC, USDT, wstETH across all networks

🚀 Installation

npm install

⚙️ Usage

As MCP Server (Recommended)

Add to your Claude desktop config:

{
  "mcpServers": {
    "puffer-finance": {
      "command": "node",
      "args": ["/path/to/puffer-finance-mcp/index.js"]
    }
  }
}

Standalone Testing

npm start

🛠️ Available Tools (9 Total)

1. get_bridge_info 🌉

Comprehensive bridge information extraction

• Bridge Routes: All 8 supported chains
• Provider Detection: EVERCLEAR vs CHAINLINK
• Contract Addresses: Real bridge contracts
• Token Support: pufETH/xpufETH compatibility

2. execute_bridge ⭐ ADVANCED

Execute cross-chain bridge transactions

• Provider Intelligence: Automatic EVERCLEAR/CHAINLINK selection
• Real Contracts: Verified bridge addresses
• Token Mapping: pufETH ↔ xpufETH conversion
• Fee Optimization: Provider-specific cost analysis
• Time Estimates: Accurate transfer durations

2b. create_everclear_intent 🔥 PUFFER-EVERCLEAR

Bridge pufETH/xpufETH via Puffer Finance using their Everclear integration

• Puffer Native: Uses Puffer Finance's bridge API with Everclear provider
• Partnership Proven: $17.5M bridge volume via official collaboration
• Fast Settlement: 30-minute settlement time (improved from 2 hours)
• xERC20 Standard: Bridge-agnostic standard for maximum security
• Trust-minimized: Everclear's automated optimization for cost-efficiency

2c. puffer_bridge 🔥 PUFFER FINANCE NATIVE

Direct Puffer Finance bridge integration using their actual bridge providers

• Native Integration: Connects to Puffer's actual bridge API at app.puffer.fi
• Everclear Partnership: $17.5M bridged via Puffer-Everclear collaboration
• Fast Settlement: 30-minute settlement time (down from 2 hours)
• xERC20 Standard: Bridge-agnostic standard for maximum security
• 8+ Networks: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, BSC, zkSync Era

4. get_defi_strategies

Scrape all DeFi opportunities from Puffer Finance

• 30+ Strategies: Complete ecosystem coverage
• Live Data: Real-time APR, TVL, rewards
• Protocol Detection: Curve, Unifi, Euler, Uniswap, etc.

5. deposit_to_strategy

Generate protocol-specific deposit instructions

• Smart Contracts: Real Puffer Finance addresses
• Transaction Data: Ready-to-execute calls
• Gas Estimates: Accurate cost predictions
• Approvals: Required token approvals

6. get_strategy_details

Detailed strategy analysis

• Comprehensive Info: Fees, risks, lockups
• Contract Addresses: Verified protocol contracts
• Requirements: Minimum deposits, token types

7. simulate_deposit

Calculate projected returns and costs

• Yield Projections: Daily/weekly/monthly/yearly
• Fee Impact: Real cost calculations
• Risk Assessment: Strategy-specific warnings

8. get_vaults

Vault information from Puffer Finance

• Vault Metrics: APY, TVL, token support
• Real-time Data: Live vault performance

🌐 Supported Networks

📋 Example Usage

Bridge Operations

// Get all bridge options
get_bridge_info()

// Bridge via Puffer Finance native bridge
puffer_bridge({
  "fromChain": "Ethereum",
  "toChain": "Base",
  "token": "pufETH",
  "amount": "1.0",
  "recipientAddress": "0x742d35cc6cd34b0532c4c0e4b8f0c7c7e1234567",
  "provider": "EVERCLEAR"
})

// Bridge via Puffer-Everclear integration
create_everclear_intent({
  "fromChain": "Ethereum",
  "toChain": "Base",
  "token": "pufETH",
  "amount": "1.0",
  "recipientAddress": "0x742d35cc6cd34b0532c4c0e4b8f0c7c7e1234567"
})

// Bridge via Chainlink CCIP for enterprise
puffer_bridge({
  "fromChain": "Ethereum",
  "toChain": "Soneium",
  "token": "pufETH",
  "amount": "0.5",
  "recipientAddress": "0x742d35cc6cd34b0532c4c0e4b8f0c7c7e1234567",
  "provider": "CHAINLINK_CCIP"
})

DeFi Strategy Operations

// Get all strategies
get_defi_strategies()

// Deposit to specific strategy
deposit_to_strategy({
  "strategyId": "curve-pufeth-wsteth",
  "amount": "1.0"
})

// Simulate returns
simulate_deposit({
  "strategyId": "pendle-finance",
  "amount": "0.5"
})

🔧 Puffer Finance Bridge Providers

EVERCLEAR ⭐ PRIMARY PROVIDER

• Chains: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, BSC, zkSync Era
• Token: pufETH ↔ xpufETH (xERC20 standard)
• Features: Puffer native integration, 30min settlement, $17.5M volume
• Partnership: Official Puffer-Everclear collaboration

CHAINLINK CCIP 🔒 ENTERPRISE GRADE

• Chains: Ethereum, Soneium, Berachain
• Token: pufETH (native token)
• Features: Enterprise security, verifiable cross-chain, 5-15 min transfers
• Use Cases: High-value transfers, enterprise applications

🏗️ Architecture

• Real Contract Integration: All addresses verified from Puffer Finance
• Native Bridge Support: Direct integration with Puffer's bridge providers
• Token Intelligence: Automatic pufETH/xpufETH mapping with xERC20 standard
• Error Handling: Comprehensive validation and safety checks
• Live Data: Real-time scraping from app.puffer.fi
• API Integration: Direct connection to Puffer Finance and Everclear APIs
• Partnership Proven: $17.5M in bridge volume via Puffer-Everclear collaboration

📄 License

MIT License

🔥 Ready for production use with Claude Desktop for complete Puffer Finance interaction!

Supports all DeFi strategies, cross-chain bridging, and real contract execution across 8 networks.