HostedMCP kataloğu geliştiricilere üç şekilde açıktır: bir REST API, AI istemcinizin çağırabileceği bir MCP server ve indirebileceğiniz bir veri kümesi. Üçü de ücretsizdir, salt okunurdur ve anahtar gerektirmez.
REST API
Temel URL: https://api.hostedmcp.org/v1. Her yanıt JSON'dur. İstekler IP adresi başına dakikada 300 ile sınırlıdır; bunun üzerinde Retry-After: 60 başlığıyla HTTP 429 alırsınız. Yanıtlar beş dakika boyunca önbelleğe alınabilir ve CORS açıktır, yani API'yi tarayıcıdan çağırabilirsiniz.
| Yöntem ve yol | Ne döndürür |
|---|---|
GET /servers |
MCP server'lar, en iyiden başlayarak. Sorgu: q, category, transport (stdio veya remote), official, verified, sort (quality, stars, downloads, new), limit (en fazla 50), cursor |
GET /servers/{owner}/{name} |
Tek bir server: paketler, ortam değişkenleri, araçlar, lisans, otomatik kontroller ve SSS |
GET /servers/{owner}/{name}/install?client=cursor |
Tek bir istemci için yapılandırma parçacığı, bunun konulacağı dosya, istemcinin kurulum adımları, bir Cursor kurulum bağlantısı ve VS Code code --add-mcp komutu |
GET /skills |
Agent Skills. Sorgu: q, category, sort (quality, stars, new), limit, cursor |
GET /skills/{owner}/{name} |
Tek bir skill: depo, klasör, lisans, önceden onaylanmış araçlar, dosyalar ve kontroller |
GET /search?q=postgres |
Bir sorguyla eşleşen server'lar ve skill'ler. İsteğe bağlı type (all, server, skill) ve limit (en fazla 20) |
GET /badge/{server or skill}/{owner}/{name}.svg |
Kontrol puanını gösteren README rozeti |
Listeler items, total ve nextCursor döndürür; sonraki sayfa için nextCursor değerini cursor olarak geri gönderin, null olana kadar. Kurulum yapılandırması şu istemciler için çalışır: claude-code, cursor, vscode, claude-desktop, codex, gemini-cli, windsurf, devin, antigravity, chatgpt, zed, cline, continue, goose ve jetbrains.
curl "https://api.hostedmcp.org/v1/servers?q=postgres&transport=remote&limit=3"
curl "https://api.hostedmcp.org/v1/servers/github/github-mcp-server/install?client=cursor"
Hatalar {"error": {"code", "message", "requestId"}} biçiminde gelir; hatalı bir parametre için HTTP 400, bilinmeyen bir kayıt için 404 ve bir server'ın seçilen istemcinin çalıştırabileceği hiçbir şeyi olmadığında 422 döner. README ve SKILL.md dosyaları API'nin parçası değildir: yazarlarına aittir, bu yüzden repo bağlantısını izleyin. <YOUR_API_KEY> gibi yer tutucular her yapılandırmada gizli değerlerin yerini tutar.
MCP server
Aynı katalog, https://api.hostedmcp.org/mcp adresinde bir MCP server olarak da sunulur (Streamable HTTP, oturum açma gerekmez). Sunucuları ve becerileri arama, birini okuma, kategorileri listeleme ve kurulum yapılandırmasını alma araçları içerir. Claude Code'a eklemek için:
claude mcp add --transport http hostedmcp https://api.hostedmcp.org/mcp
Veri Kümesi
Her hafta dışa aktarılan, dizinlenebilir tüm MCP server, Agent Skills ve eklentilerin JSON biçimindeki hali CC BY 4.0 lisansı altında github.com/Caqil/mcp-servers-dataset adresinde bulunur.
Adil kullanım ve atıf
Verileri kendi araçlarınızda, araştırmalarınızda ve makalelerinizde kullanın. Bunların üzerine inşa ettiğiniz bir şeyi yayımlarsanız, hostedmcp.org bağlantısıyla "HostedMCP" olarak atıfta bulunun. Çağrılar, IP adresiniz saklanmadan rota bazında sayılır; bkz. gizlilik politikası. Sorularınız veya daha yüksek bir limit için: legal@hostedmcp.org.