Skip to main content
Glama
ailist-mcp

ailist-mcp

by hifriendbot

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/

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

AILIST_API_KEY

No

API key for submitting projects. Get one free at hifriendbot.com/ai-list/submit/

AILIST_API_URL

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

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

Available Tools

7 tools
get_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.

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

    A4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: trending discovery, searching, single project retrieval, category listing, stats, project submission, and project update. No overlapping functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., get_trending, search_projects, submit_project), making the intent immediately clear.

    Tool Count5/5

    7 tools is well-scoped for a project directory server, covering browsing, searching, details, categories, stats, and write operations without unnecessary bloat.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search, discover, and get recommendations from 20,000+ skills, tools, agents, rules, and MCP servers.
      5
      28 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to search a directory of 13,870+ MCP servers, 4,384+ agent skills, and plugins from Remote OpenClaw, returning install commands directly.
      3
      67 npm
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      4
      MIT