🌙 Lyra Registry

The NPM for Crypto AI Tools - Central registry for the Lyra ecosystem

Lyra Registry is a standalone API service that catalogs, scores, and serves metadata for all tools in the Lyra ecosystem. It enables discovery, evaluation, and integration of 800+ crypto & DeFi MCP tools.

Between builds I am working on cleaning up the main Lyra repo with over 800+ blockchain and cryptocurrency tools. I hope to release it soon.

✨ Features

• 📊 Trust Scoring - Every tool is scored using the SperaxOS algorithm
• 🔍 Search & Filter - Full-text search with category, chain, and protocol filters
• 📈 Trending - Track tool popularity and usage
• 🔌 MCP Integration - Auto-seed from running Lyra MCP servers
• 🚀 Vercel Ready - Deploy to Vercel/Railway in minutes

🏗️ Tech Stack

• Framework: Next.js 14 (App Router)
• Database: PostgreSQL (Neon/Supabase)
• ORM: Drizzle
• Language: TypeScript
• Validation: Zod

🚀 Quick Start

1. Clone and Install

git clone https://github.com/nirholas/lyra-registry.git
cd lyra-registry
pnpm install

2. Set Up Database

Create a PostgreSQL database on Neon or Supabase (free tier works).

cp .env.example .env
# Edit .env with your DATABASE_URL

3. Run Migrations

pnpm db:push

4. Seed Database

If you have a running Lyra MCP server:

LYRA_MCP_URL=http://localhost:3001/mcp pnpm db:seed

Or seed with sample data:

pnpm db:seed

5. Start Development Server

pnpm dev

Visit http://localhost:3000 to see the landing page.

📡 API Reference

Tools

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/tools | List all tools with pagination | | POST | /api/tools | Register a new tool | | GET | /api/tools/:id | Get tool by ID | | PATCH | /api/tools/:id | Update a tool | | DELETE | /api/tools/:id | Delete a tool |

Search & Discovery

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/search?q= | Full-text search | | GET | /api/trending | Get trending tools | | GET | /api/categories | List all categories | | POST | /api/discovery | Submit tool for review | | GET | /api/health | Health check & stats |

Query Parameters

/api/tools and /api/search

| Param | Type | Description | |-------|------|-------------| | q | string | Search query | | category | string | Filter by category slug | | chain | string | Filter by blockchain (bsc, ethereum, etc.) | | protocol | string | Filter by protocol (pancakeswap, aave, etc.) | | grade | a|b|f | Filter by trust grade | | requiresApiKey | true|false | Filter by API key requirement | | tags | string | Comma-separated tags | | page | number | Page number (default: 1) | | limit | number | Items per page (default: 20, max: 100) | | sortBy | string | Sort field: name, createdAt, totalScore, downloadCount | | sortOrder | asc|desc | Sort direction (default: desc) |

/api/trending

| Param | Type | Description | |-------|------|-------------| | period | day|week|month | Time period (default: week) | | limit | number | Number of results (default: 10, max: 50) | | category | string | Filter by category |

Example Requests

# Search for DeFi tools
curl "http://localhost:3000/api/search?q=defi&category=defi"

# Get top 10 trending tools this week
curl "http://localhost:3000/api/trending?period=week&limit=10"

# Get all security tools
curl "http://localhost:3000/api/tools?category=security&sortBy=totalScore"

# Register a new tool
curl -X POST "http://localhost:3000/api/tools" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my_custom_tool",
    "description": "A custom DeFi tool",
    "category": "defi",
    "inputSchema": {
      "type": "object",
      "properties": {
        "address": { "type": "string" }
      },
      "required": ["address"]
    },
    "chains": ["ethereum", "bsc"],
    "tags": ["defi", "portfolio"]
  }'

⭐ Trust Score Algorithm

Every tool is scored using the SperaxOS trust algorithm. The score determines the tool's grade:

| Criteria | Weight | Required | |----------|--------|----------| | Validated | 20 | ✅ | | Has Tools | 15 | ✅ | | Deployment | 15 | ✅ | | Documentation | 10 | ✅ | | Auto Deploy | 12 | | | License | 8 | | | Prompts | 8 | | | Resources | 8 | | | Claimed | 4 | |

Grades

| Grade | Score | Description | |-------|-------|-------------| | A | 80%+ | All required items met, excellent tool | | B | 60-79% | All required items met, good tool | | F | <60% | Missing required items or low score |

📁 Project Structure

lyra-registry/
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   ├── tools/
│   │   │   │   ├── route.ts        # GET/POST /api/tools
│   │   │   │   └── [id]/
│   │   │   │       └── route.ts    # GET/PATCH/DELETE /api/tools/:id
│   │   │   ├── search/
│   │   │   │   └── route.ts        # GET /api/search
│   │   │   ├── trending/
│   │   │   │   └── route.ts        # GET /api/trending
│   │   │   ├── categories/
│   │   │   │   └── route.ts        # GET/POST /api/categories
│   │   │   ├── discovery/
│   │   │   │   └── route.ts        # GET/POST /api/discovery
│   │   │   └── health/
│   │   │       └── route.ts        # GET /api/health
│   │   ├── globals.css
│   │   ├── layout.tsx
│   │   └── page.tsx                # Landing page
│   ├── db/
│   │   ├── index.ts                # Database connection
│   │   ├── schema.ts               # Drizzle schema
│   │   └── seed.ts                 # Seed script
│   ├── lib/
│   │   ├── calculateScore.ts       # Trust score algorithm (from SperaxOS)
│   │   └── validation.ts           # Zod schemas
│   └── types/
│       └── index.ts                # TypeScript types
├── drizzle.config.ts
├── next.config.ts
├── package.json
├── tsconfig.json
└── README.md

🚢 Deployment

Vercel

1. Push to GitHub
2. Import to Vercel
3. Add DATABASE_URL environment variable
4. Deploy

Railway

railway init
railway add
railway variables set DATABASE_URL=...
railway up

🤝 Integration with Lyra Ecosystem

Auto-Seeding from Lyra MCP Server

The registry can automatically import tools from a running Lyra MCP server:

# Start Lyra server
cd ../Lyra && bun run build && bun dist/cli.mjs --transport=http --port=3001

# Seed registry
cd ../lyra-registry
LYRA_MCP_URL=http://localhost:3001/mcp pnpm db:seed

Discovery Pipeline (via Lyra-Intel)

The lyra-intel project can automatically discover and submit new tools:

# In lyra-intel
from lyra_intel.discovery import RegistrySubmitter

submitter = RegistrySubmitter("https://lyra-registry.vercel.app/api/discovery")
await submitter.submit_tool(tool, security_result)

📜 License

MIT

🔗 Links

• Lyra MCP Server - The main MCP server with 280+ tools
• Lyra Intel - Auto-discovery and security scanning
• SperaxOS - The scoring algorithm source
• Sperax - Sperax ecosystem