yera.tools.mcp.discovery

Discover remote MCP servers from domain-level metadata.

Symbols

def discover_mcp_servers — Discover Streamable HTTP MCP servers advertised by a domain.
class DiscoveredMCPServer — Describe a remote MCP server found during discovery.

discover_mcp_servers

discover_mcp_servers(
    reference: str,
    http_client: httpx2.AsyncClient,
) → list[DiscoveredMCPServer]

Discover Streamable HTTP MCP servers advertised by a domain.

Parameters

reference
type: str

Website or domain URL used as the discovery origin.

http_client
type: httpx2.AsyncClient

Caller-owned client used for metadata requests.

Returns

type: list[DiscoveredMCPServer]

Every compatible server advertised by the domain, in catalog order.

Raises

httpx2.HTTPError

If catalog or Server Card retrieval fails.

TypeError

If the AI Catalog document has an invalid root shape.

DiscoveredMCPServer

Describe a remote MCP server found during discovery.

Attributes

name
type: str

Stable server identifier from its Server Card.

title
type: str

Human-readable server title.

description
type: str | None

Human-readable description when supplied.

url
type: str

Streamable HTTP endpoint.

client_profile
type: str | None

Optional trusted OAuth client profile selected by Yera.