🜂 Manifest YAML

Open Agent Identity Protocol

Layer 3 Trust Substrate for Autonomous Agents

⚡ Quick Start

Create your first agent manifest in 5 minutes.

1. Create manifest.yaml

# manifest.yaml - Agent Identity Declaration
agent_id: my-agent-v1
name: "My First Agent"
version: "1.0.0"

identity:
  purpose: "Data analysis and reporting"
  creator: "user@example.com"
  timestamp: "2026-01-05T00:00:00Z"

permissions:
  read: ["public_data", "user_uploads"]
  write: ["reports"]
  execute: ["data_analysis"]

behavior_profile:
  mode: "supervised"
  autonomy_level: 0.6

trust:
  verification_required: true
  provenance_tracking: true
  mesh_coordination: true

2. Validate Your Manifest

# Install validator
npm install -g manifest-yaml-validator

# Validate manifest
manifest-yaml validate manifest.yaml

✓ Valid manifest (v1.0.0)
✓ Identity verified
✓ Permissions structured
✓ Trust substrate configured

3. Register Your Agent

# Register with manifest-yaml.com registry
curl -X POST https://manifest-yaml.com/api/registry \\
  -H "Content-Type: application/yaml" \\
  --data-binary @manifest.yaml

{
  "status": "registered",
  "agent_id": "my-agent-v1",
  "trust_score": 0.85,
  "registry_url": "https://manifest-yaml.com/agents/my-agent-v1"
}
Read Full Specification → Browse Examples →

What Is Manifest YAML?

An open specification for agent-native identity, permissions, and behavior declaration. Enables autonomous agents to declare:

🆔 Identity

Who the agent is, who created it, and what its purpose is.

🔐 Permissions

What the agent can read, write, and execute.

🤖 Behavior Profile

How autonomous the agent is and how it operates.

✓ Trust Substrate

Verification, provenance tracking, and mesh coordination.

📚 Examples

Autonomous Research Agent

agent_id: research-bot-v2
behavior_profile:
  mode: "autonomous"
  autonomy_level: 0.9
permissions:
  read: ["research_db", "papers"]
  execute: ["analysis", "citation"]

Supervised Assistant

agent_id: assistant-v1
behavior_profile:
  mode: "supervised"
  autonomy_level: 0.3
permissions:
  read: ["calendar", "email"]
  write: ["notes"]

Swarm-Symmetric Agent

agent_id: swarm-node-42
behavior_profile:
  mode: "swarm-symmetric"
  autonomy_level: 0.7
trust:
  mesh_coordination: true
  swarm_id: "swarm-alpha"
Browse All Examples →

📖 Specification

Manifest YAML v1.0 defines a standard format for agent identity declaration. Open specification, CC0 license, designed for agent-to-agent interoperability.

Core Components

Read Full Specification →

🔌 API & Registry

Public registry for agent manifest discovery and verification.

API Endpoints

# Register agent manifest
POST /api/registry
Content-Type: application/yaml

# Discover agent by ID
GET /api/agents/{agent_id}

# Search agents by capability
GET /api/search?capability=data-analysis

# Verify agent trust score
GET /api/verify/{agent_id}
API Documentation →