> ## Documentation Index
> Fetch the complete documentation index at: https://agenticadvertisingorg-snap-format-preview-links.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Building with AdCP

> Build with AdCP: integration guides for MCP and A2A protocols, authentication, async operations, error handling, and orchestrator design patterns.

<Info>
  **`adcp comply` is now `npx @adcp/client@latest storyboard run`.** Running without a storyboard ID discovers your agent's tools and runs all matching storyboards — same behavior, one less concept. See [Validate Your Agent](/dist/docs/3.0.19/building/verification/validate-your-agent) for the updated CLI reference.
</Info>

This section provides everything you need to understand, integrate, and build robust systems with AdCP.

## Learning Path

<CardGroup cols={3}>
  <Card title="Understanding AdCP" icon="lightbulb" href="/dist/docs/3.0.19/building/concepts">
    Why AdCP exists, the problems it solves, and protocol comparison. Start here if you're new.
  </Card>

  <Card title="Foundations" icon="cubes" href="/dist/docs/3.0.19/building/by-layer/L0">
    Technical building blocks: MCP or A2A protocols, capability discovery, authentication, and data models.
  </Card>

  <Card title="Implementation Patterns" icon="gears" href="/dist/docs/3.0.19/building/by-layer/L3">
    Build production-ready systems with async operations, webhooks, error handling, and orchestrator patterns.
  </Card>
</CardGroup>

## Quick Start

**Want a coding agent to build it for you?**

* [Build an Agent](/dist/docs/3.0.19/building/by-layer/L4/build-an-agent) - Point a coding agent at a skill file, get a storyboard-compliant agent in minutes

**Already know which protocol you're using?**

* [MCP Integration Guide](/dist/docs/3.0.19/building/by-layer/L0/mcp-guide) - For Claude, AI assistants, and MCP-compatible tools
* [A2A Integration Guide](/dist/docs/3.0.19/building/by-layer/L0/a2a-guide) - For Google AI agents and A2A-compatible workflows

**Need to choose a protocol?**

See [Protocol Comparison](/dist/docs/3.0.19/building/concepts/protocol-comparison) for a detailed comparison.

## Section Overview

### Understanding AdCP

Conceptual foundation for everyone working with AdCP:

* **[Why AdCP](/dist/docs/3.0.19/building/concepts)** - The strategic vision: unifying buying paradigms and enabling AI surfaces
* **[Protocol Comparison](/dist/docs/3.0.19/building/concepts/protocol-comparison)** - MCP vs A2A at a glance

### Foundations

Technical building blocks for any AdCP implementation:

* **[MCP Guide](/dist/docs/3.0.19/building/by-layer/L0/mcp-guide)** - Tool calls, context, and examples
* **[A2A Guide](/dist/docs/3.0.19/building/by-layer/L0/a2a-guide)** - Tasks, streaming, and artifacts
* **[Capability Discovery](/dist/docs/3.0.19/protocol/get_adcp_capabilities)** - Discover what an agent supports
* **[Authentication](/dist/docs/3.0.19/building/by-layer/L2/authentication)** - Credentials and permissions
* **[Context & Sessions](/dist/docs/3.0.19/building/by-layer/L2/context-sessions)** - Managing state across requests
* **[Schemas and SDKs](/dist/docs/3.0.19/building/by-layer/L0/schemas)** - Access schemas and official client libraries

### Implementation Patterns

For building robust, production-ready systems:

* **[Task Lifecycle](/dist/docs/3.0.19/building/by-layer/L3/task-lifecycle)** - Status values, transitions, and polling
* **[Async Operations](/dist/docs/3.0.19/building/by-layer/L3/async-operations)** - Handling sync, async, and interactive tasks
* **[Webhooks](/dist/docs/3.0.19/building/by-layer/L3/webhooks)** - Push notifications and reliability patterns
* **[Error Handling](/dist/docs/3.0.19/building/by-layer/L3/error-handling)** - Error categories, codes, and recovery
* **[Security](/dist/docs/3.0.19/building/by-layer/L1/security)** - Security considerations and best practices
* **[Orchestrator Design](/dist/docs/3.0.19/building/operating/orchestrator-design)** - State machines and system architecture