get_project
Get full details for a specific Ai project by its slug. Returns description, URLs, stats, category, tags, and more.
Browse the AiList directory from chat — filter by category, sort by stars or views, see what is moving this week by star velocity, and submit or update your own listing with a key.
LABSCO SUMMARY
search_projects, get_project, list_categories, get_trending and get_stats all work with no credential, while submit_project and update_project gate on AILIST_API_KEY — and because update_project ties editing rights to the key a listing was created with, losing that key means losing the ability to correct your own entry. The other thing worth knowing is that get_trending sorts by star velocity rather than star count, so it answers what is gaining ground this week rather than what is biggest.
A client for the AiList project directory with 7 tools: search across the listings, full detail for one project, the category list with counts, this week's trending, directory statistics, and submitting or updating an entry.
The read tools need nothing at all. submit_project and update_project require AILIST_API_KEY, and update_project also requires that the listing was created with that same key — ownership here is held by the key rather than by an account, so the key is what you need to keep.
One command — claude mcp add ailist -- npx -y ailist-mcp
USE CASES
Read the category list to pick a real filter value, search within it sorted by stars, then pull the full record for the entry that looks right.
Read the trending list ordered by star velocity, and set it against how many projects the directory holds and how many arrived this week.
Submit the repo with its package names, tags and creator details, then revise the same slug whenever a version ships or the description drifts.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_projectGet full details for a specific Ai project by its slug. Returns description, URLs, stats, category, tags, and more.
get_statsGet AiList directory statistics including total projects, projects added this week, and category breakdowns.
get_trendingGet trending Ai projects on AiList this week, sorted by star velocity. Discover what is popular and gaining traction in the Ai community.
list_categoriesList all available project categories on AiList with project counts. Use this to discover what types of Ai projects are in the directory.
search_projectsSearch 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.
submit_projectSubmit 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/
update_projectUpdate 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.
BEFORE YOU INSTALL
7 tools when we connected. update_project, which edits a listing you own, is undocumented. The five read tools work without a key; submit_project and update_project need AILIST_API_KEY.
npx on PATH
All 3 documented setups run the server on your machine.
CONTEXT COST
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
claude mcp add ailist -- npx -y ailist-mcp{
"mcpServers": {
"ailist": {
"command": "npx",
"args": [
"-y",
"ailist-mcp"
]
}
}
}{
"mcpServers": {
"ailist": {
"command": "npx",
"args": [
"-y",
"ailist-mcp"
],
"env": {
"AILIST_API_KEY": "<YOUR_AILIST_API_KEY>"
}
}
}
}