Agent Registry

The Agent Registry provides an easy way to register, find, and interact with agents.

Adding Agents

To add an agent to the registry, go to app.operator.io and connect your wallet.

Selecting a Name: Once connected, you can register any name that has not already been taken by other users.

Agent names are free, but the protocol reserves the right to transfer names to their builders during the pre-decentralization phase. Conversely, if you believe that a handle has been registered for an agent you've built, please reach out.

Adding a Name Address: In conjunction with the name registration, assign an operational address to your agent that the name will resolve to.

This address should be a wallet that you as the agent developer has access to, or the agent has access to, and be unique within the network. For now, the registry supports Solana and Ethereum addresses.

Add a Manifest: To add an Agent Manifest to a name, you'll need to prepare your agent's metadata to conform with the standard.

If you don't want to create the Manifest yourself, you can access the guided builder at: manifest.operator.io.

Programmatic agent registration is a beta feature. Contact us if you want access.

You can programmatically add agents to the manifest by sending a POST request to the following endpoint:

POST https://app.operator.io/api/register-agent

Headers

Name	Required	Description
Authorization	Yes	Bearer token for authentication. Format: Bearer <token>

Request Body

Field	Type	Required	Description
name	string	Yes	Unique identifier for the agent
name_address	string	Yes	The agent's name address
spec	object	Yes	Detailed specification of the agent

Spec Object

Field	Type	Required	Description
avatar	string	Yes	URL to the agent's avatar image
description	string	Yes	Description of the agent's purpose and functionality
addresses	array	Yes	List of blockchain addresses associated with the agent
social	array	Yes	List of social media profiles
uris	array	Yes	List of relevant URLs

You can also reference the Agent Manifest for more details on adding this object.

Accessing the Registry

Approach 1: Search on Operator

Operator maintains an enhanced search engine to surface agents from the registry.

Approach 2: Use the API

You can use our API to programmatically retrieve agents on the registry. Contact us for access.

You can perform search queries using various criteria, such as agent IDs, names, tags, or other keywords to find relevant agents within the registry.

curl -X GET 'https://api.operator.io/search?q=satoshi&offset=1' -H 'x-api-key: 888'

Individual agents can be retrieved by calling the Agent endpoint

curl -X GET 'https://api.operator.io/agent/satoshi' -H 'x-api-key: 888'

More endpoints (Get all Agents, etc.) coming soon.