DOCUMENTATION LIBRARY

Browse MCP-AQL By Domain

This library organizes source material from the MCPAQL repositories into a protocol-site shape: core specification, quick start, core semantics, structured errors, safety model, conformance, adapter contracts, implementation profiles, and release-status context.

Getting Started Error Model Full Spec Reference Adapter Contracts

Core Documentation Tracks

Each track is mapped to canonical source repositories and intended launch visibility.

Getting Started

Protocol Core

Required

Normative request/response model, endpoint semantics, introspection contract, and operation model.

Open summary Open source page

Error Model

Required

Structured error envelope, machine-readable codes, and current alignment gaps between draft and implementations.

Open summary Open source page

Security Model

Required

Gatekeeper boundaries, confirmation tokens, danger handling, and safety-loop alignment.

Open summary Open source page

Conformance

In progress

Compatibility baseline, validation posture, and planned validator tooling.

Open summary Open source page

Implementation Profiles

Required

Boundary between canonical specification and practical production profile behavior.

Open summary Open adapter docs

Adapter Contracts

Required

Adapter schema, plugin contract, generator-output, and example-surface expectations across the implementation toolchain.

Open summary Open source page

Roadmap

Public planning

Phase-based protocol and ecosystem trajectory with current focus areas.

Open summary Open full spec

Release Notes

Change context

Recent draft changes that affect public messaging, launch framing, and docs coverage priorities.

Open summary Open source page

Launch Checklist

Public control

Public-facing readiness checklist and launch-scope guardrails.

Open summary Open source page

Repo-Synced Full Spec Reference

The docs library now has a deeper sibling section generated from the canonical spec repo, so the website itself carries the fuller protocol material.

Use summaries for orientation

These docs pages still provide fast, curated entry points for launch framing, implementation posture, and topic overviews.

Start with guided summaries

Use the spec mirror for depth

The generated reference mirrors the deeper content from MCPAQL/spec/docs, including versioned drafts and supporting material.

Browse the full repo-synced reference

Repo-Synced Reference Adapter Docs

Implementation guidance from the reference adapter repo is mirrored on-site too, so adapter architecture and practical build guides live alongside the protocol docs.

Open the mirrored implementation docs

The website now hosts the reference adapter architecture docs, development and testing guides, migration walkthrough, and implementation ADRs.

Browse reference adapter docs

Use adapter patterns for orientation

Start with pattern selection to pick the right target-system shape, then drop into the mirrored implementation docs for the runtime details.

Open adapter patterns

Canonical Spec Map

The website now mirrors the major categories from the spec docs index so public readers can browse both summaries and the fuller reference without opening the repository first.

Spec source	Website surface	What it covers
README.md	Getting Started	Repository-level protocol summary, token efficiency, and quick-start framing
spec mirror	Repo-Synced Spec Reference	Website-hosted full mirror of versioned and topical specification documents
versions/v1.0.0-draft.md	Protocol Core	Normative request shape, endpoint rules, operation semantics, and routing
error-codes.md	Error Model	Structured errors, machine-readable codes, current gaps
plugin-contracts.md	Adapter Contracts	Plugin responsibilities, schema contracts, generator outputs
mcpaql-adapter mirror	Reference Adapter Docs	Website-hosted mirror of runtime architecture, implementation guides, and ADRs
CHANGELOG.md	Release Notes	Recent draft changes and launch-relevant deltas

Repository Source Matrix

The site intentionally reflects all primary MCPAQL repositories and their documentation role.

Repository	Website Role	Primary Surface
MCPAQL/spec	Normative authority	Protocol definitions and conformance requirements
MCPAQL/mcpaql-adapter	Reference implementation guidance	Architecture, runtime, plugin, and dispatch documentation
MCPAQL/examples	Example patterns	Reference adapter configuration examples
MCPAQL/adapter-generator	Generation policy	Output licensing and provenance constraints
MCPAQL/tools	Validator/tooling track	Conformance CLI and on-spec validator workstream
MCPAQL/website	Public docs delivery	Readable/searchable protocol website