Package Exports

hl-eco-mcp
hl-eco-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (hl-eco-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

HyperLiquid Ecosystem MCP Server

Transform ANY API into AI-accessible tools in 60 seconds! 🚀

hl-eco-mcp is a revolutionary Model Context Protocol (MCP) server that makes every DeFi protocol instantly accessible to AI agents. Simply submit a JSON definition of your API, and watch it automatically transform into tools that Claude, ChatGPT, and any AI agent can use. No coding required, no complex integrations - just unlimited extensibility for the entire DeFi ecosystem.

🌟 Core Features

♾️ Unlimited Extensibility - Any REST API, GraphQL endpoint, or WebSocket feed becomes AI tools
🤖 Zero-Code Integration - JSON protocol definitions automatically generate MCP tools
🌐 Community-Driven - Protocols contributed by the community, for the community
⚡ Instant Deployment - Submit PR, get AI tools - it's that simple
🛡️ Security Built-in - Authentication, rate limiting, and validation for every protocol
📊 Production Ready - Battle-tested with HyperLiquid integration as the flagship example

🚀 Quick Start

For Protocol Teams - Add Your API in 30 Minutes

// protocols/your-protocol.json
{
  "name": "your-defi-protocol",
  "version": "1.0.0",
  "description": "Your protocol description",
  "endpoints": [
    {
      "name": "getPoolInfo",
      "method": "GET",
      "path": "https://api.yourprotocol.com/pools/{poolId}",
      "description": "Get liquidity pool information"
    }
  ]
}

Result: Your API is now accessible to every AI agent as your_defi_protocol_getPoolInfo!

For AI Users - Install and Use Any Protocol

# Install the MCP server
npm install -g hl-eco-mcp

# Configure with your favorite AI agent
hl-eco-mcp --setup

Claude Desktop Configuration

{
  "mcpServers": {
    "defi-ecosystem": {
      "command": "hl-eco-mcp",
      "env": {
        "ENABLE_COMMUNITY_SYSTEM": "true",
        // Add API keys for protocols you want to use
        "HYPERLIQUID_PRIVATE_KEY": "your_key_here",
        "GLUEX_DEFI_API_KEY": "your_key_here"
      }
    }
  }
}

🛠️ What's Included

Community Protocol System (Unlimited Tools)

Any protocol can join the ecosystem:

DeFi Protocols - DEXs, lending platforms, yield aggregators
Data Providers - Price feeds, analytics, on-chain data
Infrastructure - RPCs, indexers, oracles
Cross-Chain - Bridges, aggregators, multi-chain protocols
Your Protocol - Whatever API you have, we can integrate!

Example: HyperLiquid Integration (32+ Built-in Tools)

As a demonstration of what's possible, we include a complete HyperLiquid integration:

Trading - Orders, positions, account management
Market Data - Real-time prices, order books, trade history
Risk Management - Portfolio analysis, risk limits, alerts
Smart Execution - TWAP, VWAP, iceberg orders
Market Intelligence - Technical analysis, sentiment data

📖 Documentation

Quick Start Guide - Get running in 5 minutes
Protocol Contribution Guide - Add your API to the ecosystem
API Reference - Complete documentation for all tools
Examples - Real protocol definitions to learn from

🔒 Security

Never commit private keys to version control
Use testnet for development and testing
Consider hardware wallets for mainnet trading
Monitor API access and permissions regularly

🤝 Join the Ecosystem

🎯 For Protocol Teams

Get your protocol AI-ready in 30 minutes:

Fork this repository
Create a JSON definition of your API
Submit a pull request
Done! Your protocol is now accessible to every AI agent

No SDK integration, no code changes, no maintenance - we handle everything.

🌟 Success Stories

GlueX: Multi-chain routing protocol - 6 endpoints via json specification
HyperLiquid: Complete DEX integration - 32+ tools demonstrating full capabilities
Your Protocol: Next success story - Start here

👨‍💻 For Developers

Extend the platform:

Enhance protocol validation
Improve tool generation
Add new authentication methods
Contribute to core infrastructure

See CONTRIBUTING.md for detailed contribution guidelines.

📄 License

MIT License - see LICENSE file for details.

🆘 Support

Ready to make your API AI-accessible? Join the ecosystem today - your protocol could be live in 30 minutes! 🚀

For traders: Access the entire DeFi ecosystem through natural language with your AI agent. For builders: Make your protocol instantly available to thousands of AI users. For everyone: The future of DeFi is AI-native, and it starts here.