# Agent Integration

Enable AI agents to perform autonomous decentralized commerce operations through Boson Protocol's comprehensive commerce infrastructure.

## Integration Requirements

To enable decentralized commerce capabilities in your AI agent, your agent needs to support:

* **MCP Server Connection**: Connect to external Model Context Protocol servers to access commerce tools
* **EVM Transaction Signing**: Handle blockchain transaction signing for EVM-compatible networks
* **Tool Registration**: Register and utilize external tools within your agent framework
* **Multi-Chain Configuration**: Support different blockchain networks and environments

## How Boson Simplifies Integration

Boson Protocol abstracts away the complexity through the [@bosonprotocol/agentic-commerce](https://www.npmjs.com/package/@bosonprotocol/agentic-commerce) package, which provides:

* **40+ Ready-to-Use Commerce Tools**: Complete toolkit for decentralized marketplace operations
* **MCP Server Integration**: Pre-built connection to Boson's commerce infrastructure
* **GOAT SDK Plugin**: Framework adapters for popular AI SDKs (LangChain, Vercel AI, etc.)
* **Transaction Handling**: Simplified blockchain transaction preparation and signing workflows
* **Multi-Chain Support**: Automatic network detection and configuration management
* **Boson Local Environment Setup:** Easy to start local environment of Boson protocol (full protocol deployed locally, making it very easy to test your AI agent integration)

Instead of building custom integrations for each blockchain and commerce operation, you can use Boson's unified interface to enable your agents with full commerce capabilities.

## Integration Approaches

You can integrate Boson Protocol with your AI agent using two main approaches:

### 1. Boson GOAT SDK Plugin (Recommended)

Use the `bosonProtocolPlugin` from [`@bosonprotocol/agentic-commerce`](https://www.npmjs.com/package/@bosonprotocol/agentic-commerce):

* **Handles everything**: MCP server communication, tool registration, AND transaction signing
* Pre-built GOAT SDK plugin that works with any AI framework adapter
* Type-safe tool integration with 40+ commerce tools automatically available
* Simplest integration path - just plug in and use

### 2. Direct MCP Client Integration

Use the `BosonMCPClient` from [`@bosonprotocol/agentic-commerce`](https://www.npmjs.com/package/@bosonprotocol/agentic-commerce) directly:

* **Handle MCP communication yourself**: Connect to server, call tools manually
* **Handle transaction signing yourself**: MCP client returns unsigned transactions that you must sign and submit
* Custom tool registration in your agent framework
* Full control over integration architecture

## Next Steps

See our LangChain Implementation [Example](/using-the-protocol/agent-integration/langchain-implementation-example.md) for a more specific code examples and step-by-step integration guide. <br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bosonprotocol.io/using-the-protocol/agent-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.