{
  "markdown": "# AiList MCP Server\n\n**\"List my project on AiList\"** — one sentence to your AI agent and your project is discoverable by thousands of AI coding assistants.\n\nAiList MCP connects Claude Code to a [curated directory of Ai projects](https://hifriendbot.com/ai-list/). Search MCP servers, CLI tools, libraries, and APIs — or submit your own project without leaving your terminal.\n\n## Quick Setup\n\n### Option 1: npx (no install needed)\n\nAdd to your `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ailist\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ailist-mcp\"]\n    }\n  }\n}\n```\n\n### Option 2: Claude Code CLI\n\n```bash\nclaude mcp add ailist -- npx -y ailist-mcp\n```\n\n### Option 3: With API key (for submitting projects)\n\n```json\n{\n  \"mcpServers\": {\n    \"ailist\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ailist-mcp\"],\n      \"env\": {\n        \"AILIST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nGet your free API key at [hifriendbot.com/ai-list/submit/](https://hifriendbot.com/ai-list/submit/)\n\n## What Can Your Agent Do?\n\n**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.\n\n**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.\n\n**See what's trending** — Find out what Ai projects are gaining traction this week, sorted by star velocity.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `AILIST_API_KEY` | No | API key for submitting projects. Get one free at [hifriendbot.com/ai-list/submit/](https://hifriendbot.com/ai-list/submit/) |\n| `AILIST_API_URL` | No | Override API base URL (defaults to hifriendbot.com) |\n\n**No API key is needed for searching and browsing.** All read operations are free and unauthenticated.\n\n## Available Tools\n\n### search_projects\n\nSearch and browse Ai projects. Supports filtering by category and sorting.\n\n```\nsearch_projects(query: \"mcp server\", category: \"mcp-server\", sort: \"stars\")\n```\n\n**Parameters:**\n- `query` (string, optional) — Search query\n- `category` (string, optional) — Filter: mcp-server, cli-tool, library, web-app, api, plugin, model, dataset, agent, other\n- `built_with` (string, optional) — Filter by technology (e.g. \"Claude Code\", \"Cursor\")\n- `sort` (string, default \"stars\") — Sort by: stars, trending, newest, name, views\n- `page` (int, default 1) — Page number\n- `per_page` (int, default 24, max 100) — Results per page\n\n### get_project\n\nGet full details for a specific project by slug.\n\n```\nget_project(slug: \"cogmemai-mcp\")\n```\n\n**Parameters:**\n- `slug` (string, required) — The project's URL slug\n\n### list_categories\n\nList all project categories with counts.\n\n```\nlist_categories()\n```\n\nNo parameters.\n\n### get_trending\n\nDiscover trending Ai projects this week, sorted by star velocity.\n\n```\nget_trending(limit: 10)\n```\n\n**Parameters:**\n- `limit` (int, default 20, max 50) — Number of results\n\n### get_stats\n\nGet directory-wide statistics.\n\n```\nget_stats()\n```\n\nNo parameters. Returns total projects, added this week, category breakdowns.\n\n### submit_project\n\nSubmit your project to the directory. Requires `AILIST_API_KEY`.\n\n```\nsubmit_project(\n  name: \"My Tool\",\n  tagline: \"Does something cool\",\n  url: \"https://example.com\",\n  category: \"cli-tool\"\n)\n```\n\n**Parameters:**\n- `name` (string, required) — Project name\n- `tagline` (string, optional) — Short description\n- `description` (string, optional) — Full description (markdown)\n- `url` (string, optional) — Homepage URL\n- `github_url` (string, optional) — GitHub repo URL\n- `npm_package` (string, optional) — npm package name\n- `pypi_package` (string, optional) — PyPI package name\n- `category` (string, optional) — Project category\n- `tags` (string, optional) — Comma-separated tags\n- `built_with` (string, optional) — Technologies used\n- `creator_name` (string, optional) — Creator name\n- `creator_url` (string, optional) — Creator URL\n\n## Examples\n\n**List your project:**\n```\n\"Hey Claude, list my project on AiList\"\n```\nYour agent reads your repo and calls `submit_project` with the right details.\n\n**Find MCP servers:**\n```\nsearch_projects(query: \"memory\", category: \"mcp-server\")\n```\n\n**See what's trending:**\n```\nget_trending(limit: 5)\n```\n\n**Browse by technology:**\n```\nsearch_projects(built_with: \"Claude Code\", sort: \"stars\")\n```\n\n## About AiList\n\n[AiList](https://hifriendbot.com/ai-list/) 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.\n\n## License\n\nMIT\n",
  "bytes": 4710,
  "sha": "cb03a7c9caa169376da877a9fb9240d00390df73fe3d03e214238e3061b396d0",
  "repo_slug": "hifriendbot/ailist-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hifriendbot_ailist_mcp_62b70ae4/readme"
}