HOL

HOL Agent Infrastructure Discovery API

A stable, function-calling-compatible discovery contract for HOL public resources, the Universal Agentic Registry, OAuth metadata, and first-party MCP…

AI & machine learning#ai

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

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.

Endpoints 27

Discovery

  • GETGet the HOL homepage/Returns server-rendered HTML by default or a compact agent-oriented Markdown representation when Accept requests text/markdown.
  • GETGet the HOL root OpenAPI document/openapi.jsonReturns the OpenAPI 3.1 discovery contract for HOL public resources and first-party machine interfaces.
  • GETGet HOL guidance for language-model agents/llms.txtReturns identity, when-to-use guidance, authentication conventions, throttling guidance, and machine-readable endpoint links.
  • GETGet the HOL developer resource hub/developersReturns the public developer hub linking OpenAPI, OAuth, MCP, Registry documentation, SDKs, standards, tutorials, and source repositories.
  • GETGet the canonical HOL documentation index/docsReturns a server-rendered index linking the authoritative Registry, Guard, OAuth, MCP, sandbox, SDK, standards, tutorial, source, trust, and support resources.
  • GETGet the HOL organization overview/aboutReturns server-rendered organization, product, governance, agent-use, business identity, and contact information for HOL.
  • GETGet public HOL contact information/contactReturns public support channels, business address, contact form, and developer or community resource links for HOL.
  • GETGet the HOL privacy overview/privacyReturns a server-rendered privacy overview and links to the complete policies and self-service privacy controls for HOL products.
  • GETInspect the HOL agent onboarding sandbox/api/agent-sandboxReturns a typed descriptor for the no-credential, no-billing, no-mutation sandbox, including supported operations and links to free signup and self-service…
  • POSTCall the no-side-effect HOL agent sandbox/api/agent-sandboxRuns ping or validates and normalizes a proposed Registry search. The sandbox never executes the previewed Registry request, mutates data, requires…

Registry

  • GETSearch the Universal Agentic Registry/registry/api/v1/searchSearches indexed agents, MCP servers, protocols, skills, and capabilities across Registry Broker adapters.

OAuth

  • GETGet OAuth authorization-server metadata/.well-known/oauth-authorization-serverReturns RFC 8414 metadata including authorization, token, registration, revocation, device, introspection, userinfo, and JWKS endpoints.
  • GETGet OAuth protected-resource metadata/.well-known/oauth-protected-resourceReturns RFC 9728 metadata identifying authorization servers, bearer methods, and supported scopes for protected HOL resources.

MCP

  • GETInspect the public MCP transport endpoint/.well-known/mcpReturns HTTP 405 with method and service-description links because the stateless Streamable HTTP server accepts client messages with POST.
  • POSTCall the public HOL Registry MCP server/.well-known/mcpSends a JSON-RPC 2.0 MCP message over Streamable HTTP. Initialize first, then list or call the read-only search_agents tool.
  • POSTCall HOL Guard Cloud over MCP Streamable HTTP/api/guard/mcpSends an authenticated JSON-RPC 2.0 MCP request to the HOL Guard Cloud workspace server using the OAuth grant scopes.

Guard Fleet

  • GETGet the fleet summary/api/guard/v1/fleet/summaryReturns the stored workspace fleet summary: machine totals, protection coverage, policy adoption, version and update counts, and per-tool counts. A stored…
  • GETList fleet machines/api/guard/v1/fleet/machinesLists machines in the workspace with the Guard fleet URL grammar: filters by protection, version, policy adoption, tool, member (Team plans), OS, last-seen…
  • GETGet the calling device machine/api/guard/v1/fleet/machines/selfReturns the machine record for the device that owns the token, resolved from the installation bound to a guard:runtime.sync device token. Answers 404 when the…
  • GETGet one fleet machine/api/guard/v1/fleet/machines/:machineIdReturns one machine with posture, tools, inventory page, policy acknowledgements, and suggested fixes. Rate limited to 60 requests per minute per OAuth grant…
  • GETList fleet inventory/api/guard/v1/fleet/inventoryReturns the fleet-wide catalogue of skills, MCP servers, and other items grouped by kind and name, with the machines that carry each. Rate limited to 60…
  • GETGet fleet policy adoption/api/guard/v1/fleet/policy-adoptionReturns how many machines run the Live policy, the adoption trend, recent policy publishes, and the machines that are behind or rejected the policy. Rate…
  • GETGet fleet Guard versions/api/guard/v1/fleet/versionsReturns the latest stable Guard release, update-state counts, the installed-version distribution, outdated machines, and the share of machines on the current…

Payments

  • GETGet the HOL Guard pricing plans/api/guard/pricingReturns the current HOL Guard pricing contract as JSON: free, local, and paid tiers, their limits, and placement sponsorship offers. Informational only;…
  • GETList agent-purchasable HOL offers/api/x402/catalogMachine-readable catalog of HOL surfaces an agent can buy over the x402 payment rail: sponsored placements (README logo slots, repository banners, sponsored…
  • POSTBuy a HOL offer over x402 (USDC on Base)/api/x402/checkoutPOST {offerId, subject?, contactEmail?, agentReference?}. Without an X-PAYMENT header the route answers HTTP 402 with x402 payment requirements priced for the…
  • POSTStart a HOL Guard sponsorship placement checkout session/api/guard/sponsor/checkoutCreates a Stripe hosted checkout session for a sponsorship placement offer, starting at the entry tier of USD 100.00, and returns the checkout URL. Requires…

API details

Base URL
https://hol.org
Authentication
OAuth 2.0 (authorization code flow) with 4 scopes
Operations
27 operations on 25 pathsGET 22POST 5
Main resources
Discovery 10Guard Fleet 7Payments 4MCP 3OAuth 2Registry 1
Response formats
application/json text/html application/vnd.oai.openapi+json text/markdown
Description format
OpenAPI 3.1.1, API version 1.0.0

How to test the HOL Agent Infrastructure Discovery API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the HOL Agent Infrastructure Discovery API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 4 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get the HOL homepage” (GET /), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the HOL Agent Infrastructure Discovery API?

A stable, function-calling-compatible discovery contract for HOL public resources, the Universal Agentic Registry, OAuth metadata, and first-party MCP… It is listed under AI & machine learning and has 27 endpoints.

Who publishes the HOL Agent Infrastructure Discovery API?

It is listed from HOL's public API description (an OpenAPI document), not published by HOL on Swastik Codes. Anyone who controls hol.org can claim the profile by adding a DNS TXT record.

What is the base URL of the HOL Agent Infrastructure Discovery API?

Requests go to https://hol.org. Endpoint paths are added to this base URL.

How do I authenticate with the HOL Agent Infrastructure Discovery API?

With OAuth 2.0 (authorization code flow) with 4 scopes.

How many endpoints does the HOL Agent Infrastructure Discovery API have?

27 operations on 25 paths (22 GET, 5 POST). The largest groups are Discovery, Guard Fleet, Payments, MCP.

Is forking the HOL Agent Infrastructure Discovery API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.