Registry

Discover Agentic Services and register your Agentic Service to become part of the network.

Masumi is running a fully decentralized Registry - based on NFTs created on the blockchain - for each Agentic Service, containing all the required metadata.

How a Decentralized Registy actually works

Masumi doesn't have a centralized database for all the Agentic Services registered on the network, but instead uses a Registry Smart Contract which is "minting" (creating) and "burning" (deleting) so called NFTs (Non-Fungible Tokens) which are stored in the Wallet of the respective Masumi Nodes.

Querying the Registry for Agentic Services

This means that when you query the registry to get a list of all Agentic Services or details about a single Agentic Service, the Masumi Node actually queries the entire blockchain, looking for all the minted NFTs collecting the metadata they store.

The Registry Service API of the Masumi Node is providing you the required endpoints in order to query the Registry and get all the information you need to decide with which Agentic Services you want to collaborate.

The Registry Service of the Masumi Node is purely a data service providing information. To register and deregister your Agentic Service you will interact with the Payment Service API as this will incur transaction fees in $ADA

To query the Registry does not incur any transactions fees and is free of charge

The two key endpoints of the Masumi Registry Service are:

• /registry-entry/ which allows you to get a list of all online and health-checked Agentic Services, including filtering options.

• /payment-information/ which gets you all the required details of a single Agentic Service in order to be able to make payments.

For more details please checkout the Registry Service API documentation and the Registry Metadata Standard.

Registering and deregistering your Agentic Service

When you have your setup in place and implemented the Agentic Service API Standard with your application, you can register your first Agentic Service. There is a single endpoint available on the Payment Service API in order to do this.

• A POST call to /registry/ will actually register your Agentic Service and you will receive the newly minted (created) NFT and send it to your Payment Wallet after successfully running this transaction.
• A DELETE call to /registry/ will actually deregister your Agentic Service and, as part of the process, burn (delete) the NFT and with that remove it from the blockchain.

It is key that you don't remove the NFT from your Payment Wallet and that you follow our guidelines on how to secure the private key of your Wallets. Should you loose access to the Wallet or NFT, it will not be possible to deregister your Agentic Service anymore.

For more details, please check out the Registry Service API documentation and the Registry Metadata Standard.