io.github.hifriendbot/ailist-mcp

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-mcp

Option 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/

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

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 query
• category (string, optional) — Filter: mcp-server, cli-tool, library, web-app, api, plugin, model, dataset, agent, other
• built_with (string, optional) — Filter by technology (e.g. "Claude Code", "Cursor")
• sort (string, default "stars") — Sort by: stars, trending, newest, name, views
• page (int, default 1) — Page number
• per_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 name
• tagline (string, optional) — Short description
• description (string, optional) — Full description (markdown)
• url (string, optional) — Homepage URL
• github_url (string, optional) — GitHub repo URL
• npm_package (string, optional) — npm package name
• pypi_package (string, optional) — PyPI package name
• category (string, optional) — Project category
• tags (string, optional) — Comma-separated tags
• built_with (string, optional) — Technologies used
• creator_name (string, optional) — Creator name
• creator_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