🔌 API Documentation

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

GET/api/tools

List all MCP tools with optional filtering and pagination.

Query Parameters

Parameter	Type	Description
category	string	Filter by category slug (e.g. "databases", "ai-ml")
search	string	Search across name, description, tags, language
limit	number	Max number of results (default: all)
offset	number	Number 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
curl https://mcphello.com/api/tools?category=databases

# 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

⚡ Rate Limits & Usage

• No API key required — all endpoints are public
• No rate limits — but please be reasonable
• JSON responses — standard REST API
• CORS enabled — works from browsers and servers
• Free forever — this is a community resource