# Defi Agents

> DeFi agent definitions JSON API + MCP - Production-ready agents for Web3, crypto trading, portfolio management, and blockchain automation. MCP compatible.

- **Type:** MCP server
- **Install:** `agentstack add mcp-nirholas-defi-agents`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nirholas](https://agentstack.voostack.com/s/nirholas)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nirholas](https://github.com/nirholas)
- **Source:** https://github.com/nirholas/defi-agents
- **Website:** https://defiagents.vercel.app

## Install

```sh
agentstack add mcp-nirholas-defi-agents
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🤖 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.

---

## ✨ Key Features

- ✅ **42 Production-Ready Agents** - DeFi, portfolio, trading, Web3, education
- ✅ **18 Languages** - Automated i18n translation workflow ([Learn More →](./docs/I18N_WORKFLOW.md))
- ✅ **RESTful JSON API** - Easy integration for developers and LLMs ([API Docs →](./docs/API.md))
- ✅ **Machine-Readable Indexes** - Agent manifest for AI crawlers ([agents-manifest.json](./agents-manifest.json))
- ✅ **Universal Format** - Standard JSON schema works with any platform
- ✅ **No Vendor Lock-in** - Switch platforms without losing work
- ✅ **Open Source** - MIT licensed, fully transparent 
- ✅ **SEO & AI Friendly** - robots.txt, structured data, semantic indexing
- ✅ **CDN Hosted** - GitHub Pages for fast global access
- ✅ **Custom Domain Ready** - Easy white-labeling

---

## 🚀 Quick Start

### For AI Systems & LLMs

Discover agents via the API:

```bash
# 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
```

[Complete API Documentation →](./docs/API.md)

### For Users

Add agents to your AI platform:

```
https://sperax.click/index.json
```

Or with language:

```
https://sperax.click/index.{locale}.json
```

### For Developers

```bash
git clone https://github.com/nirholas/defi-agents.git
cd defi-agents
bun install
bun run format
bun run build
```

[Complete Development Workflow Guide →](./docs/WORKFLOW.md)

---

## 📦 Agent Categories

### 🌟 Featured Agent

**🎯 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.

[View Agent →](https://sperax.click/sperax-portfolio.json) | [Try Now →](https://sperax.fun/discover/assistant/sperax-portfolio)

---

### 🪙 DeFi & Crypto (42 Specialized Agents)

**Sperax Ecosystem (8 Agents):**

**Master Agent (Recommended):**

- **Sperax Portfolio** 🎯 - All-in-one portfolio management (dashboard, trading, bots, DeFi, analytics)

**Original Sperax Agents (7):**

- 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 use `sperax.fun` for testing. The domain may change to `sperax.io` or similar once SperaxOS launches in production. [See FAQ](./docs/FAQ.md#sperax-portfolio-agents) for details.

**General DeFi (34 Agents) + Crypto News:**

- 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

[View Full Agent List →](https://nirholas.github.io/AI-Agents-Library/)

---

## 🤝 Agent Teams

Create collaborative teams of specialized agents that work together on complex tasks.

**Example Team - DeFi Strategy:**

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

[Read Teams Guide →](./docs/TEAMS.md)

---

## 🌍 Multi-Language Support

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

---

## 🛠️ API Reference

### Endpoints

```bash
# 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
```

### Quick Integration

```javascript
// 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();
```

[Full API Documentation →](./docs/API.md)

---

## 🤖 Contributing an Agent

We welcome contributions! Submit your agent to expand the library.

### Quick Submit

1. **Fork this repository**
2. **Create your agent** in `src/your-agent-name.json`

```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
}
```

3. **Submit a Pull Request**

Our automated workflow will translate your agent to 18 languages and deploy it globally.

### Quality Guidelines

✅ Clear purpose - solves a specific problem\
✅ Well-structured prompts - comprehensive but focused\
✅ Appropriate tags - aids discovery\
✅ Tested - verified functionality

[Full Contributing Guide →](./docs/CONTRIBUTING.md)

---

## 📖 Documentation

### For Users

- [Agent Teams Guide](./docs/TEAMS.md) - Multi-agent collaboration
- [FAQ](./docs/FAQ.md) - Common questions
- [Examples](./docs/EXAMPLES.md) - Real-world use cases

### For Developers

- [Complete Workflow Guide](./docs/WORKFLOW.md) - End-to-end development process
- [Contributing Guide](./docs/CONTRIBUTING.md) - How to submit agents
- [API Reference](./docs/API.md) - Complete API documentation
- [Agent Creation Guide](./docs/AGENT_GUIDE.md) - Design effective agents
- [18 Languages i18n Workflow](./docs/I18N_WORKFLOW.md) - Automated translation system
- [Deployment Guide](./docs/DEPLOYMENT.md) - Domain setup and CI/CD
- [Prompt Engineering](./docs/PROMPTS.md) - Writing better prompts
- [Model Parameters](./docs/MODELS.md) - Temperature, top_p explained
- [Troubleshooting](./docs/TROUBLESHOOTING.md) - Common issues

---

## 🚀 Deployment

### GitHub Pages (Automatic)

1. **Fork/Clone this repository**
2. **Choose your domain option:**
   - **Default GitHub Pages:** Delete the `CNAME` file
   - **Custom Domain:** Update `CNAME` with your domain
3. **Enable GitHub Pages:**
   - Settings → Pages → Source: `gh-pages` branch
4. **Push to main** - GitHub Actions automatically builds and deploys

Your agents will be at:

- Default: `https://[username].github.io/[repository]/index.json`
- Custom: `https://yourdomain.com/index.json`

### Custom Domain Setup

