Overview
Hub provides a search and discovery API that AI agents and agent platforms use to find verified MCP servers matching specific needs. Results are ranked by relevance, verification tier, and health score.
ezForge Hub is coming soon. This page describes the planned discovery API.
Discovery methods
Hub Search API
The primary discovery endpoint for AI agents:
GET /v1/hub/search?q=restaurant+detroit&vertical=restaurant&city=detroit
Directory API
Structured browsing by category, location, and capability:
GET /v1/hub/directory?vertical=restaurant&city=detroit&capability=reservations
https://{slug}.mcp.ezforge.ai/.well-known/mcp-server-metadata
WebMCP Integration
For businesses with existing websites, Ready auto-generates a WebMCP metadata tag. Agents crawling the web discover the MCP endpoint from the business’s existing site.
Search architecture
Hub search is powered by a Typesense read-replica index derived from PostgreSQL (the source of truth). This architecture provides:
- Typo-tolerant full-text search across business names, descriptions, and capabilities
- Faceted filtering by vertical, location, capabilities, and verification tier
- Geospatial queries — find services within a radius of a lat/lng coordinate
- Sub-50ms query latency at scale
PostgreSQL GIN indexes are retained for internal/admin queries. The Typesense index is synced from PostgreSQL via change-data-capture (CDC) or periodic refresh.
Search ranking
Hub ranks search results using a composite score:
| Signal | Weight | Description |
|---|
| Relevance | High | Text match against query, vertical, location |
| Verification tier | Medium | Higher verification = higher rank |
| Health score | Medium | Uptime and response-time metrics |
| Listing tier | Medium | Premium > Featured > Basic |
| Agent engagement | Low | Historical interaction success rate |
Composite skills
Premium listings can participate in composite skills — multi-server workflows where Hub orchestrates queries across multiple MCP servers to fulfill a complex request.
Example: “Plan a date night in Detroit” might query a restaurant server, an entertainment venue server, and a rideshare server in sequence.
API access
Hub’s discovery API is available to:
| Consumer | Access |
|---|
| AI agents (Claude, ChatGPT, etc.) | Free — standard rate limits |
| Agent platforms (Anthropic, OpenAI) | API key + higher rate limits |
| Third-party registries | Partnership agreements |
| Developers | API key (included with Platform subscription) |
