AI Manifest
MCP ServerOptional reference for /.well-known/ai.json + OpenAPI/JSON Schema discovery (with MCP/agents.json...
Capabilities9 decomposed
machine-readable ai service discovery via standardized metadata schema
Medium confidenceEnables AI agents and clients to discover service capabilities by parsing a standardized /.well-known/ai.json manifest file containing provider metadata, capability declarations, transport types, and authentication endpoints. Uses a JSON schema-based approach with optional OpenAPI/JSON Schema integration to describe available operations, resources, and prompts without requiring hardcoded integrations or manual documentation parsing.
Uses a /.well-known/ convention (borrowed from web standards like ACME, WebFinger) combined with JOSE/JWKS signature verification for tamper-proof capability declarations, enabling cryptographically-verified service metadata without requiring a centralized registry. Provides optional mapping tables to both MCP and agents.json formats, allowing a single manifest to serve multiple agent framework ecosystems.
Unlike ad-hoc API documentation or proprietary agent integration formats, AI Manifest provides a standardized, cryptographically-verifiable discovery mechanism that reduces friction in agent-to-service integration while leveraging existing OpenAPI/JSON Schema conventions familiar to API developers.
jwks-based cryptographic signature verification for manifest authenticity
Medium confidenceImplements JOSE/JWKS (JSON Web Key Set) signature verification allowing agents to validate that an ai.json manifest has not been tampered with by checking RS256 signatures against the provider's public key set at /.well-known/jwks.json. Supports key rotation with a minimum 7-day overlap window using key IDs (kid) to prevent service disruption during key transitions.
Applies JOSE/JWKS standards (RFC 7517/7518) to AI service discovery, enabling cryptographic verification of capability declarations without requiring a centralized certificate authority. The 7-day key rotation overlap window is explicitly specified to prevent service disruption, a detail often overlooked in other signature schemes.
Provides stronger authenticity guarantees than unsigned OpenAPI specs or unverified agent registries by leveraging industry-standard JOSE/JWKS cryptography, while remaining simpler than full PKI infrastructure required by traditional certificate-based approaches.
schema-based capability declaration with optional openapi/json schema integration
Medium confidenceAllows providers to declare available capabilities (callable operations) using a standardized schema that optionally references OpenAPI specifications or inline JSON Schema definitions. Capabilities are declared as an array of strings or objects with input/output schemas, enabling agents to understand operation signatures without parsing natural language documentation or making exploratory API calls.
Decouples capability declaration from transport implementation by using JSON Schema as the canonical representation, allowing a single capability definition to be mapped to REST endpoints, MCP tools, or WebSocket operations without duplication. Provides optional mapping tables showing how OpenAPI operations translate to MCP tool definitions.
Unlike OpenAPI alone (which is REST-centric) or MCP tool definitions (which are agent-specific), AI Manifest's schema-based approach enables transport-agnostic capability declaration that can serve multiple agent frameworks from a single manifest.
multi-transport server declaration with rest/mcp/websocket/sse support
Medium confidenceEnables providers to declare multiple server endpoints in a single manifest, specifying transport type (REST, MCP, WebSocket, Server-Sent Events) and URL for each. Agents can select the appropriate transport based on their capabilities, allowing a single service to expose the same logical capabilities through different protocols without requiring separate manifests.
Treats transport as a deployment detail rather than a capability boundary, allowing providers to declare multiple server implementations in a single manifest. This enables gradual migration from REST to MCP or other protocols without breaking existing integrations or requiring manifest versioning.
Unlike separate OpenAPI specs for REST and MCP tool definitions, AI Manifest's unified server declaration reduces duplication and makes it explicit that the same logical capabilities are available across multiple transports, improving agent decision-making.
read-only resource and prompt template declaration
Medium confidenceAllows providers to declare read-only data resources (e.g., datasets, documents, knowledge bases) and preset prompt templates that agents can reference or retrieve. Resources are declared with URIs and optional schemas, enabling agents to discover and consume provider-hosted data without hardcoding resource URLs or prompt engineering.
Extends AI Manifest beyond capability declaration to include data and prompt assets, enabling a single manifest to serve as a complete service descriptor for agents. Resources and prompts are optional, allowing providers to start with capability-only manifests and evolve toward richer declarations.
Unlike separate documentation or hardcoded resource URLs, AI Manifest's resource declaration enables agents to discover and consume provider-hosted data programmatically, reducing integration friction and enabling dynamic resource discovery.
json schema validation cli for manifest compliance checking
Medium confidenceProvides Node.js-based command-line validation scripts (validate-ai.mjs, validate-jwks.mjs, validate-crl.mjs) that check ai.json manifests against the AI Manifest schema, verify JWKS endpoint compliance, and validate Certificate Revocation List format. Outputs validation reports to _reports/ directory and integrates with GitHub Actions for CI/CD pipelines.
Provides reference validation tooling as part of the specification package, reducing friction for early adopters. Includes GitHub Actions workflow template, enabling zero-configuration CI/CD integration for manifest validation.
Unlike generic JSON Schema validators, the AI Manifest CLI provides domain-specific validation for JWKS and CRL formats, and includes CI/CD templates that reduce setup time for teams adopting the standard.
wellknownai public registry with optional mirroring support
Medium confidenceMaintains a public registry (WellKnownAI at wellknownai.org) where providers can list their ai.json manifests by submitting pull requests to a registry.json file. Supports optional mirroring of manifests without PII constraints, enabling centralized discovery of AI services while maintaining provider autonomy over manifest hosting.
Implements a decentralized registry model where providers maintain authoritative manifests on their own infrastructure while optionally listing in a central directory. This avoids the single point of failure of fully centralized registries while providing discovery benefits.
Unlike proprietary agent marketplaces (e.g., OpenAI Plugin Store) that require approval and centralized hosting, WellKnownAI enables provider autonomy by allowing self-hosted manifests while providing optional centralized discovery.
mcp and agents.json mapping with transport-agnostic capability translation
Medium confidenceProvides mapping tables and guidance for translating AI Manifest capability declarations to Model Context Protocol (MCP) tool definitions and agents.json format. Enables a single manifest to serve multiple agent framework ecosystems by defining how capabilities, resources, and prompts map to framework-specific representations (e.g., MCP tools, agents.json actions).
Acknowledges that different agent frameworks have incompatible capability representations and provides explicit mapping guidance rather than pretending full compatibility. The (~) notation for incomplete mappings is transparent about limitations, helping implementers understand where manual work is required.
Unlike frameworks that require separate integrations for each agent ecosystem, AI Manifest's mapping approach enables a single manifest to serve multiple frameworks, though with acknowledged limitations that require framework-specific adaptation.
http caching directives and etag-based manifest freshness management
Medium confidenceSpecifies HTTP caching best practices for ai.json manifests using Cache-Control headers (max-age=600 recommended), ETags, and Last-Modified headers to enable efficient manifest discovery without overwhelming provider infrastructure. Agents can use ETags to detect manifest changes and avoid re-parsing unchanged manifests.
Applies standard HTTP caching mechanisms (RFC 7232/7234) to AI service discovery, enabling efficient manifest distribution without requiring custom caching logic. The 10-minute default window balances freshness with server load reduction.
Unlike proprietary caching schemes or webhook-based update mechanisms, AI Manifest's HTTP caching approach leverages existing infrastructure and agent support, reducing implementation complexity while providing reasonable freshness guarantees.
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with AI Manifest, ranked by overlap. Discovered automatically through the match graph.
WellKnownAI
Registry/spec examples and public snapshots (no PII; mirroring...
@z_ai/mcp-server
MCP Server for Z.AI - A Model Context Protocol server that provides AI capabilities
AWS Core
** - Core AWS MCP server providing prompt understanding and server management capabilities.
AlibabaCloud DevOps MCP
** - Yunxiao MCP Server provides AI assistants with the ability to interact with the [Yunxiao platform](https://devops.aliyun.com).
MCP-Connect
** A client that enables cloud-based AI services to access local Stdio based MCP servers by HTTP/HTTPS requests.
@mastra/ai-sdk
Adds custom API routes to be compatible with the AI SDK UI parts
Best For
- ✓Backend engineers building AI agent frameworks requiring standardized service discovery
- ✓Platform teams implementing multi-provider agent orchestration
- ✓API developers exposing AI-consumable endpoints to agent ecosystems
- ✓Security-conscious API providers exposing capabilities to untrusted agent networks
- ✓Platform teams requiring tamper-proof capability declarations in multi-tenant environments
- ✓Enterprises integrating with third-party agents where manifest integrity is critical
- ✓API providers building agent-friendly interfaces
- ✓Teams migrating from REST-only APIs to agent-consumable service definitions
Known Limitations
- ⚠Specification is at v0.1 (Community Draft) with no stability guarantee — breaking changes possible
- ⚠Adoption is extremely low; no major cloud platforms or AI frameworks currently implement the standard
- ⚠Manifest is static JSON — real-time capability changes require manual updates and cache invalidation
- ⚠No built-in access control enforcement — only declares auth endpoints; verification is consumer's responsibility
- ⚠MCP mapping is incomplete (marked with ~) and agents.json alignment is partial
- ⚠Signature verification is consumer's responsibility — AI Manifest only declares the jwks_uri; no built-in enforcement
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
About
Optional reference for /.well-known/ai.json + OpenAPI/JSON Schema discovery (with MCP/agents.json mapping)
Unfragile Review
AI Manifest establishes a standardized discovery mechanism for AI capabilities through /.well-known/ai.json files, enabling seamless integration between AI agents and services. This technical specification bridges the gap between OpenAPI documentation and agent-based architectures, though adoption remains niche and primarily beneficial for developers building agent ecosystems rather than end users.
Pros
- +Provides a machine-readable standard for AI service discovery that reduces friction in agent-to-service integration
- +Leverages existing OpenAPI/JSON Schema conventions, lowering the barrier to adoption for API developers
- +Supports MCP (Model Context Protocol) and agents.json mapping, future-proofing for emerging agent frameworks
Cons
- -Extremely low adoption rate with minimal documentation and no major platforms currently implementing the standard
- -Solves a problem primarily relevant to developers building agent infrastructure, not accessible to general audiences
Categories
Alternatives to AI Manifest
Are you the builder of AI Manifest?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →