@bosonprotocol/agentic-commerce

MCP server, MCP client, and GOAT SDK plugin for Boson Protocol — the decentralized Agentic Commerce Protocol (dACP) that enables agents to securely buy and sell anything — digital or physical — with game-theoretic guarantees.

🤖 For AI Agents

See AGENTS.md for a comprehensive AI agent guide covering end-to-end selling and buying flows, exchange lifecycle, configuration, and integration options. Claude Code auto-loads it via the CLAUDE.md → @AGENTS.md import.

Hosted MCP servers (no setup required):

• Staging: https://mcp-staging.bosonprotocol.io/mcp
• Production: https://mcp.bosonprotocol.io/mcp

📚 Documentation

• AI Agent Guide — End-to-end flows, exchange & dispute lifecycles, enums, integration options
• MCP Server README — All 56 tools, 2 prompts, 10 resources with full parameter reference
• MCP Client README — TypeScript client usage
• GOAT SDK Plugin README — Agent framework integration (Anthropic, Vercel AI)
• High Value Asset Module README — High-value/luxury asset marketplace (formerly Fermion Protocol, integrated into Boson in 2025)
• E2E Test Suite — Runnable reference for every seller/buyer/dispute flow
• Boson Protocol Docs — Protocol concepts and architecture
• Agent Integration Docs — MCP + GOAT SDK guide on the protocol site

🧪 Development

# Install dependencies
pnpm i --frozen-lockfile

# Watch mode for development
pnpm watch

# Run each in a terminal:
pnpm dev:boson:http
pnpm dev:boson:http:inspector

# Run all tests
pnpm test

# Run with coverage
pnpm test:coverage

# Linting and type checking
pnpm lint
pnpm typecheck

📋 Environment Setup

1. Copy mcpServer.example.json to mcpServer.json if not automatically done
2. Update the args array to match the real path to the file to be run

📋 Requirements

• Node.js 23+
• Infura project ID and secret (check .env.example)

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request