Lyra Tool Registry Guide
Lyra Registry is a standalone API + MCP service that catalogs, scores, and serves metadata for 800+ crypto and DeFi tools. It's the discovery layer for the Sperax/Lyra ecosystem.
What's in the Registry
| Category |
Count |
Examples |
| DeFi Protocols |
200+ |
Aave, Compound, Uniswap, Sperax |
| Market Data |
100+ |
CoinGecko, DeFi Llama, DexScreener |
| Trading Bots |
80+ |
Grid bots, DCA tools, arbitrage |
| Wallet Tools |
60+ |
Validators, generators, managers |
| NFT Tools |
50+ |
Marketplaces, analytics, minting |
| Security |
40+ |
Audit tools, honeypot detection |
| Bridge/Cross-Chain |
50+ |
Across, Stargate, Wormhole |
| MCP Servers |
100+ |
All registered MCP servers |
| Other |
120+ |
Governance, education, analytics |
API Endpoints
Search Tools
# Search by keyword
curl https://registry.lyra.tools/api/search?q=stablecoin
# Filter by category
curl https://registry.lyra.tools/api/tools?category=defi&chain=arbitrum
# Get trending tools
curl https://registry.lyra.tools/api/trending
# Get tool details
curl https://registry.lyra.tools/api/tools/sperax-usds
Tool Scoring
Every tool has a quality score based on:
| Factor |
Weight |
Description |
| Documentation |
20% |
README quality, guides, API docs |
| Maintenance |
20% |
Recent commits, issue response time |
| Community |
15% |
Stars, forks, contributors |
| Security |
20% |
Audits, dependencies, practices |
| Functionality |
15% |
Feature completeness, reliability |
| Compatibility |
10% |
MCP support, standard compliance |
Example Score
{
"name": "sperax-crypto-mcp",
"score": 0.92,
"breakdown": {
"documentation": 0.95,
"maintenance": 0.90,
"community": 0.85,
"security": 0.95,
"functionality": 0.93,
"compatibility": 0.98
}
}
MCP Server
The registry itself is an MCP server:
{
"mcpServers": {
"lyra-registry": {
"command": "npx",
"args": ["@nirholas/lyra-registry", "serve"]
}
}
}
MCP Tools
searchTools — Search registry by keyword/categorygetToolDetails — Full metadata for a specific toolgetTrending — Currently trending toolscompareTools — Side-by-side comparisongetRecommendations — AI-recommended tools for a taskgetByChain — Tools filtered by blockchain
Tool Metadata Schema
{
"id": "sperax-usds",
"name": "Sperax USDs",
"description": "Auto-yield stablecoin on Arbitrum",
"category": "defi",
"subcategory": "stablecoin",
"chains": ["arbitrum"],
"url": "https://app.sperax.io",
"github": "https://github.com/nirholas/sperax-crypto-mcp",
"mcp": true,
"mcpPackage": "@nirholas/sperax-crypto-mcp",
"score": 0.92,
"tags": ["stablecoin", "yield", "arbitrum", "sperax"],
"lastUpdated": "2026-02-20"
}
Use Cases
AI Agent Tool Selection
Agent queries the registry to find the best tool for a specific task:
User: "I need to track my DeFi positions across chains"
Agent → Registry: searchTools("portfolio tracking multi-chain")
Registry → Agent: [zapper, debank, sperax-portfolio, ...]
Agent: Recommends the highest-scored option
SperaxOS Integration
The registry powers tool discovery in the SperaxOS skill marketplace, helping users find and install the right tools for their agents.
Links
1---2name: tool-registry-guide3description: Guide to Lyra Registry — a standalone API and MCP service cataloging, scoring, and serving metadata for 800+ crypto, blockchain, DeFi, memecoin, NFT, metaverse, and trading tools. Enables discovery, evaluation, and integration of tools in the Lyra/Sperax ecosystem.4license: MIT5---67# Lyra Tool Registry Guide89Lyra Registry is a standalone API + MCP service that catalogs, scores, and serves metadata for 800+ crypto and DeFi tools. It's the discovery layer for the Sperax/Lyra ecosystem.1011## What's in the Registry1213| Category | Count | Examples |14|----------|-------|---------|15| **DeFi Protocols** | 200+ | Aave, Compound, Uniswap, Sperax |16| **Market Data** | 100+ | CoinGecko, DeFi Llama, DexScreener |17| **Trading Bots** | 80+ | Grid bots, DCA tools, arbitrage |18| **Wallet Tools** | 60+ | Validators, generators, managers |19| **NFT Tools** | 50+ | Marketplaces, analytics, minting |20| **Security** | 40+ | Audit tools, honeypot detection |21| **Bridge/Cross-Chain** | 50+ | Across, Stargate, Wormhole |22| **MCP Servers** | 100+ | All registered MCP servers |23| **Other** | 120+ | Governance, education, analytics |2425## API Endpoints2627### Search Tools28```bash29# Search by keyword30curl https://registry.lyra.tools/api/search?q=stablecoin3132# Filter by category33curl https://registry.lyra.tools/api/tools?category=defi&chain=arbitrum3435# Get trending tools36curl https://registry.lyra.tools/api/trending3738# Get tool details39curl https://registry.lyra.tools/api/tools/sperax-usds40```4142### Tool Scoring43Every tool has a quality score based on:4445| Factor | Weight | Description |46|--------|--------|-------------|47| **Documentation** | 20% | README quality, guides, API docs |48| **Maintenance** | 20% | Recent commits, issue response time |49| **Community** | 15% | Stars, forks, contributors |50| **Security** | 20% | Audits, dependencies, practices |51| **Functionality** | 15% | Feature completeness, reliability |52| **Compatibility** | 10% | MCP support, standard compliance |5354### Example Score5556```json57{58 "name": "sperax-crypto-mcp",59 "score": 0.92,60 "breakdown": {61 "documentation": 0.95,62 "maintenance": 0.90,63 "community": 0.85,64 "security": 0.95,65 "functionality": 0.93,66 "compatibility": 0.9867 }68}69```7071## MCP Server7273The registry itself is an MCP server:7475```json76{77 "mcpServers": {78 "lyra-registry": {79 "command": "npx",80 "args": ["@nirholas/lyra-registry", "serve"]81 }82 }83}84```8586### MCP Tools87- `searchTools` — Search registry by keyword/category88- `getToolDetails` — Full metadata for a specific tool89- `getTrending` — Currently trending tools90- `compareTools` — Side-by-side comparison91- `getRecommendations` — AI-recommended tools for a task92- `getByChain` — Tools filtered by blockchain9394## Tool Metadata Schema9596```json97{98 "id": "sperax-usds",99 "name": "Sperax USDs",100 "description": "Auto-yield stablecoin on Arbitrum",101 "category": "defi",102 "subcategory": "stablecoin",103 "chains": ["arbitrum"],104 "url": "https://app.sperax.io",105 "github": "https://github.com/nirholas/sperax-crypto-mcp",106 "mcp": true,107 "mcpPackage": "@nirholas/sperax-crypto-mcp",108 "score": 0.92,109 "tags": ["stablecoin", "yield", "arbitrum", "sperax"],110 "lastUpdated": "2026-02-20"111}112```113114## Use Cases115116### AI Agent Tool Selection117Agent queries the registry to find the best tool for a specific task:118```119User: "I need to track my DeFi positions across chains"120Agent → Registry: searchTools("portfolio tracking multi-chain")121Registry → Agent: [zapper, debank, sperax-portfolio, ...]122Agent: Recommends the highest-scored option123```124125### SperaxOS Integration126The registry powers tool discovery in the SperaxOS skill marketplace, helping users find and install the right tools for their agents.127128## Links129130- GitHub: https://github.com/nirholas/lyra-registry131- Lyra Discovery: https://github.com/nirholas/lyra-tool-discovery132- Sperax: https://app.sperax.io
nirholas