How do I use Lyra Registry?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Lyra Registry search for top DeFi MCP tools on BSC" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Lyra Registry

by nirholas

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

🌙 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
🚀 Deploy Anywhere - Deploy to any Node host in minutes

The public demo deployment is offline while hosting is being migrated. Run it locally with the Quick Start below, or read the source at github.com/nirholas/lyra-registry.

Related MCP server: Agent Index MCP Server

🏗️ 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
npm 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

npm run db:push

4. Seed Database

If you have a running Lyra MCP server:

LYRA_MCP_URL=http://localhost:3001/mcp npm run db:seed

Or seed with sample data:

npm run db:seed

5. Start Development Server

npm run 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

Push to GitHub
Import to Vercel
Add DATABASE_URL environment variable
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 npm run 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("http://localhost:3000/api/discovery")
await submitter.submit_tool(tool, security_result)

📜 License

🔗 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

🌐 Live HTTP Deployment

Lyra Registry is deployed and accessible over HTTP via MCP Streamable HTTP transport — no local installation required.

Endpoint:

https://modelcontextprotocol.name/mcp/lyra-registry

Connect from any MCP Client

Add to your MCP client configuration (Claude Desktop, Cursor, SperaxOS, etc.):

{
  "mcpServers": {
    "lyra-registry": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/lyra-registry"
    }
  }
}

Available Tools (3)

Tool	Description
`search_mcp_ecosystem`	Search MCP ecosystem
`get_popular_mcp_servers`	Popular MCP servers
`get_sperax_mcp_servers`	All Sperax MCP servers

Example Requests

Search MCP ecosystem:

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_mcp_ecosystem","arguments":{"query":"crypto defi"}}}'

Popular MCP servers:

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_popular_mcp_servers","arguments":{"category":"crypto"}}}'

All Sperax MCP servers:

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_sperax_mcp_servers","arguments":{}}}'

List All Tools

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Also Available On

SperaxOS - source for the MCP marketplace. The hosted marketplace is offline while hosting is being migrated.
All 27 MCP servers — See the full catalog at modelcontextprotocol.name

Powered by modelcontextprotocol.name — the open MCP HTTP gateway

Documentation

Full documentation site: https://nirholas.github.io/lyra-registry/

Getting started covers install and first run.
Examples has copy-paste snippets.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessSlow

Resources

Need Help?

Related Servers

Related MCP Connectors

MCPExplorer A
io.github.mcpexplorer
Search, vet & assemble MCP servers from your agent: verified tools, risk labels, and trust scores.
Developer Tools Search Agent Orchestration
1421
MCP Junction A
ai.mcpjunction
Search a nightly-refreshed directory of MCP servers by keyword, category or topic.
Search Developer Tools
51
H-Index A
ai.xr-utilities
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Search Documentation Access
2
Chain.Love MCP C
love.chain.app
Hosted MCP gateway for Web3 infra discovery across 20+ networks via one endpoint.
Web3 & Decentralized Tech Blockchain Networking & Infrastructure
52

Related MCP Servers

MCP Servers Search
Search Developer Tools
atonomus
A
license
Not graded
quality
D
maintenance
Enables discovery and querying of available MCP servers from the official repository. Supports searching by name, description, features, categories, and provides random server suggestions for exploration.
Updated a year ago (2025-06-29 18:37 UTC)
15 npm
3
MIT
Agent Index MCP Server
Search Developer Tools Agent Orchestration
CIII-glitch
F
license
Not graded
quality
Not graded
maintenance
Enables users to search and discover over 500 AI agent endpoints and x402 APIs directly from MCP-compatible clients like Claude and Cursor. It provides tools to query endpoints by keyword, category, or capability while offering access to detailed provider statistics.
Updated 8 months ago (2026-01-31 00:05 UTC)
-
Onesource MCP
Blockchain Web3 & Decentralized Tech Documentation Access
blockparty-global
A
license
A
quality
B
maintenance
MCP server with 43 tools for blockchain data — token lookups, wallet balances, live chain queries across 10+ networks, and full API documentation search.
Updated 2 hours ago (2026-09-23 22:30 UTC)
27
889 npm
Apache 2.0
agentalmanac-mcp
Search Developer Tools Agent Orchestration
survivorforge
A
license
A
quality
D
maintenance
Enables searching and retrieving details of 9,000+ MCP servers from the Agent Almanac catalog, allowing agents to discover, inspect, and install tools directly.
Updated 4 months ago (2026-05-20 14:23 UTC)
3
47 npm
MIT

🌙 Lyra Registry

✨ Features

🏗️ Tech Stack

🚀 Quick Start

1. Clone and Install

2. Set Up Database

3. Run Migrations

4. Seed Database

5. Start Development Server

📡 API Reference

Tools

Search & Discovery

Query Parameters

/api/tools and /api/search

/api/trending

Example Requests

⭐ Trust Score Algorithm

Grades

📁 Project Structure

🚢 Deployment

Vercel

Railway

🤝 Integration with Lyra Ecosystem

Auto-Seeding from Lyra MCP Server

Discovery Pipeline (via Lyra-Intel)

📜 License

🔗 Links

🌐 Live HTTP Deployment

Connect from any MCP Client

Available Tools (3)

Example Requests

List All Tools

Also Available On

Documentation

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Servers Search

Agent Index MCP Server

Onesource MCP

agentalmanac-mcp

`/api/tools` and `/api/search`

`/api/trending`