Official Standard by Jared James Grogan
© 2022-2025 Jared James Grogan. All rights reserved.
Apache 2.0 Licensed Implementation
AgentFacts is the universal "Know Your Agent" (KYA) metadata standard for verified AI agent capabilities and deployment, inspired by the success of Nutrition Facts labeling in establishing consumer trust through standardized transparency.
Just as Nutrition Facts transformed food safety by providing standardized ingredient and nutritional information, AgentFacts transforms AI agent procurement by providing standardized capability and trust metadata.
Use Case: Rapid prototyping, documentation, examples
- Ultra-lightweight structure showing 10 core sections
- Perfect for understanding AgentFacts architecture
- Copy-paste foundation for implementations
Use Case: Schema validation, developer guidance, API contracts
- JSON Schema with validation rules
- Comprehensive section descriptions
- Ideal for tooling and IDE support
Use Case: Production deployments
- Full field definitions and validation
- Enterprise-grade feature coverage
- Complete extensibility framework
Use Case: Reference implementation - IMMUTABLE
- Original authoritative version
- Legal and IP reference
- Historical preservation
- core_identity (Required) - Agent identification and lifecycle
- baseline_model (Required) - Foundation AI model transparency
- classification - Universal categorization system
- capabilities - Extensible skill declarations
- authentication_permissions - Enterprise security and dynamic permissions
- compliance_regulatory - Multi-jurisdictional regulatory alignment
- performance_reputation - Measurable quality metrics
- supply_chain - SBOM integration and transparency
- verification - Cryptographic trust and multi-authority validation
- extensibility - Future-proofing mechanisms
additionalProperties: trueon all objectspatternProperties: {"^x-": {...}}for custom extensions- Domain-specific metadata via
extensibility.custom_facts - Unlimited expansion without breaking compatibility
Official Specification: https://agentfacts.org
Standard Owner: Jared James Grogan
Academic Foundation: "AgentFacts: Universal KYA Standard for Verified AI Agent Metadata & Deployment" (May 12, 2025)
- Standard Specification: © Jared James Grogan. All rights reserved.
- Schema Implementation: Apache 2.0 licensed for universal adoption
- Original Concept: © 2022 Jared James Grogan (prior art established)
All contributions must maintain compatibility with this official specification. Extensions should use the x- prefix pattern to avoid conflicts with future standard evolution.
- Required Sections:
core_identityandbaseline_modelmust be present - JSON Schema Validation: All schemas include comprehensive validation rules
- TTL Compliance: Metadata must respect time-to-live expiration
- Extension Compatibility: Custom extensions must use
x-prefix pattern
AgentFacts: Making AI agent capabilities as transparent and trustworthy as nutrition labels.