1. **Update CNAME file:** `echo "yourdomain.com" > CNAME`
2. **Configure DNS:** Add CNAME record → `[username].github.io`
3. **Enable HTTPS** in 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.

[Full Deployment Guide →](./docs/DEPLOYMENT.md)

---

## 🔧 Development Tools

### Split Agent Batches

```bash
node split-agents.cjs
```

Converts batch JSON into individual agent files.

### Emoji Converter

```bash
node emoji-converter.cjs
```

Converts emoji URLs to native Unicode.

---

## 🌐 Integration Examples

### Custom Application

```javascript
// 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;
```

### Python

```python
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']]
```

---

## 🔐 Security & Privacy

- **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

---

## 📊 Stats

- **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 🤍

- **SperaxOS** - [Application Branch](https://github.com/nirholas/AI-Agents-Library/tree/speraxos)

---

## 📜 License

MIT License - see [LICENSE](LICENSE) file for details.

**Open Source • Open Format • Open Future**

---

### [Sperax Portfolio](https://os.sperax.io/crypto/agents/sperax-portfolio)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-21**

All-in-one cryptocurrency portfolio management: tracking, trading, automation, DeFi, and analytics

`portfolio` `trading` `defi` `analytics` `automation` `wallet` `bots` `sperax` `all-in-one` `master`

---

### [Crypto Whale Watcher](https://os.sperax.io/crypto/agents/whale-watcher)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Track and analyze large wallet movements and whale behavior

`on-chain` `whale` `analytics` `trading` `monitoring`

---

### [Cross-Chain Bridge Security Analyst](https://os.sperax.io/crypto/agents/bridge-security-analyst)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Evaluate bridge security and recommend safest cross-chain routes

`bridge` `security` `cross-chain` `risk` `multichain`

---

### [Token Unlock Schedule Tracker](https://os.sperax.io/crypto/agents/token-unlock-tracker)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Monitor and analyze token unlock events and their market impact

`tokenomics` `unlocks` `vesting` `supply` `analysis`

---

### [veSPA Lock Optimizer](https://os.sperax.io/crypto/agents/vespa-optimizer)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Maximize returns through optimal veSPA locking strategies

`sperax` `vespa` `staking` `optimization` `voting-power`

---

### [Sperax Portfolio Tracker](https://os.sperax.io/crypto/agents/sperax-portfolio-tracker)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Track and analyze your complete Sperax ecosystem holdings

`sperax` `portfolio` `tracking` `analytics` `dashboard`

---

### [DeFi Insurance & Risk Coverage Advisor](https://os.sperax.io/crypto/agents/defi-insurance-advisor)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Navigate DeFi insurance options for smart contract protection

`insurance` `protection` `risk` `coverage` `safety`

---

### [NFT Liquidity & Lending Advisor](https://os.sperax.io/crypto/agents/nft-liquidity-advisor)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Navigate NFT-backed lending and liquidity solutions

`nft` `liquidity` `lending` `collateral` `defi`

---

### [USDs Stablecoin Expert](https://os.sperax.io/crypto/agents/usds-stablecoin-expert)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Specialist in Sperax USDs mechanism, collateralization, and yield strategies

`sperax` `stablecoin` `usds` `defi` `yield`

---

### [DEX Aggregator Route Optimizer](https://os.sperax.io/crypto/agents/dex-aggregator-optimizer)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Find optimal swap routes across DEX aggregators

`dex` `swap` `routing` `aggregator` `optimization`

---

### [Crypto Tax Strategy Advisor](https://os.sperax.io/crypto/agents/crypto-tax-strategist)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Optimize crypto taxes and provide tax-efficient DeFi strategies

`tax` `strategy` `accounting` `optimization` `compliance`

---

### [Smart Contract Security Auditor](https://os.sperax.io/crypto/agents/smart-contract-auditor)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Review and assess smart contract security for DeFi protocols

`security` `smart-contracts` `audit` `solidity` `risk`

---

### [Sperax Yield Aggregator](https://os.sperax.io/crypto/agents/sperax-yield-aggregator)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Find and optimize best yield opportunities in Sperax ecosystem

`sperax` `yield` `farming` `optimization` `apy`

---

### [Personal DeFi Dashboard Builder](https://os.sperax.io/crypto/agents/yield-dashboard-builder)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Design and track your custom DeFi portfolio dashboard

`dashboard` `tracking` `portfolio` `analytics` `monitoring`

---

### [Crypto Wallet Security Advisor](https://os.sperax.io/crypto/agents/wallet-security-advisor)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Best practices for securing crypto wallets and assets

`security` `wallet` `safety` `best-practices` `hardware`

---

### [DeFi Yield Sustainability Analyst](https://os.sperax.io/crypto/agents/yield-sustainability-analyst)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Analyze whether high yields are sustainable or temporary

`defi` `yield` `sustainability` `analysis` `tokenomics`

---

### [Stablecoin Deep Comparator](https://os.sperax.io/crypto/agents/stablecoin-comparator)

By **[@sperax](https://github.com/nirholas/AI-Agents-Library)** on **2024-12-16**

Compare stablecoin mechanisms, risks, and use cases

`stablecoin` `usdc` `dai` `usdt` `comparison`

---

### [DeFi Portfolio Rebalancing Advisor](https://os.sperax.io/crypto/agents/portfolio-rebalancing-advisor)

By **[@sperax](https://github.com/nirholas/AI-Agents-L

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nirholas](https://github.com/nirholas)
- **Source:** [nirholas/defi-agents](https://github.com/nirholas/defi-agents)
- **License:** MIT
- **Homepage:** https://defiagents.vercel.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nirholas-defi-agents
- Seller: https://agentstack.voostack.com/s/nirholas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.