Skip to main content
Spring Boot autoconfiguration for the ACP Java SDK. Provides auto-configured clients, agents, and transports with property-driven configuration.

Quick Start

Add the starter dependency:

Client

Configure the transport in application.properties and inject the client:

Agent

Annotate a Spring bean with @AcpAgent and add handler methods:
For stdio agents, redirect logging to stderr and keep the JVM alive:

Configuration Properties

Client

Agent

Transport Selection

The client transport is selected automatically based on which properties are set:
  • Set spring.acp.client.transport.stdio.command → stdio transport
  • Set spring.acp.client.transport.websocket.uri → WebSocket transport
  • Set spring.acp.client.transport.type → explicit selection (takes precedence)
The agent defaults to stdio transport. Set spring.acp.agent.enabled=false to disable.

Overriding Beans

All auto-configured beans back off when you provide your own. Define a custom AcpClientTransport, AcpSyncClient, AcpAsyncClient, or AcpAgentTransport bean and the autoconfiguration will use yours instead.

Tutorial

Spring Boot Agent

Build an ACP agent as a Spring Boot application

Spring Boot Client

Use the autoconfigured ACP client in Spring Boot

Requirements

  • Java 21+
  • Spring Boot 4.0+
  • ACP Java SDK 0.14.0+

Resources