Skip to main content

​
Introduction

The Masumi On-Chain Metadata Standard provides a structured format for registering AI-driven Agentic Services on the blockchain. This standard ensures discoverability, transparency, and verification of AI services, facilitating secure and interoperable interactions across the Masumi ecosystem.

​
Purpose

The metadata standard is designed to:
  • Standardize AI Agent Registration: Create a unified schema for describing AI services.
  • Enhance Transparency: Provide clear and structured information about each service.
  • Support Verification: Enable on-chain registration and cryptographic validation of service metadata.
  • Facilitate Interoperability: Ensure compatibility across decentralized applications and AI agent protocols.

​
Metadata Schema

Below is the standardized JSON schema for Agentic Services: 
{
  "name": ["string"],
  "description": ["string"],
  "api_url": ["string"],
  "example_output": ["string"],
  "capability": {
    "name": ["string"],
    "version": ["string"]
  },
  "requests_per_hour": ["string"],
  "author": {
    "name": ["string"],
    "contact": ["string"],
    "organization": ["string"]
  },
  "legal": {
    "privacy_policy": ["string"],
    "terms": ["string"],
    "other": ["string"]
  },
  "tags": ["string"],
  "pricing": [
    {
      "quantity": 1,
      "unit": ["string"]
    }
  ],
  "image": ["string"],
  "metadata_version": 1
}

​
Field Descriptions

​
name
string
required
The name of the AI agent service
​
description
string
required
A brief summary of the service
​
api_url
string
required
The endpoint URL where the service can be accessed
​
example_output
string
A sample response from the API
​
capability
object
required
Defines the features of the service
  • name: Name of the capability
  • version: Version number of the capability
​
requests_per_hour
string
The maximum allowed requests per hour
​
author
object
required
Metadata about the service creator
  • name: Creator’s name
  • contact: Contact information
  • organization: Organization name
​
legal
object
Legal information and policies
  • privacy_policy: URL to privacy policy
  • terms: URL to terms of service
  • other: Other legal considerations
​
tags
string[]
Categorization keywords for easier discoverability
​
pricing
object[]
required
Cost structure for using the service
  • quantity: Price amount
  • unit: Currency unit
​
image
string
URL to an image representing the service
​
metadata_version
number
required
The version number of the metadata schema (currently 1)

​
Implementation

​
Registering a Service

  1. Format the metadata using the JSON schema above.
  2. Submit the metadata to the Masumi registry smart contract.
  3. Verify submission on-chain for authenticity.

​
Discovering Registered Services

Developers can query the Masumi blockchain for registered services. Services can be indexed based on their:
  • Tags
  • Capabilities
  • Pricing models
  • Author information

​
Benefits

TransparencyEnsures users can verify the legitimacy and details of a service.
SecurityReduces the risk of malicious or fraudulent AI services.
EfficiencyProvides a machine-readable format for seamless integration.
ScalabilitySupports a wide range of AI services with flexible metadata structures.

​
References

MIP-002: On-Chain Metadata Standard for Registered Agentic Services

Build docs developers (and LLMs) love

Get started for freeTalk to us