← Back to Directory

🔌 API Documentation

Free, public API for discovering MCP tools programmatically. No API key required.

🤖 一键配置给 AI 智能体

复制以下配置到你的 AI 工具，让它直接搜索和推荐 MCP 工具。

OpenClaw / Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "mcphello": {
      "command": "npx",
      "args": [
        "-y",
        "mcphello-mcp"
      ]
    }
  }
}

配置后可用命令

  • 🔍 search_tools — 搜索 MCP 工具
  • 💡 recommend_tools — AI 智能推荐
  • 📋 get_tool_detail — 工具详情+安装配置
  • 📂 list_categories — 19个分类
  • 🔥 get_trending — 热门工具

开源项目：GitHub →

📡 REST API 文档

GET/api/tools

List all MCP tools with optional filtering and pagination.

Query Parameters

ParameterTypeDescription
categorystringFilter by category slug (e.g. "databases", "ai-ml")
searchstringSearch across name, description, tags, language
limitnumberMax number of results (default: all)
offsetnumberNumber of results to skip (default: 0)

Example

curl https://mcphello.com/api/tools?category=databases&limit=10

Response

{
  "total": 4,
  "tools": [
    {
      "slug": "sqlite-mcp",
      "name": "SQLite MCP Server",
      "description": "...",
      "category": "Databases",
      "categoryIcon": "🗄️",
      "githubUrl": "...",
      "stars": 42000,
      "language": "TypeScript",
      "scope": "Local",
      "tags": ["sqlite", "database", "sql"]
    }
  ]
}
GET/api/tools/:slug

Get detailed information about a single tool by its slug.

Example

curl https://mcphello.com/api/tools/github-mcp
GET/api/tools/random

Get a random MCP tool. Perfect for AI agents discovering new tools!

Example

curl https://mcphello.com/api/tools/random
GET/api/search?q=keyword

Search tools by keyword. Searches across names, descriptions, tags, categories, and languages.

Example

curl https://mcphello.com/api/search?q=browser

Response

{
  "query": "browser",
  "total": 5,
  "tools": [...]
}

📦 Tool Object Schema

{
  "slug": string,          // URL-friendly unique identifier
  "name": string,          // Display name
  "description": string,   // What this tool does
  "category": string,      // Category name (e.g. "Databases")
  "categoryIcon": string,  // Emoji icon
  "githubUrl": string,     // Link to GitHub repo
  "stars": number,         // GitHub stars
  "language": string,      // Primary language
  "scope": string,         // "Local" | "Cloud" | "Cloud/Local" | "Local/Cloud"
  "tags": string[]         // Searchable tags
}

🤖 Using with AI Agents

This API is designed to be easily consumed by AI agents and MCP clients. Here's how to use it in your tool chain:

# Discover a random tool daily
curl https://mcphello.com/api/tools/random

# Find all database tools (paginated)
curl "https://mcphello.com/api/tools?category=databases&limit=10"

# Search for browser automation tools
curl https://mcphello.com/api/search?q=browser+automation

# Get details for a specific tool
curl https://mcphello.com/api/tools/github-mcp

# Get AI recommendations with auto-config
curl -X POST https://mcphello.com/api/recommend \
  -H 'Content-Type: application/json' \
  -d '{"query":"database","maxResults":3}'

# Compare tools in a category
curl https://mcphello.com/api/compare?category=databases

# Get a quality score badge for README
curl https://mcphello.com/api/badge/github-mcp
POST/api/recommend

Get AI-powered tool recommendations with auto-generated MCP config. Perfect for AI platforms.

Request Body

{
  "query": "database",           // Optional: natural language query
  "category": "databases",     // Optional: filter by category
  "language": "TypeScript",    // Optional: filter by language
  "maxResults": 5             // Optional: max results (default 5)
}

Response

{
  "recommendations": [{
    "slug": "supabase-mcp",
    "name": "Supabase MCP",
    "qualityScore": 85,
    "installCommand": "npx -y supabase-mcp"
  }],
  "config": {
    "mcpServers": {
      "supabase-mcp": {
        "command": "npx",
        "args": ["-y", "supabase-mcp"]
      }
    }
  }
}

💡 The config field is ready to paste into claude_desktop_config.json.

GET/api/compare

Compare tools by category or by specific slugs.

Query Parameters

ParameterTypeDescription
categorystringCompare all tools in a category
slugsstringComma-separated tool slugs
GET/api/badge/[slug]

Get a quality score badge SVG for embedding in README files.

Embed in Markdown

[![MCP Score](https://mcphello.com/api/badge/your-tool-name)](https://mcphello.com/tool/your-tool-name)

⚡ 100% Free API

No API Key Required

  • • 速率限制：每个IP每天50次请求
  • • All endpoints available
  • • AI-powered recommendations
  • • Quality scores & trending data
  • • No registration needed

Just start making requests — no signup, no API key. Rate limited to ensure fair use.