DeFI Agents MCP

by nirholas

Not rated
GitHub

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

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.