Skip to content
@ajar-protocol

Ajar Protocol

Owner-controlled protocol layer for AI agents to read, simulate, act, and transact with websites over HTTPS.

Ajar Protocol

Open websites to AI agents under owner-controlled policy.

Documentation: ajarprotocol.org

Most agents reach websites by pretending to be hurried users: load the page, scrape the HTML, submit a form, maybe carry the user's browser session. That is bad for everyone. The agent cannot tell public data from account data, the owner cannot publish a clear policy, the user cannot delegate only a narrow job, and a purchase or account change leaves weak evidence. Ajar Protocol gives websites a cleaner path: signed manifests, semantic Views, typed Actions, scoped Mandates, SIMULATE before execution, and dual-signed Receipts.

Ajar is a protocol layer over HTTPS for agent-readable content, typed actions, delegated authority, and verifiable receipts. A website owner publishes a signed manifest that tells agents what is available, who may use it, at what price, and under what proof of authority.

Ajar does not replace HTML, checkout systems, payment rails, MCP, or agent frameworks. It gives websites a standard way to declare and govern agent access while integrating with the protocols companies already use.

Why Ajar Exists

Today, agents often treat websites as screens to scrape. That is expensive, fragile, and unsafe for real actions. Ajar adds the missing owner-side contract:

Need Ajar Primitive
Meaning Semantic Views served from the same URLs as HTML
Actions Typed Actions with R0-R3 risk classes
Safety SIMULATE dry runs and two-phase Offer/Commit
Authority Principal-signed Mandates with scope, caps, expiry, and revocation
Accountability Dual-signed Receipts and audit trails
Economics 402-native metering with pluggable settlement

How It Works

  1. A site owner installs or runs an Ajar Gateway, plugin, or native integration.
  2. The owner reviews generated Views, Actions, policy, pricing, and gates.
  3. The owner signs a Capability Manifest at /.well-known/ajar.json.
  4. An agent Kernel discovers the manifest, verifies signatures, reads Views, simulates actions, checks mandates, commits only when allowed, and stores receipts.

The owner key is the root of authority. Automation drafts; owners decide.

Repository Map

Published now:

Repo Purpose
planning Roadmap, build order, positioning, and integration stories
ajar Protocol specification, glossary, ADRs, schemas, examples, registries, AEPs
conformance Test vectors and harnesses defining "Ajar Compatible"
ajar-gateway Reference server for website owners
ajar-docs-mcp MCP server exposing the Ajar spec to coding agents
awesome-ajar Directory of implementations, bridges, and conformant sites
ajar-website ajarprotocol.org — documentation website derived from the spec and planning repos
ajar-examples Demo sites and reference scenarios, including the agent-built Story 4 demo

Publishing later:

Repo Timing
ajar-kernel Phase 2
ajar-woocommerce Stage 4
ajar-shopify Stage 4
ajar-index Phase 4

Collaboration Model

Ajar is designed for adoption by companies, platforms, hosts, agencies, and independent implementers. Reference implementations get no special status: compatibility comes from the public conformance suite.

Ajar is intended to work alongside:

  • MCP and WebMCP for tool/action transport
  • ACP and UCP for commerce semantics
  • x402, AP2, and MPP for settlement
  • A2A for agent-to-agent workflows
  • RFC 9421 / Web Bot Auth for signed agent identity
  • UCAN-style chains for capability delegation

Governance And Licenses

Project contact: Hardik Modha hardik@technopers.com

  • Specification and documentation: CC-BY-4.0
  • Code and machine-readable implementation artifacts: Apache-2.0
  • Long-term governance target: neutral standards venue

Contributors should read CONTRIBUTING.md. Automation contributors must follow AGENTS.md.

Where We Are

Phase 0 is complete: the spec v0.1 draft baseline is frozen and the independent-reader exit gate passed (record). Phase 1, the Gateway MVP read layer, is underway — the Gateway skeleton (T1.1), the executable conformance harness (T1.14), and the docs MCP server have shipped, and an agent-built demo site already passes the conformance CORE probes through the reference Gateway.

See the ROADMAP and BUILD-ORDER in planning.

Start Contributing

  • New here? Follow ONBOARDING.md end to end.
  • Read the ajar README in its stated order.
  • Pick a task from the org Project board, Ajar Roadmap.
  • Start with issues labeled good first issue when learning the system.
  • Follow the org CONTRIBUTING.md: one task, one PR, DoD demonstrated.
  • AI-agent contributors must follow AGENTS.md.

Popular repositories Loading

  1. .github .github Public

    Organization profile and community health files for Ajar Protocol

  2. planning planning Public

    Roadmap, build order, positioning, and task backlog for Ajar Protocol

  3. ajar ajar Public

    Vendor-neutral Ajar Protocol specification, glossary, ADRs, schemas, examples, and registries

    Python

  4. conformance conformance Public

    Conformance vectors and harnesses defining what Ajar Compatible means

    Python

  5. ajar-gateway ajar-gateway Public

    Reference site-side server (Gateway) for the Ajar Protocol read and action layers

    Rust

  6. ajar-docs-mcp ajar-docs-mcp Public

    MCP server exposing the Ajar spec, schemas, examples, and vectors to coding agents

    TypeScript

Repositories

Showing 9 of 9 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…