DeFI Agents MCP
About
DeFi agent definitions JSON API - Production-ready agents for Web3, crypto trading, portfolio management, and blockchain automation
Details
- Author
- nirholas
- Categories
- File Management, Other
Jump to
Setup
Install DeFI Agents MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/nirholas/defi-agents
Follow the installation instructions in the repository README, then restart your MCP client.
DeFi agent definitions JSON API - Production-ready agents for Web3, crypto trading, portfolio management, and blockchain automation
🤖 DeFi Agents API - AI Agent Definitions for Web3
42 production-ready AI agent definitions for DeFi, portfolio management, trading, and Web3 workflows. RESTful JSON API with 18-language support.
A comprehensive, discoverable API hosting specialized AI agent schemas with universal compatibility. Works with any AI platform, LLM, or chatbot that supports agent indexes - no vendor lock-in, no platform restrictions. Perfect for developers, LLMs, and AI systems building Web3 applications.
- ✅42 Production-Ready Agents- DeFi, portfolio, trading, Web3, education
- ✅18 Languages- Automated i18n translation workflow (Learn More →)
- ✅RESTful JSON API- Easy integration for developers and LLMs (API Docs →)
- ✅Machine-Readable Indexes- Agent manifest for AI crawlers (agents-manifest.json)
- ✅Universal Format- Standard JSON schema works with any platform
- ✅No Vendor Lock-in- Switch platforms without losing work
- ✅Fully Transparent- Every agent definition is readable JSON, no hidden behaviour
- ✅SEO & AI Friendly- robots.txt, structured data, semantic indexing
- ✅CDN Hosted- GitHub Pages for fast global access
- ✅Custom Domain Ready- Easy white-labeling
# Get all agents (English) curl https://sperax.click/index.json # Get agents in any language curl https://sperax.click/index.zh-CN.json # Get agent manifest for indexing curl https://sperax.click/agents-manifest.json
https://sperax.click/index.{locale}.json
git clone https://github.com/nirholas/defi-agents.git cd defi-agents bun install bun run format bun run build
🎯 Sperax Portfolio- All-in-one crypto portfolio management ⭐RECOMMENDED
- Complete portfolio tracking, trading automation, DeFi protocols, and analytics
- ONE agent for 100% of portfolio management features
- Perfect for most users - install once, access everything
⚠️Current Status:Read-only portfolio tracking and analytics available now. Automated trading, bots, and DeFi interactions coming soon in SperaxOS roadmap.
🪙 DeFi & Crypto (42 Specialized Agents)
- Sperax Portfolio🎯 - All-in-one portfolio management (dashboard, trading, bots, DeFi, analytics)
- USDs Stablecoin Expert, SPA Tokenomics Analyst, veSPA Lock Optimizer
- Governance Guide, Liquidity Strategist, Bridge Assistant, Yield Aggregator
SperaxOS Portfolio Specialists (16):💡For advanced users who prefer focused tools
- Portfolio Dashboard, Assets Tracker, Analytics Expert, Wallet Manager
- Trading Assistant, AI Trading Bot, Signal Bot, DCA Bot
- Arbitrage Bot, Pump Screener, DeFi Center, DeFi Protocols
- Strategies Marketplace, Bot Templates, Settings Manager, Help Center
Note:SperaxOS portfolio agents currently usesperax.funfor testing. The domain may change tosperax.ioor similar once SperaxOS launches in production.See FAQfor details.
- Yield Farming Optimizer, Impermanent Loss Calculator, Gas Optimizer
- Smart Contract Auditor, MEV Protection Advisor, Whale Watcher
- Protocol Comparator, Token Unlock Tracker, Liquidation Risk Manager
- Airdrop Hunter, Alpha Leak Detector, APY vs APR Educator
- Bridge Security Analyst, Crypto Tax Strategist, DeFi Insurance Advisor
- DeFi Onboarding Mentor, DeFi Protocol Comparator, DeFi Risk Scoring Engine
- DEX Aggregator Optimizer, Governance Proposal Analyst, Layer 2 Comparison Guide
- Liquidation Risk Manager, Liquidity Pool Analyzer, Narrative Trend Analyst
- NFT Liquidity Advisor, Portfolio Rebalancing Advisor, Protocol Revenue Analyst
- Protocol Treasury Analyst, Stablecoin Comparator, Staking Rewards Calculator
- Wallet Security Advisor, Yield Dashboard Builder, Yield Sustainability Analyst
Create collaborative teams of specialized agents that work together on complex tasks.
- Yield Optimizer (finds opportunities) - Risk Assessment Agent (evaluates safety) - Portfolio Tracker (monitors performance) - Gas Optimizer (minimizes costs)
The host agent coordinates discussion, ensuring each specialist contributes their expertise while building toward a comprehensive solution.
All agents automatically available in 18 languages:
🇺🇸 English・🇨🇳 简体中文・🇹🇼 繁體中文・🇯🇵 日本語・🇰🇷 한국어・🇩🇪 Deutsch・🇫🇷 Français・🇪🇸 Español・🇷🇺 Русский・🇸🇦 العربية・🇵🇹 Português・🇮🇹 Italiano・🇳🇱 Nederlands・🇵🇱 Polski・🇻🇳 Tiếng Việt・🇹🇷 Türkçe・🇸🇪 Svenska・🇮🇩 Bahasa Indonesia
# Main index (all agents) GET https://nirholas.github.io/AI-Agents-Library/index.json # Individual agent (English) GET https://nirholas.github.io/AI-Agents-Library/{agent-id}.json # Localized agent GET https://nirholas.github.io/AI-Agents-Library/{agent-id}.zh-CN.json # Language-specific index GET https://nirholas.github.io/AI-Agents-Library/index.zh-CN.json
// Load all agents const response = await fetch('https://nirholas.github.io/AI-Agents-Library/index.json'); const { agents } = await response.json(); // Load specific agent const agent = await fetch(https://nirholas.github.io/AI-Agents-Library/defi-yield-optimizer.json); const agentConfig = await agent.json();
We welcome contributions! Submit your agent to expand the library.
- Fork this repository
- Create your agentinsrc/your-agent-name.json
{ "author": "your-github-username", "config": { "systemRole": "You are a [role] with expertise in [domain]..." }, "identifier": "your-agent-name", "meta": { "title": "Agent Title", "description": "Clear, concise description", "avatar": "🤖", "tags": ["category", "functionality", "domain"] }, "schemaVersion": 1 }
Our automated workflow will translate your agent to 18 languages and deploy it globally.
✅ Clear purpose - solves a specific problem
✅ Well-structured prompts - comprehensive but focused
✅ Appropriate tags - aids discovery
✅ Tested - verified functionality
- Agent Teams Guide- Multi-agent collaboration
- FAQ- Common questions
- Examples- Real-world use cases
- Complete Workflow Guide- End-to-end development process
- Contributing Guide- How to submit agents
- API Reference- Complete API documentation
- Agent Creation Guide- Design effective agents
- 18 Languages i18n Workflow- Automated translation system
- Deployment Guide- Domain setup and CI/CD
- Prompt Engineering- Writing better prompts
- Model Parameters- Temperature, top_p explained
- Troubleshooting- Common issues
- Fork/Clone this repository
- Choose your domain option:
- Default GitHub Pages:Delete theCNAMEfile
- Custom Domain:UpdateCNAMEwith your domain
- Settings → Pages → Source:gh-pagesbranch
- Default:https://[username].github.io/[repository]/index.json
- Custom:https://yourdomain.com/index.json
- Update CNAME file:echo "yourdomain.com" > CNAME
- Configure DNS:Add CNAME record →[username].github.io
- Enable HTTPSin repository settings after DNS propagates
Note:The build process automatically copies your CNAME to the deployment, so your custom domain persists across all deployments. Forks can simply update or delete the CNAME file.
Converts batch JSON into individual agent files.
// Fetch agents const agents = await fetch('https://nirholas.github.io/AI-Agents-Library/index.json').then((r) => r.json(), ); // Use with your AI model const systemPrompt = agents.agents[0].config.systemRole;
import requests # Load agents response = requests.get('https://nirholas.github.io/AI-Agents-Library/index.json') agents = response.json()['agents'] # Filter by tag defi_agents = [a for a in agents if 'defi' in a['meta']['tags']]
- No data collection- Static JSON index, zero tracking
- Agents run locally- Execute in your AI platform's environment
- Open source- Full transparency, audit every line
- No external calls- Pure JSON configuration files
- 42 Agents- DeFi-focused coverage
- 18 Languages- Global accessibility via automated translation
- 8 Sperax Specialists- Ecosystem-specific agents (7 core + 1 portfolio master)
- 34 General DeFi Agents- Comprehensive DeFi toolkit
- ~300 KB Index- Fast loading (gzipped: ~65 KB)
- 80-120ms- Global CDN delivery
- 0 Vendor Lock-in- True interoperability
🔗 Projects Building with AI Agents Library 🤍
Proprietary - Copyright 2026 nirholas. All rights reserved. See theLICENSEfile for the full terms; use beyond what that file permits requires written permission from the copyright owner.
Open Format • Portable Agents • No Vendor Lock-in
All-in-one cryptocurrency portfolio management: tracking, trading, automation, DeFi, and analytics
portfoliotradingdefianalyticsautomationwalletbotssperaxall-in-onemaster
Track and analyze large wallet movements and whale behavior
on-chainwhaleanalyticstradingmonitoring
Evaluate bridge security and recommend safest cross-chain routes
bridgesecuritycross-chainriskmultichain
Monitor and analyze token unlock events and their market impact
tokenomicsunlocksvestingsupplyanalysis
Maximize returns through optimal veSPA locking strategies
speraxvespastakingoptimizationvoting-power
Track and analyze your complete Sperax ecosystem holdings
speraxportfoliotrackinganalyticsdashboard
DeFi Insurance & Risk Coverage Advisor
Navigate DeFi insurance options for smart contract protection
insuranceprotectionriskcoveragesafety
Navigate NFT-backed lending and liquidity solutions
Specialist in Sperax USDs mechanism, collateralization, and yield strategies
Find optimal swap routes across DEX aggregators
dexswaproutingaggregatoroptimization
Optimize crypto taxes and provide tax-efficient DeFi strategies
taxstrategyaccountingoptimizationcompliance
Review and assess smart contract security for DeFi protocols
securitysmart-contractsauditsolidityrisk
Find and optimize best yield opportunities in Sperax ecosystem
Design and track your custom DeFi portfolio dashboard
dashboardtrackingportfolioanalyticsmonitoring
Best practices for securing crypto wallets and assets
securitywalletsafetybest-practiceshardware
Analyze whether high yields are sustainable or temporary
defiyieldsustainabilityanalysistokenomics
Compare stablecoin mechanisms, risks, and use cases
Optimize portfolio allocation and rebalancing strategies
portfoliorebalancingallocationstrategyoptimization
Help newcomers understand and start using Sperax protocol
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



