# info.summary
Machine-readable discovery for HOL agent infrastructure.

# info.description
A stable, function-calling-compatible discovery contract for HOL public resources, the Universal Agentic Registry, OAuth metadata, and first-party MCP endpoints. Product-specific contracts remain authoritative for their complete surfaces.

# tags[].description
Public machine-readable resources that describe HOL services.

# tags[].description
Universal Agentic Registry discovery and search.

# tags[].description
First-party Model Context Protocol endpoints over Streamable HTTP.

# paths./.get.description
Returns server-rendered HTML by default or a compact agent-oriented Markdown representation when Accept requests text/markdown.

# paths./.get.parameters[].description
Select the HTML or Markdown representation.

# paths./.get.responses.200.description
The requested HOL homepage representation.

# paths./openapi.json.get.description
Returns the OpenAPI 3.1 discovery contract for HOL public resources and first-party machine interfaces.

# paths./llms.txt.get.summary
Get HOL guidance for language-model agents

# paths./llms.txt.get.description
Returns identity, when-to-use guidance, authentication conventions, throttling guidance, and machine-readable endpoint links.

# paths./developers.get.description
Returns the public developer hub linking OpenAPI, OAuth, MCP, Registry documentation, SDKs, standards, tutorials, and source repositories.

# paths./developers.get.responses.200.description
The server-rendered HOL developer resource hub.

# paths./registry/api/v1/search.get.description
Searches indexed agents, MCP servers, protocols, skills, and capabilities across Registry Broker adapters.

# paths./.well-known/oauth-authorization-server.get.description
Returns RFC 8414 metadata including authorization, token, registration, revocation, device, introspection, userinfo, and JWKS endpoints.

# paths./.well-known/oauth-protected-resource.get.description
Returns RFC 9728 metadata identifying authorization servers, bearer methods, and supported scopes for protected HOL resources.

# paths./.well-known/mcp.get.summary
Inspect the public MCP transport endpoint

# paths./.well-known/mcp.get.description
Returns HTTP 405 with method and service-description links because the stateless Streamable HTTP server accepts client messages with POST.

# paths./.well-known/mcp.post.description
Sends a JSON-RPC 2.0 MCP message over Streamable HTTP. Initialize first, then list or call the read-only search_agents tool.

# paths./.well-known/mcp.post.parameters[].description
MCP protocol version negotiated during initialization.

# paths./.well-known/mcp.post.responses.200.description
JSON-RPC response for a callable MCP request.

# paths./.well-known/mcp.post.responses.202.description
Accepted notification with no JSON-RPC response body.

# paths./.well-known/mcp.post.responses.400.description
Malformed JSON or an invalid JSON-RPC request.

# paths./api/guard/mcp.post.summary
Call HOL Guard Cloud over MCP Streamable HTTP

# paths./api/guard/mcp.post.description
Sends an authenticated JSON-RPC 2.0 MCP request to the HOL Guard Cloud workspace server using the OAuth grant scopes.

# paths./api/guard/mcp.post.parameters[].description
MCP protocol version negotiated during initialization.

# paths./api/guard/mcp.post.responses.202.description
Accepted authenticated notification with no body.

# paths./api/guard/mcp.post.responses.401.headers.WWW-Authenticate.description
Bearer challenge with resource metadata and scopes.

# paths./docs.get.summary
Get the canonical HOL documentation index

# paths./docs.get.description
Returns a server-rendered index linking the authoritative Registry, Guard, OAuth, MCP, sandbox, SDK, standards, tutorial, source, trust, and support resources.

# paths./about.get.summary
Get the Hashgraph Online organization overview

# paths./about.get.description
Returns server-rendered organization, product, governance, agent-use, business identity, and contact information for Hashgraph Online.

# paths./contact.get.description
Returns public support channels, business address, telephone, contact form, and developer or community resource links for Hashgraph Online.

# paths./privacy.get.description
Returns a server-rendered privacy overview and links to the complete policies and self-service privacy controls for HOL products.

# paths./api/agent-sandbox.get.summary
Inspect the HOL agent onboarding sandbox

# paths./api/agent-sandbox.get.description
Returns a typed descriptor for the no-credential, no-billing, no-mutation sandbox, including supported operations and links to free signup and self-service API-key management.

# paths./api/agent-sandbox.get.responses.200.description
Agent sandbox capabilities and onboarding links.

# paths./api/agent-sandbox.post.summary
Call the no-side-effect HOL agent sandbox

# paths./api/agent-sandbox.post.description
Runs ping or validates and normalizes a proposed Registry search. The sandbox never executes the previewed Registry request, mutates data, requires credentials, or consumes Registry credits.

# paths./api/agent-sandbox.post.responses.200.description
Typed sandbox result with explicit side-effect status.

# paths./api/agent-sandbox.post.responses.400.description
Invalid JSON, operation, input object, or search query.

# components.securitySchemes.holOAuth.description
HOL Guard OAuth 2.0 authorization-code flow with PKCE.

# components.securitySchemes.holOAuth.flows.authorizationCode.scopes.guard:receipt.read
Read Guard receipts available to the grant.

# components.responses.TooManyRequests.description
The request exceeded the active rate-limit policy.