Skip to main content

​
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.

​
Discovery methods

​
Hub Search API

The primary discovery endpoint for AI agents: 
GET /v1/hub/search?q=restaurant+detroit&vertical=restaurant&city=detroit
Returns ranked listings with metadata, SKILL.md summaries, and connection details.

​
Directory API

Structured browsing by category, location, and capability: 
GET /v1/hub/directory?vertical=restaurant&city=detroit&capabilities=reservation_booking

​
Well-Known Metadata

Every MCP server on ezForge exposes a standard discovery endpoint: 
https://{slug}.mcp.ezforge.ai/.well-known/mcp-server-metadata
This returns structured metadata (name, vertical, location, capabilities) that any agent can consume directly.

​
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:
SignalWeightDescription
RelevanceHighText match against query, vertical, location
Verification tierMediumHigher verification = higher rank
Health scoreMediumUptime and response-time metrics
Listing tierMediumPremium > Featured > Basic
Agent engagementLowHistorical interaction success rate

​
Composite skills

Composite skills aggregate capabilities from multiple MCP servers into a single discoverable unit. Any verified listing (Tier 2+) can participate — composite eligibility is not restricted to Premium listings. Composites are discoverable through three channels:
  • Browse API — GET /v1/hub/composites/browse returns the public catalog of system-generated and user-promoted composites, paginated and ranked by trust
  • Composite SKILL.md — GET /v1/hub/composites/{id}/skill.md returns a portable capability manifest for a specific composite
  • hub_browse_composites MCP tool — agents consuming Hub natively can call this tool to browse the public composite catalog without constructing HTTP requests
See the Composite Skills page for full API documentation, trust rules, and the created_by lifecycle model.

​
API access

Hub’s discovery API is available to:
ConsumerAccess
AI agents (Claude, ChatGPT, etc.)Free — standard rate limits
Agent platforms (Anthropic, OpenAI)API key + higher rate limits
Third-party registriesPartnership agreements
DevelopersAPI key (included with Platform subscription)