puffer-finance-mcp

🔥 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

Chain	ID	Bridge Provider	Token
Ethereum	1	EVERCLEAR/CHAINLINK	pufETH
Base	8453	EVERCLEAR	xpufETH
Arbitrum	42161	CHAINLINK	pufETH
Apechain	33139	EVERCLEAR	xpufETH
BNB Chain	56	EVERCLEAR	xpufETH
Berachain	80094	CHAINLINK	pufETH
Soneium	1868	CHAINLINK	pufETH
Zircuit	48900	EVERCLEAR	xpufETH

📋 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.