# Akii Customer Documentation

> Human documentation for Akii's Commerce Graph and Answer QA layer, protocol compatibility, public publishing, agency workflows, security boundaries, and reference material.

## Human Docs Hub

https://akii.com/docs

## Docs Summary

- **Title:** Akii Customer Docs Index
- **Version:** 1.0
- **Last updated:** 2026-07-07
- **Route count:** 84
- **Protocol/source count:** 8

## Docs Routes

### Start Here

- [Akii Documentation](https://akii.com/docs) - Learn how agencies use Akii to turn service-business client data, offers, policies, availability, reviews, and customer action paths into Commerce Graphs, AI-readable access, and Answer QA workflows.
- [Getting started with Akii](https://akii.com/docs/getting-started) - Create an account, build your first Commerce Graph, publish approved Agent Gateway outputs, run readiness checks, and monitor drift.
- [What is Akii?](https://akii.com/docs/what-is-akii) - Akii is the Commerce Graph and Answer QA layer for agencies that manage service-business clients. Agencies use it to turn messy client data into AI-readable Commerce Graphs. Akii then tests whether AI systems can understand the client, verify the facts, and route customers to the right action.
- [Core concepts](https://akii.com/docs/core-concepts) - Definitions for client brand, Commerce Graph, Agent Gateway, Action Registry, Protocol Compatibility, Answer QA, sources, publishing, drift, issues, fixes, and graph versions.
- [Glossary](https://akii.com/docs/glossary) - Concise definitions for Akii and protocol terms.

### Core Platform

- [Commerce Graph](https://akii.com/docs/commerce-graph) - Learn how Commerce Graph structures products, services, offers, prices, policies, locations, availability, sources, and action paths for AI systems.
- [Agent Gateway](https://akii.com/docs/agent-gateway) - Learn how Agent Gateway publishes approved Commerce Graph data through structured data, read-only AI access, feeds, and partner exports.
- [Action Registry](https://akii.com/docs/action-registry) - Map customer actions such as buy, book, inquire, request quote, call, WhatsApp, deposit, submit form, and checkout to approved paths.
- [Protocol Compatibility](https://akii.com/docs/protocol-compatibility) - Understand readiness versus certification across ACP, UCP, MCP, A2A, AP2, AG-UI, and A2UI.
- [Answer QA](https://akii.com/docs/commerce-qa) - Answer QA checks AI answers, public data, published outputs, protocols, and customer action paths against approved Commerce Graph data.
- [Monitoring](https://akii.com/docs/monitoring) - Understand output health, MCP-compatible access, public data drift, AI answer drift, source conflicts, action-path failures, protocol changes, alerts, and reports.
- [Fix Queue](https://akii.com/docs/fix-queue) - Learn how Akii turns issues into prioritized fixes with owners, proof, recommended actions, retests, and agency/developer handoff.
- [Sources](https://akii.com/docs/sources) - Document public sources, approved sources, preferred sources, websites, listings, social profiles, marketplaces, booking systems, PDFs, reviews, AI answers, and source conflicts.

### Protocol Compatibility

- [AI commerce protocols](https://akii.com/docs/protocols) - Understand the protocol landscape around ACP, UCP, MCP, A2A, AP2, AG-UI, A2UI, Schema.org, and Google structured data.
- [Agentic Commerce Protocol readiness](https://akii.com/docs/protocols/acp) - OpenAI Agentic Commerce Protocol documentation for Akii support boundaries, setup, approved outputs, readiness, safety limitations, and related docs.
- [Universal Commerce Protocol readiness](https://akii.com/docs/protocols/ucp) - Universal Commerce Protocol documentation for Akii support boundaries, setup, approved outputs, readiness, safety limitations, and related docs.
- [Model Context Protocol support](https://akii.com/docs/protocols/mcp) - Model Context Protocol documentation for Akii support boundaries, setup, approved outputs, readiness, safety limitations, and related docs.
- [Agent2Agent support](https://akii.com/docs/protocols/a2a) - Agent2Agent Protocol documentation for Akii support boundaries, setup, approved outputs, readiness, safety limitations, and related docs.
- [Agent Payments Protocol readiness](https://akii.com/docs/protocols/ap2) - Agent Payments Protocol documentation for Akii support boundaries, setup, approved outputs, readiness, safety limitations, and related docs.
- [Agent UI payloads](https://akii.com/docs/protocols/ag-ui-a2ui) - AG-UI documentation for Akii support boundaries, setup, approved outputs, readiness, safety limitations, and related docs.
- [Protocol comparison](https://akii.com/docs/protocols/comparison) - Compare protocols by purpose, client data required, Akii support type, output/export, safety limitations, and official source.
- [Safe protocol claims and certifications](https://akii.com/docs/protocols/safe-claims-and-certifications) - Understand readiness versus certification, support versus partnership, export versus integration, and safe public language.

### Publishing and Partner Access

- [Publishing overview](https://akii.com/docs/publishing) - How Akii shares approved client data with AI tools and partners while keeping private workspace data separate.
- [Access boundaries](https://akii.com/docs/publishing/access-boundaries) - Understand approved public output, read-only AI access, partner access, and private workspace separation.
- [Commerce Graph publishing](https://akii.com/docs/publishing/commerce-graph) - How approved Commerce Graph data can be shared as client facts, offers, policies, actions, reviews, and structured data.
- [Approved data publishing](https://akii.com/docs/publishing/approved-data) - How Akii publishes approved client facts, locations, offers, customer actions, policies, and reviews for AI tools and partners.
- [Read-only AI access](https://akii.com/docs/publishing/read-only-ai-access) - How Akii can let approved AI tools read client data without changing bookings, payments, forms, or business records.
- [Agent discovery profile](https://akii.com/docs/publishing/agent-discovery) - How Akii describes safe client capabilities and handoff boundaries for agent discovery where configured.
- [UCP-style client profile](https://akii.com/docs/publishing/ucp-profile) - How Akii prepares UCP-style client profile data, readiness validation, and safe claims where configured.
- [Exports](https://akii.com/docs/publishing/partner-exports) - How Akii prepares scoped partner exports, readiness reports, graph exports, action exports, included fields, and excluded private data.
- [Availability and access messages](https://akii.com/docs/publishing/availability) - How Akii explains unavailable publishing surfaces, access limits, validation issues, and suggested fixes.
- [Traffic limits](https://akii.com/docs/publishing/traffic-limits) - How Akii limits publishing traffic while avoiding public numeric guarantees or unsafe promises.
- [Versioning](https://akii.com/docs/publishing/versioning) - Explain graph versions, published output versions, protocol export versions, and version labels where implemented.

### Implementation Guides

- [Create your first Commerce Graph](https://akii.com/docs/guides/create-your-first-commerce-graph) - Step-by-step guide for creating the first approved client Commerce Graph AI can trust.
- [Publish your Agent Gateway](https://akii.com/docs/guides/publish-agent-gateway) - Step-by-step guide for publishing approved data through Agent Gateway.
- [Map customer action paths](https://akii.com/docs/guides/map-action-paths) - Step-by-step guide for mapping customer next steps.
- [Run Answer QA](https://akii.com/docs/guides/run-commerce-qa) - Step-by-step guide for running Answer QA checks.
- [Configure protocol compatibility](https://akii.com/docs/guides/configure-protocol-compatibility) - Step-by-step guide for protocol readiness.
- [Set up MCP access](https://akii.com/docs/guides/set-up-mcp) - Step-by-step guide for read-only MCP-compatible access.
- [Create an A2A Agent Card](https://akii.com/docs/guides/create-a2a-agent-card) - Step-by-step guide for A2A-style discovery.
- [Prepare for ACP-style flows](https://akii.com/docs/guides/prepare-for-acp-style-flows) - Step-by-step guide for ACP-style readiness.
- [Prepare for UCP-style flows](https://akii.com/docs/guides/prepare-for-ucp-style-flows) - Step-by-step guide for UCP-style readiness.
- [Monitor drift](https://akii.com/docs/guides/monitor-drift) - Step-by-step guide for monitoring source, published output, AI-answer, and action-path drift.
- [Manage fixes](https://akii.com/docs/guides/manage-fixes) - Step-by-step guide for turning issues into implemented and retested fixes.

### Agencies and Partners

- [Agency guide](https://akii.com/docs/agencies) - How agencies use Akii to onboard service-business clients, manage client brands, package services, produce reports, and implement fixes.
- [Client onboarding for agencies](https://akii.com/docs/agencies/client-onboarding) - A client onboarding workflow for agencies implementing Akii across websites, sources, offers, policies, published outputs, and action paths.
- [Manage multiple client brands](https://akii.com/docs/agencies/manage-multiple-merchant-brands) - How agencies organize multiple clients or brand identities inside Akii plans.
- [Client reports](https://akii.com/docs/agencies/client-reports) - How agencies turn Commerce Graph readiness, protocol status, issues, fixes, and retests into client-ready reporting.
- [Fix Queue workflows for agencies](https://akii.com/docs/agencies/fix-queue-workflows) - How agencies use Fix Queue to prioritize client implementation work.
- [Reselling and packaging Akii](https://akii.com/docs/agencies/reselling-akii) - How agencies package Akii services without false protocol, certification, ranking, or payment claims.
- [Partner guide](https://akii.com/docs/partners) - How platform partners use Akii for batch client onboarding, exports, protocol readiness reports, APIs, and data boundaries.
- [Batch client onboarding](https://akii.com/docs/partners/batch-merchant-onboarding) - Operational model for onboarding many clients or brands into Akii.
- [Protocol exports](https://akii.com/docs/partners/protocol-exports) - How partners evaluate Akii protocol exports and readiness payloads where implemented.
- [Partner readiness reports](https://akii.com/docs/partners/partner-readiness-reports) - How partner readiness reports summarize graph completeness, public outputs, protocols, action paths, and fixes.

### Use Cases

- [Use cases](https://akii.com/docs/use-cases) - Where Akii fits across agency-managed service clients, ecommerce services, local businesses, B2B, hospitality, wellness, venues, tours, marketplaces, and multi-location brands.
- [Ecommerce and complex catalogs](https://akii.com/docs/use-cases/ecommerce) - Use Akii for product businesses with complex catalogs, policies, variants, bundles, availability, and checkout handoffs.
- [Service businesses](https://akii.com/docs/use-cases/service-businesses) - Use Akii for service-business clients with bookings, quotes, calls, WhatsApp, deposits, forms, and human handoffs.
- [Local businesses](https://akii.com/docs/use-cases/local-businesses) - Use Akii for local service-business clients where location, hours, service area, reviews, listings, and contact paths matter.
- [B2B companies](https://akii.com/docs/use-cases/b2b) - Use Akii for quote-based, inquiry-led, or partner-routed B2B buyer journeys.
- [Hospitality](https://akii.com/docs/use-cases/hospitality) - Use Akii for hotels, restaurants, private dining, rooms, menus, packages, policies, and booking handoffs.
- [Wellness and clinics](https://akii.com/docs/use-cases/wellness) - Use Akii for wellness providers and clinics that need careful service, eligibility, policy, booking, and contact-path data.
- [Venues and events](https://akii.com/docs/use-cases/venues-events) - Use Akii for venues, events, capacity, spaces, packages, deposits, and quote or booking handoffs.
- [Tours and experiences](https://akii.com/docs/use-cases/tours-experiences) - Use Akii for experiences where availability, duration, capacity, eligibility, cancellation rules, and booking handoffs matter.
- [Marketplaces](https://akii.com/docs/use-cases/marketplaces) - Use Akii for marketplaces or platforms that need client profiles, exports, readiness reports, and partner data boundaries.
- [Multi-location brands](https://akii.com/docs/use-cases/multi-location-brands) - Use Akii for brands with multiple locations, regional policies, local action paths, and branch-level source evidence.

### Security and Compliance

- [Security overview](https://akii.com/docs/security) - Security boundaries for Akii data handling, public/private data, published outputs, roles, audit logs, MCP security, payment boundaries, and certification claims.
- [Data handling](https://akii.com/docs/security/data-handling) - What Akii stores, exposes, excludes, and separates across client data, sources, published outputs, issues, fixes, and reports.
- [Public vs private data](https://akii.com/docs/security/public-vs-private-data) - How Akii separates approved public output from private notes, internal review notes, partner-only data, and private workspace operations.
- [MCP security](https://akii.com/docs/security/mcp-security) - Security model for Akii read-only MCP-compatible access.
- [Payment boundaries](https://akii.com/docs/security/payment-boundaries) - Akii does not process payments, store card data, vault payment tokens, issue mandates, or perform unauthorized transactions.
- [Roles and access](https://akii.com/docs/security/roles-and-access) - How account, agency, partner, and client access should be separated.
- [Audit logs](https://akii.com/docs/security/audit-logs) - How publishing access, MCP-compatible calls, checks, fixes, and operational events support review and troubleshooting.
- [Certification and platform-claim rules](https://akii.com/docs/security/no-certification-claims) - Rules for avoiding unsupported certification, partnership, payment, ranking, and recommendation claims.

### Reference

- [Reference](https://akii.com/docs/reference) - Reference docs for entities, schemas, action types, protocol statuses, issues, readiness, plan limits, FAQ, and changelog.
- [Entities](https://akii.com/docs/reference/entities) - Reference for Commerce Graph entities including client identity, locations, services, offers, packages, menus, spaces, policies, action paths, sources, published outputs, issues, and fixes.
- [Commerce Graph schema](https://akii.com/docs/reference/commerce-graph-schema) - Schema reference for structuring products, services, offers, policies, locations, availability, and customer actions for AI systems.
- [Action types](https://akii.com/docs/reference/action-types) - Reference for buy, book, inquire, request quote, call, WhatsApp, pay deposit, submit form, checkout, and fallback action types.
- [Protocol statuses](https://akii.com/docs/reference/protocol-statuses) - Reference for supported, partial, readiness, export, planned, watchlist, and requires verification labels.
- [Issues](https://akii.com/docs/reference/issues) - Reference for issues by severity, confidence, affected item, proof, commercial impact, and recommended fix.
- [Readiness statuses](https://akii.com/docs/reference/readiness-statuses) - Reference for protocol, graph, public-output, and action-path readiness states.
- [Plan limits](https://akii.com/docs/reference/plan-limits) - Current plan limit reference for Agency Launch, Agency Portfolio, Agency Scale, and Partner Platform.
- [FAQ](https://akii.com/docs/reference/faq) - Frequently asked questions about Akii docs, protocol support, public-output access, agencies, payments, and safe claims.
- [Changelog](https://akii.com/docs/reference/changelog) - Docs changelog for the Akii v2 documentation system.
- [Schemas](https://akii.com/docs/schemas) - Schema references for Commerce Graph, Action Path, Protocol Profile, Public Output, and Export shapes where implemented.

## Protocol Research Matrix

| Protocol or source                    | Akii status | Akii docs                                          | Official source                                                              | Safe Akii claim                                                                   |
| ------------------------------------- | ----------- | -------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| OpenAI Agentic Commerce Protocol      | readiness   | [Docs](https://akii.com/docs/protocols/acp)        | [Official source](https://developers.openai.com/commerce/guides/get-started) | Akii prepares client data for ACP-style flows and payment-handoff readiness.      |
| Universal Commerce Protocol           | partial     | [Docs](https://akii.com/docs/protocols/ucp)        | [Official source](https://ucp.dev/)                                          | Akii prepares UCP-style client profiles and readiness evidence.                   |
| Model Context Protocol                | supported   | [Docs](https://akii.com/docs/protocols/mcp)        | [Official source](https://modelcontextprotocol.io/specification/2025-11-25)  | Akii exposes approved Commerce Graph data through read-only MCP-compatible tools. |
| Agent2Agent Protocol                  | partial     | [Docs](https://akii.com/docs/protocols/a2a)        | [Official source](https://a2a-protocol.org/latest/)                          | Akii exposes A2A-style discovery and safe client read/handoff capabilities.       |
| Agent Payments Protocol               | readiness   | [Docs](https://akii.com/docs/protocols/ap2)        | [Official source](https://ap2-protocol.org/)                                 | Akii prepares client-side payment-handoff readiness for AP2-style flows.          |
| AG-UI                                 | export      | [Docs](https://akii.com/docs/protocols/ag-ui-a2ui) | [Official source](https://docs.ag-ui.com/introduction)                       | Akii can export structured Agent UI payloads for approved commerce actions.       |
| A2UI                                  | export      | [Docs](https://akii.com/docs/protocols/ag-ui-a2ui) | [Official source](https://a2ui.org/introduction/what-is-a2ui/)               | Akii can emit declarative A2UI-style commerce payloads for approved data.         |
| Schema.org and Google structured data | supported   | [Docs](https://akii.com/docs/schemas)              | [Official source](https://schema.org/)                                       | Akii can publish JSON-LD-style structured outputs from approved client data.      |

## Required Boundaries

- Akii is not OpenAI, Stripe, Google, a booking system, a checkout provider, or a chatbot. It does not process payments.
- Akii prepares verified client data and approved handoff paths. Checkout and booking stay with the client or provider.
- Akii prepares and checks the client data and action layer AI systems need.

Akii does not claim certification or formal partnership unless we state it. Akii prepares and checks the client data and action layer those systems need.

---

Last Updated: 2026-07-07
Version: 9.0
