Discover what a WAIS-compatible site offers. Call this first for any site.

Fetches /.well-known/agents.json and returns a summary showing:

• site.url and site.api_base_url (how the site identifies itself)

• Available actions with their IDs, endpoints, methods, and parameters

• Registration requirements, constraints, and payment info

The agents.json is the source of truth. Use the action IDs and parameter schemas it defines when calling wais_execute.

Args: site_url: The site's URL (e.g. "https://serphub.deeger.io").

Register the user at a WAIS-compatible site using their WAIS identity.

Uses SD-JWT selective disclosure — only shares the claims listed in agents.json data_requirements.registration.required_claims.

Call wais_discover first to see what claims the site needs.

Args: site_url: The site.url from agents.json. claims: Claims to disclose (e.g. ["email"]). If not provided, uses required_claims from agents.json automatically.

Execute an action at a WAIS-compatible site.

Uses the agents.json from wais_discover to resolve the action's endpoint, HTTP method, and required scopes. If the site has an api_base_url, requests are routed there automatically. Tokens and DPoP proofs are handled internally.

Pass site.url (from agents.json) as site_url, the action id, and params matching the action's input_schema.

Examples: wais_execute("https://serphub.deeger.io", "search", {"query": "python"}) wais_execute("https://serphub.deeger.io", "get_usage") wais_execute("https://serphub.deeger.io", "list_jobs", {"limit": 5})

Args: site_url: The site.url from agents.json (shown in discover output). action_id: The action id from agents.json (e.g. "search", "get_usage"). params: Parameters matching the action's input_schema.

Confirm a high-risk action or complete a payment challenge.

Call after wais_execute returned a 402 confirmation challenge and the user has approved. If there was a payment link, the user must complete payment first. Polls for completion automatically if the challenge included a resolution object.

Args: site_url: The site.url from agents.json. challenge_id: The challenge_id from the 402 response.

Check the user's account status at a WAIS-compatible site.

Returns plan, credits, usage stats. The user must be registered first. Looks for a 'get_usage' or 'status' action in agents.json.

Args: site_url: The site.url from agents.json.