Namegarage

Four catalog tools for UTCP clients

Dev blog#utcp#catalog#api

A developer who wants an assistant to find a domain can point a Universal Tool Calling Protocol (UTCP) client at the catalog manual. The client reads one JSON file, then calls the same public HTTP endpoints as the Namegarage SDK.

We tried importing our OpenAPI description into a UTCP client. It found eight operations, including the full catalog download and three commerce operations that require signed partner requests. Someone browsing anonymously needs four tools. They can search for a domain, look up a match, compare payment options, and find alternatives.

The site build takes the four tool names and their routes from the public release's capability list. It reads the parameters and response shapes for each route from OpenAPI. That matters even for a field as familiar as a search term. search_domains sends the project description in q, while suggest_alternatives accepts an optional description in query. The manual gives the client the field each endpoint accepts.

A search returns the current price in whole US dollars. A null price means the seller accepts offers. To compare buying outright with paying monthly, pass the complete domain name to get_purchase_options. The buyer can then follow the listing link to review the terms.

The developer quickstart includes a Python example that loads the manual and searches the catalog.

Add as preferred source
Hacker News X LinkedIn Email

Using this button loads Google’s service and allows its usage measurement. Privacy policy.

Get new blog posts by email

Comments

Comments are reviewed before publication. The Author badge marks replies from the author.

Read approved comments on the discussion page.

    Open the discussion page

    Leave a comment

    Your account name, sign-in provider, and comment become public after review. Your email stays private. See the blog comments privacy notice and Privacy Policy.

    Sign in to leave a comment.