ailist-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ailist-mcp what AI projects are trending this week?"
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.
AiList MCP Server
"List my project on AiList" — one sentence to your AI agent and your project is discoverable by thousands of AI coding assistants.
AiList MCP connects Claude Code to a curated directory of Ai projects. Search MCP servers, CLI tools, libraries, and APIs — or submit your own project without leaving your terminal.
Quick Setup
Option 1: npx (no install needed)
Add to your .mcp.json:
{
"mcpServers": {
"ailist": {
"command": "npx",
"args": ["-y", "ailist-mcp"]
}
}
}Option 2: Claude Code CLI
claude mcp add ailist -- npx -y ailist-mcpOption 3: With API key (for submitting projects)
{
"mcpServers": {
"ailist": {
"command": "npx",
"args": ["-y", "ailist-mcp"],
"env": {
"AILIST_API_KEY": "your-api-key-here"
}
}
}
}Get your free API key at hifriendbot.com/ai-list/submit/
Related MCP server: Skillselion MCP server
What Can Your Agent Do?
List your project — Tell your agent "list my project on AiList" and it reads your repo, fills in the details, and submits. Your project goes live in minutes after auto-review.
Discover tools — Your agent searches the directory to find the right MCP server, library, or CLI tool for the job. No more browsing — just ask.
See what's trending — Find out what Ai projects are gaining traction this week, sorted by star velocity.
Environment Variables
Variable | Required | Description |
| No | API key for submitting projects. Get one free at hifriendbot.com/ai-list/submit/ |
| No | Override API base URL (defaults to hifriendbot.com) |
No API key is needed for searching and browsing. All read operations are free and unauthenticated.
Available Tools
search_projects
Search and browse Ai projects. Supports filtering by category and sorting.
search_projects(query: "mcp server", category: "mcp-server", sort: "stars")Parameters:
query(string, optional) — Search querycategory(string, optional) — Filter: mcp-server, cli-tool, library, web-app, api, plugin, model, dataset, agent, otherbuilt_with(string, optional) — Filter by technology (e.g. "Claude Code", "Cursor")sort(string, default "stars") — Sort by: stars, trending, newest, name, viewspage(int, default 1) — Page numberper_page(int, default 24, max 100) — Results per page
get_project
Get full details for a specific project by slug.
get_project(slug: "cogmemai-mcp")Parameters:
slug(string, required) — The project's URL slug
list_categories
List all project categories with counts.
list_categories()No parameters.
get_trending
Discover trending Ai projects this week, sorted by star velocity.
get_trending(limit: 10)Parameters:
limit(int, default 20, max 50) — Number of results
get_stats
Get directory-wide statistics.
get_stats()No parameters. Returns total projects, added this week, category breakdowns.
submit_project
Submit your project to the directory. Requires AILIST_API_KEY.
submit_project(
name: "My Tool",
tagline: "Does something cool",
url: "https://example.com",
category: "cli-tool"
)Parameters:
name(string, required) — Project nametagline(string, optional) — Short descriptiondescription(string, optional) — Full description (markdown)url(string, optional) — Homepage URLgithub_url(string, optional) — GitHub repo URLnpm_package(string, optional) — npm package namepypi_package(string, optional) — PyPI package namecategory(string, optional) — Project categorytags(string, optional) — Comma-separated tagsbuilt_with(string, optional) — Technologies usedcreator_name(string, optional) — Creator namecreator_url(string, optional) — Creator URL
Examples
List your project:
"Hey Claude, list my project on AiList"Your agent reads your repo and calls submit_project with the right details.
Find MCP servers:
search_projects(query: "memory", category: "mcp-server")See what's trending:
get_trending(limit: 5)Browse by technology:
search_projects(built_with: "Claude Code", sort: "stars")About AiList
AiList is a curated directory of Ai projects. Every listing gets its own SEO-indexed page, and the REST API is 100% public — making your project discoverable by both humans and AI agents.
License
MIT
Available Tools
7 toolsget_projectA
Get full details for a specific Ai project by its slug. Returns description, URLs, stats, category, tags, and more.
Inputs: slug (required).
get_statsA
Get AiList directory statistics including total projects, projects added this week, and category breakdowns.
Inputs: no named parameters.
get_trendingA
Get trending Ai projects on AiList this week, sorted by star velocity. Discover what is popular and gaining traction in the Ai community.
Inputs: limit.
list_categoriesA
List all available project categories on AiList with project counts. Use this to discover what types of Ai projects are in the directory.
Inputs: no named parameters.
search_projectsA
Search and browse Ai projects on AiList. Find MCP servers, CLI tools, libraries, web apps, APIs, plugins, models, datasets, and agents. Supports filtering by category and sorting by stars, trending, newest, name, or views.
Inputs: page, sort, query, category, +2 more.
submit_projectA
Submit a project to AiList. When a user says "list my project on AiList", read their repo and call this with the details. The project goes live in minutes after auto-review. Requires AILIST_API_KEY env var — get a free key at hifriendbot.com/ai-list/submit/
Inputs: name (required), url, tags, tagline, +8 more.
update_projectA
Update an existing project on AiList. You must own the project (submitted with the same API key). Use this to keep listings current when new features ship or versions change. Requires AILIST_API_KEY env var.
Inputs: slug (required), url, tags, tagline, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: trending discovery, searching, single project retrieval, category listing, stats, project submission, and project update. No overlapping functionality.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_trending, search_projects, submit_project), making the intent immediately clear.
7 tools is well-scoped for a project directory server, covering browsing, searching, details, categories, stats, and write operations without unnecessary bloat.
Covers most core CRUD operations (read, search, create, update) but lacks a delete tool. However, the domain probably doesn't need deletion often, and other important workflows are present.
Maintenance
Related MCP Connectors
Search a curated directory of open-source AI agents, MCP servers and AI developer tools.
Search and fetch curated AI agent skills, prompts and MCP servers.
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
Free, source-checked directory of AI agent tools, MCP servers and skills, with read-only search.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to search, discover, and get recommendations from 20,000+ skills, tools, agents, rules, and MCP servers.528 npm1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search a curated directory of Claude Code agent skills, MCP servers, and plugin marketplaces ranked by community signal.4139 npm2MIT
- AlicenseAqualityDmaintenanceEnables AI agents to search a directory of 13,870+ MCP servers, 4,384+ agent skills, and plugins from Remote OpenClaw, returning install commands directly.367 npm7MIT

plugandship-mcpofficial
AlicenseAqualityCmaintenanceEnables coding agents to search an index of 22k+ MCP servers, agent skills and coding-agent plugins directly from chat, returning matches with stars, install commands and page links, plus trending repos and curated best-of topic lists. Read-only, no API key required, usable via a hosted HTTP endpoint or locally over stdio.4MIT