yera.tools.mcp.discovery
Discover remote MCP servers from domain-level metadata.
Symbols
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.
Fields
name
type: str (required)
Stable server identifier from its Server Card.
title
type: str (required)
Human-readable server title.
description
type: str | None (required)
Human-readable description when supplied.
url
type: str (required)
Streamable HTTP endpoint.
client_profile
type: str | None = None
Optional trusted OAuth client profile selected by Yera.
requested_scopes
type: tuple[str, ...] | None = None
Explicit OAuth scopes selected during setup, or
None when the client profile supplies its defaults.
Methods
__init__ —
DiscoveredMCPServer.__init__
__init__(
name: str,
title: str,
description: str | None,
url: str,
client_profile: str | None = None,
requested_scopes: tuple[str, ...] | None = None,
) → None