These pages are generated from MCPAQL/spec so the public site can carry the full protocol and adapter material, not just summaries and links back to GitHub.
versions/ remains the normative source.Document Status: This document is an informative conformance framework specification aligned to the normative protocol requirements in docs/versions/v1.0.0-draft.md. Implementation Status: This repository now includes a
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
This document defines the structured error code system for MCP-AQL protocol responses. Structured error codes enable machine-readable error handling, consistent error categorization, and reliable error mapping across ada
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
This document is a discussion aid for deciding how to license the MCP-AQL ecosystem (spec + schema artifacts + tooling + generated adapters + brand/name), while meeting these goals:
This document specifies how MCP-AQL adapters integrate with the Model Context Protocol (MCP). It defines tool registration requirements, input schema composition, error mapping between protocols, progress notification ha
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
MCP-AQL (Model Context Protocol - Agent Query Language) is a protocol that consolidates discrete MCP tools into a small number of semantic endpoint families, providing significant token reduction while maintaining full f
This document defines the normative plugin interface contracts for the MCP-AQL adapter system. Plugins provide modular, composable functionality for transport, protocol, authentication, and serialization. This specificat
This directory contains the MCP-AQL specification set:
Model Context Protocol - Advanced Agent API Adapter Query Language
MCP-AQL (Model Context Protocol - Advanced Agent API Adapter Query Language) is a protocol specification that consolidates multiple MCP tools into a small number of semantic endpoints, providing significant token reducti
This document defines a standard classification system for dangerous operations in MCP-AQL adapters. Danger levels enable automatic lockdown of high-risk actions, consistent confirmation requirements, and trust-based per
Document Status: This document is informative support text for the current MCP-AQL draft. The normative source of truth remains Specification v1.0.0-draft plus the published schemas in spec/schemas/.
This document defines the Adapter Element Type, a declarative schema format for describing how MCP-AQL CRUDE operations map to target API calls. Adapters are Markdown files with YAML front matter that a universal runtime
This document specifies the requirements and behavior of MCP-AQL adapter generators. An adapter generator takes a schema definition as input and produces compliant adapter code with required licensing artifacts and prove
This document defines the rate limiting and quota management system for MCP-AQL adapters. Rate limits enable systems to respect API constraints, prevent runaway costs, and provide graceful degradation under load.
This document defines the trust level system for MCP-AQL adapters. Trust levels indicate the verification and validation status of an adapter, enabling systems to make informed decisions about which operations to permit
This document specifies the confirmation token mechanism used by MCP-AQL adapters to gate dangerous operations and quota continuations. Confirmation tokens provide a secure, time-limited method for clients to acknowledge
Informative Document: This is an informative specification that provides detailed guidance for the execution safety loop pattern defined normatively in Section 8.6 of the core specification. In case of conflict, the norm
This document specifies an optional security model for MCP-AQL adapters, providing multi-layer access control, confirmation requirements, and audit capabilities.
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
This document specifies the optional field selection feature that enables clients to request only specific fields in responses, reducing payload size and token consumption.
This document defines the preferred cursor-based pagination semantics for MCP-AQL operations that return collections. Cursor pagination enables efficient iteration through large datasets while minimizing token usage in L
Document Status: This document is informative. For normative requirements, see MCP-AQL Specification v1.0.0.
This document specifies the warnings array extension to MCP-AQL's discriminated response format. Warnings provide a mechanism to communicate non-fatal conditions to clients within successful responses, enabling proactive
Document Status: This document is informative. For normative protocol requirements, see MCP-AQL Specification v1.0.0.
This document helps developers familiar with GraphQL, MongoDB, REST, SQL, or classic MCP understand MCP-AQL by mapping familiar concepts to their MCP-AQL equivalents.
Step-by-step guides for implementing and using MCP-AQL adapters.
This document defines how breaking changes are handled in the MCP-AQL specification, including change classification, deprecation procedures, migration requirements, and communication standards.
This checklist defines the minimum quality bar for a coordinated preliminary public launch of:
This document describes the formal process for proposing, reviewing, and accepting changes to the MCP-AQL specification through Requests for Comments (RFCs).
This document describes the version numbering scheme and release process for the MCPAQL specification.
All notable changes to the MCP-AQL specification will be documented in this file.
Implementation architecture documentation has moved to the mcpaql-adapter repository.
A strategic comparison of three protocols shaping how AI agents interact with the world: where they overlap, where they diverge, and where the gaps are.
Detailed specifications for schemas, formats, and protocol structures.
Date: 2026-01-16
Date: 2026-01-16
Date: 2026-01-16
Date: 2026-01-16
Date: 2026-01-16
Date: 2026-01-16
This directory contains Architecture Decision Records (ADRs) documenting significant design decisions in the MCP-AQL protocol specification.
See index.md for the complete list of ADRs.