AI Tool Discovery Agent

AI agent discovers MCP servers from GitHub npm - analyzes APIs configs

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ai-tool-discovery-agent": {
      "command": "npx",
      "args": [
        "-y",
        "ai-tool-discovery-agent"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

🔮 Lyra Tool Discovery

AI-powered tool discovery for the MCP ecosystem

Documentation · CLI Reference · Examples · Contributing

📖 Overview

Lyra Tool Discovery is an AI-powered automation tool designed specifically for the crypto, DeFi, blockchain, and web3 ecosystem. It solves the painful problem of manually discovering, evaluating, and integrating MCP (Model Context Protocol) servers into your crypto-focused applications. Instead of spending hours searching GitHub, reading READMEs, and figuring out the right integration approach, Lyra does it for you in seconds.

The tool crawls multiple sources—GitHub and npm—to find crypto-related MCP servers, APIs, and plugins. It filters results to focus exclusively on blockchain, DeFi, web3, and cryptocurrency tooling (including Ethereum, Solana, Bitcoin, wallets, tokens, NFTs, DEXs, staking, bridges, and more). Lyra then leverages state-of-the-art AI (OpenAI GPT-4o or Anthropic Claude) to analyze each discovered tool and automatically generates ready-to-use plugin configurations.

🪙 Crypto Focus

Lyra is optimized for discovering tools related to:

Blockchain Networks — Ethereum, Solana, Bitcoin, Layer 2s, bridges
DeFi Protocols — DEXs, lending, staking, yield farming, liquidity
Web3 Infrastructure — Wallets, RPC providers, indexers, oracles
Token Standards — ERC-20, ERC-721, NFTs, token swaps
Smart Contracts — Development, auditing, deployment tools
On-chain Data — Analytics, explorers, transaction tracking

Lyra is built for crypto MCP ecosystem developers who need to rapidly onboard new tools, plugin marketplace operators like plugin.delivery who curate crypto plugins, and automation engineers building CI/CD pipelines for DeFi tool discovery and deployment.

This tool is a critical piece of the discovery-to-deployment pipeline: lyra-tool-discovery → github-to-mcp → plugin.delivery → SperaxOS users. By automating the discovery and classification phase, Lyra enables fully automated plugin onboarding with minimal human intervention.

✨ Features

🤖 Multi-Provider AI

OpenAI — GPT-4o, GPT-4-turbo, GPT-3.5-turbo
Anthropic — Claude Sonnet 4, Claude Opus
Auto-detection from environment variables
Custom model selection via CLI or config
Intelligent fallback between providers

📦 8 Plugin Templates

mcp-http — Remote MCP servers (HTTP/SSE)
mcp-stdio — Local MCP servers (stdio)
openapi — REST API integrations
standalone — Full React applications
markdown — Rich text/documentation
default — Configurable plugins
settings — User preference plugins
basic — Simple function plugins

🔍 Discovery Sources

GitHub — Search repos, topics, READMEs
npm — Package registry search
🔜 Smithery (MCP directory)
🔜 OpenAPI Directory
🔜 RapidAPI

🪙 Crypto Filtering

Keywords — crypto, defi, blockchain, web3
Networks — ethereum, solana, bitcoin
Protocols — wallet, token, nft, dex, staking
Age Filter — Only repos updated within 12 months
Smart Validation — AI validates crypto relevance
Full-featured command-line interface
Node.js/TypeScript SDK for automation
JSON output for CI/CD pipelines
Dry-run mode for testing
Progress indicators and rich output

🖥️ CLI & Programmatic API

Full-featured command-line interface
Node.js/TypeScript SDK for automation
JSON output for CI/CD pipelines
Dry-run mode for testing
Progress indicators and rich output

🧪 Testing & Validation

--dry-run mode for safe testing
List discovered tools without AI calls
Validate configurations before deployment
Debug logging for troubleshooting

📤 Flexible Output

Structured JSON for piping to other tools
Quick Import format for SperaxOS
Plugin manifests for plugin.delivery
Console output with rich formatting

🪙 Crypto Discovery Keywords

Lyra automatically filters discovery results to focus on crypto/DeFi/blockchain/web3 tools. The following keywords are used for both search queries and result validation:

View all supported keywords

Category	Keywords
General	crypto, cryptocurrency, defi, blockchain, web3
Networks	ethereum, eth, solana, sol, bitcoin, btc, chain
Tokens	token, erc20, erc721, nft
DeFi	dex, swap, staking, yield, lending, liquidity, vault, bridge
Infrastructure	wallet, protocol, onchain, on-chain, smart contract
Libraries	web3.js, ethers, viem, wagmi, rainbowkit
Protocols	uniswap, aave, compound

Tools that don't match any of these keywords are automatically filtered out, ensuring you only discover crypto-relevant MCP servers.

Age Filtering

By default, Lyra only discovers tools that have been updated within the last 12 months. This ensures you're finding actively maintained projects. Use --max-age to adjust:

bash

# Only tools updated in the last 6 months
lyra-discover discover --max-age 6

# Only tools updated in the last 3 months (bleeding edge)
lyra-discover discover --max-age 3

# Tools up to 24 months old
lyra-discover discover --max-age 24

Quick Start

Installation

bash

# Global install (recommended for CLI usage)
pnpm add -g @nirholas/lyra-tool-discovery

# Or with npm
npm install -g @nirholas/lyra-tool-discovery

# Or as a project dependency
pnpm add @nirholas/lyra-tool-discovery

# Or run directly with npx (no install)
npx @nirholas/lyra-tool-discovery discover --help

Environment Setup

server.ts

# Using OpenAI (default when both keys present)
export OPENAI_API_KEY="sk-..."

# Or using Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# Optional: Force a specific provider
export AI_PROVIDER="anthropic"  # or "openai"

# Optional: Specify a model
export AI_MODEL="claude-sonnet-4-20250514"

# Optional: GitHub token for higher rate limits
export GITHUB_TOKEN="ghp_..."

First Discovery

bash

# Discover MCP servers from GitHub and npm
lyra-discover discover --sources github,npm --limit 10

# Run in dry-run mode (no AI calls)
lyra-discover discover --dry-run --limit 20

# Analyze a specific GitHub repository
lyra-discover analyze-repo anthropics claude-mcp

# Analyze an npm package
lyra-discover analyze-npm @modelcontextprotocol/server-github

# Check available AI providers
lyra-discover providers

# View all plugin templates
lyra-discover templates

📖 CLI Reference

Global Options

Flag	Alias	Description	Default
`--provider`	`-p`	AI provider (`openai` or `anthropic`)	Auto-detect from env
`--model`	`-m`	AI model to use	Provider default
`--version`	`-V`	Show version number	—
`--help`	`-h`	Show help	—

Commands

`discover`

Search for MCP tools and APIs across configured sources.

bash

lyra-discover discover [options]

Option	Alias	Description	Default
`--sources`	`-s`	Comma-separated sources: `github`, `npm`, `awesome-list`	`github,npm`
`--limit`	`-l`	Maximum tools to discover per source	`5`
`--max-age`	`-a`	Maximum age in months for discovered repos	`12`
`--dry-run`	`-d`	List tools without AI analysis	`false`
`--provider`	`-p`	AI provider to use	Auto-detect
`--model`	`-m`	AI model to use	Provider default

Examples:

bash

# Discover crypto MCP tools from GitHub only, limit 10 results
lyra-discover discover --sources github --limit 10

# Find tools updated in the last 6 months only
lyra-discover discover --max-age 6 --limit 20

# Dry run to preview what would be analyzed
lyra-discover discover --dry-run --sources npm --limit 20

# Use Anthropic Claude for analysis
lyra-discover discover --provider anthropic --model claude-sonnet-4-20250514

# Use OpenAI GPT-4o for analysis
lyra-discover discover --provider openai --model gpt-4o

Example Output:

Code

🔍 Discovering crypto/DeFi/web3 tools from: github, npm
📅 Max age: 12 months
  Found 5 from github
  Found 3 from npm

📊 Total discovered: 8 tools
🪙 Crypto-related: 6 tools
🔌 MCP-compatible: 5 tools

🤖 Analyzing: mcp-server-ethereum...
  Template: mcp-stdio
  Reasoning: Has MCP SDK dependency and bin entry for local execution

✅ Analyzed 5 tools

📦 Generated Configs:

--- mcp-server-ethereum ---
Template: mcp-stdio
Config: {
  "identifier": "mcp-server-ethereum",
  "customParams": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-server-ethereum"]
    }
  }
}

`analyze-repo`

Analyze a specific GitHub repository.

bash

lyra-discover analyze-repo <owner> <repo> [options]

Argument	Description
`owner`	GitHub repository owner/organization
`repo`	Repository name

Option	Alias	Description
`--provider`	`-p`	AI provider to use
`--model`	`-m`	AI model to use

Examples:

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about AI Tool Discovery Agent

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ai-tool-discovery-agent": { "command": "npx", "args": ["-y", "AI Tool Discovery Agent"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

AI Tool Discovery Agent AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ai-tool-discovery-agent?style=directory)](https://allmcps.com/mcp/ai-tool-discovery-agent)

HTML Embed

<a href="https://allmcps.com/mcp/ai-tool-discovery-agent"><img src="https://allmcps.com/api/badge/ai-tool-discovery-agent?style=directory" alt="AI Tool Discovery Agent on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to AI Tool Discovery Agent →Install in Claude Desktop Install in Cursor Install in VS Code

AI Tool Discovery Agent

AI agent discovers MCP servers from GitHub npm - analyzes APIs configs

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ai-tool-discovery-agent": {
      "command": "npx",
      "args": [
        "-y",
        "ai-tool-discovery-agent"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

🔮 Lyra Tool Discovery

AI-powered tool discovery for the MCP ecosystem

Documentation · CLI Reference · Examples · Contributing

📖 Overview

🪙 Crypto Focus

Lyra is optimized for discovering tools related to:

Blockchain Networks — Ethereum, Solana, Bitcoin, Layer 2s, bridges
DeFi Protocols — DEXs, lending, staking, yield farming, liquidity
Web3 Infrastructure — Wallets, RPC providers, indexers, oracles
Token Standards — ERC-20, ERC-721, NFTs, token swaps
Smart Contracts — Development, auditing, deployment tools
On-chain Data — Analytics, explorers, transaction tracking

✨ Features

🤖 Multi-Provider AI

OpenAI — GPT-4o, GPT-4-turbo, GPT-3.5-turbo
Anthropic — Claude Sonnet 4, Claude Opus
Auto-detection from environment variables
Custom model selection via CLI or config
Intelligent fallback between providers

📦 8 Plugin Templates

mcp-http — Remote MCP servers (HTTP/SSE)
mcp-stdio — Local MCP servers (stdio)
openapi — REST API integrations
standalone — Full React applications
markdown — Rich text/documentation
default — Configurable plugins
settings — User preference plugins
basic — Simple function plugins

🔍 Discovery Sources

GitHub — Search repos, topics, READMEs
npm — Package registry search
🔜 Smithery (MCP directory)
🔜 OpenAPI Directory
🔜 RapidAPI

🪙 Crypto Filtering

Keywords — crypto, defi, blockchain, web3
Networks — ethereum, solana, bitcoin
Protocols — wallet, token, nft, dex, staking
Age Filter — Only repos updated within 12 months
Smart Validation — AI validates crypto relevance
Full-featured command-line interface
Node.js/TypeScript SDK for automation
JSON output for CI/CD pipelines
Dry-run mode for testing
Progress indicators and rich output

🖥️ CLI & Programmatic API

Full-featured command-line interface
Node.js/TypeScript SDK for automation
JSON output for CI/CD pipelines
Dry-run mode for testing
Progress indicators and rich output

🧪 Testing & Validation

--dry-run mode for safe testing
List discovered tools without AI calls
Validate configurations before deployment
Debug logging for troubleshooting

📤 Flexible Output

Structured JSON for piping to other tools
Quick Import format for SperaxOS
Plugin manifests for plugin.delivery
Console output with rich formatting

🪙 Crypto Discovery Keywords

Lyra automatically filters discovery results to focus on crypto/DeFi/blockchain/web3 tools. The following keywords are used for both search queries and result validation:

View all supported keywords

Category	Keywords
General	crypto, cryptocurrency, defi, blockchain, web3
Networks	ethereum, eth, solana, sol, bitcoin, btc, chain
Tokens	token, erc20, erc721, nft
DeFi	dex, swap, staking, yield, lending, liquidity, vault, bridge
Infrastructure	wallet, protocol, onchain, on-chain, smart contract
Libraries	web3.js, ethers, viem, wagmi, rainbowkit
Protocols	uniswap, aave, compound

Tools that don't match any of these keywords are automatically filtered out, ensuring you only discover crypto-relevant MCP servers.

Age Filtering

By default, Lyra only discovers tools that have been updated within the last 12 months. This ensures you're finding actively maintained projects. Use --max-age to adjust:

bash

# Only tools updated in the last 6 months
lyra-discover discover --max-age 6

# Only tools updated in the last 3 months (bleeding edge)
lyra-discover discover --max-age 3

# Tools up to 24 months old
lyra-discover discover --max-age 24

Quick Start

Installation

bash

# Global install (recommended for CLI usage)
pnpm add -g @nirholas/lyra-tool-discovery

# Or with npm
npm install -g @nirholas/lyra-tool-discovery

# Or as a project dependency
pnpm add @nirholas/lyra-tool-discovery

# Or run directly with npx (no install)
npx @nirholas/lyra-tool-discovery discover --help

Environment Setup

server.ts

# Using OpenAI (default when both keys present)
export OPENAI_API_KEY="sk-..."

# Or using Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# Optional: Force a specific provider
export AI_PROVIDER="anthropic"  # or "openai"

# Optional: Specify a model
export AI_MODEL="claude-sonnet-4-20250514"

# Optional: GitHub token for higher rate limits
export GITHUB_TOKEN="ghp_..."

First Discovery

bash

# Discover MCP servers from GitHub and npm
lyra-discover discover --sources github,npm --limit 10

# Run in dry-run mode (no AI calls)
lyra-discover discover --dry-run --limit 20

# Analyze a specific GitHub repository
lyra-discover analyze-repo anthropics claude-mcp

# Analyze an npm package
lyra-discover analyze-npm @modelcontextprotocol/server-github

# Check available AI providers
lyra-discover providers

# View all plugin templates
lyra-discover templates

📖 CLI Reference

Global Options

Flag	Alias	Description	Default
`--provider`	`-p`	AI provider (`openai` or `anthropic`)	Auto-detect from env
`--model`	`-m`	AI model to use	Provider default
`--version`	`-V`	Show version number	—
`--help`	`-h`	Show help	—

Commands

`discover`

Search for MCP tools and APIs across configured sources.

bash

lyra-discover discover [options]

Option	Alias	Description	Default
`--sources`	`-s`	Comma-separated sources: `github`, `npm`, `awesome-list`	`github,npm`
`--limit`	`-l`	Maximum tools to discover per source	`5`
`--max-age`	`-a`	Maximum age in months for discovered repos	`12`
`--dry-run`	`-d`	List tools without AI analysis	`false`
`--provider`	`-p`	AI provider to use	Auto-detect
`--model`	`-m`	AI model to use	Provider default

Examples:

bash

# Discover crypto MCP tools from GitHub only, limit 10 results
lyra-discover discover --sources github --limit 10

# Find tools updated in the last 6 months only
lyra-discover discover --max-age 6 --limit 20

# Dry run to preview what would be analyzed
lyra-discover discover --dry-run --sources npm --limit 20

# Use Anthropic Claude for analysis
lyra-discover discover --provider anthropic --model claude-sonnet-4-20250514

# Use OpenAI GPT-4o for analysis
lyra-discover discover --provider openai --model gpt-4o

Example Output:

Code

🔍 Discovering crypto/DeFi/web3 tools from: github, npm
📅 Max age: 12 months
  Found 5 from github
  Found 3 from npm

📊 Total discovered: 8 tools
🪙 Crypto-related: 6 tools
🔌 MCP-compatible: 5 tools

🤖 Analyzing: mcp-server-ethereum...
  Template: mcp-stdio
  Reasoning: Has MCP SDK dependency and bin entry for local execution

✅ Analyzed 5 tools

📦 Generated Configs:

--- mcp-server-ethereum ---
Template: mcp-stdio
Config: {
  "identifier": "mcp-server-ethereum",
  "customParams": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-server-ethereum"]
    }
  }
}

`analyze-repo`

Analyze a specific GitHub repository.

bash

lyra-discover analyze-repo <owner> <repo> [options]

Argument	Description
`owner`	GitHub repository owner/organization
`repo`	Repository name

Option	Alias	Description
`--provider`	`-p`	AI provider to use
`--model`	`-m`	AI model to use

Examples:

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about AI Tool Discovery Agent

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ai-tool-discovery-agent": { "command": "npx", "args": ["-y", "AI Tool Discovery Agent"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ai-tool-discovery-agent?style=directory)](https://allmcps.com/mcp/ai-tool-discovery-agent)

HTML Embed

<a href="https://allmcps.com/mcp/ai-tool-discovery-agent"><img src="https://allmcps.com/api/badge/ai-tool-discovery-agent?style=directory" alt="AI Tool Discovery Agent on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to AI Tool Discovery Agent →Install in Claude Desktop Install in Cursor Install in VS Code