@bosonprotocol/agentic-commerce

@bosonprotocol/agentic-commerce

Agentic commerce tools for Boson and Fermion protocols - providing MCP clients, servers, and future Goat SDK plugins.

📦 Installation

npm install @bosonprotocol/agentic-commerce

🚀 Usage

Import Clients

import { 
  BosonMCPClient, 
  FermionMCPClient, 
  BosonGoatSdkPlugin, 
  FermionGoatSdkPlugin 
} from '@bosonprotocol/agentic-commerce';

// Or import specific modules
import { BosonMCPClient } from '@bosonprotocol/agentic-commerce/boson';
import { FermionMCPClient } from '@bosonprotocol/agentic-commerce/fermion';
import { BaseMCPClient } from '@bosonprotocol/agentic-commerce/common';

MCP Client Usage

// Connect to Boson MCP server
const bosonClient = new BosonMCPClient();
await bosonClient.connectToServer('http://localhost:3001');

// Create a seller
await bosonClient.createSeller(sellerParams);

// Create an offer
await bosonClient.createOffer(offerParams);

🚀 Supported Protocols

📦 Boson Protocol

Decentralized commerce protocol for tokenizing products and services as NFTs.

⚛️ Fermion Protocol

Next-generation marketplace protocol with advanced features and verification systems.

🛠️ Quick Start

Installation

npm install
npm run build

Run Boson Protocol Server

npm run start:boson

Run Fermion Protocol Server

npm run start:fermion

🧪 Development

# Install dependencies
npm install

# Watch mode for development
npm run watch

# Development servers
npm run dev:boson    # Boson Protocol
npm run dev:fermion  # Fermion Protocol

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Linting and type checking
npm run lint
npm run typecheck

📋 Environment Setup

• Copy mcpServer.example.json to mcpServer.json if not automatically done
• Fill in your INFURA_IPFS_PROJECT_ID and INFURA_IPFS_PROJECT_SECRET
• Set your IPFS_GATEWAY (optional, defaults to Boson Protocol's Infura IPFS gateway)
• Change CONFIG_ID if needed
• Set SIGNER_ADDRESS to your Ethereum address

🔧 Development Scripts

# Run all CI checks locally
npm run ci

# Type checking
npm run typecheck
npm run typecheck:tests

# Linting
npm run lint          # Strict (0 warnings)
npm run lint:ci       # CI-friendly (100 warnings max)
npm run lint:fix      # Auto-fix issues

# Testing
npm run test          # Run all tests
npm run test:watch    # Watch mode
npm run test:coverage # With coverage

📋 Requirements

• Node.js 23+
• Infura project ID and secret

📚 Documentation

For detailed protocol-specific documentation, please refer to:

• Boson Protocol Documentation - Complete setup and usage guide for Boson Protocol
• Fermion Protocol Documentation - Complete setup and usage guide for Fermion Protocol

🤝 Contributing

• Fork the repository
• Create a feature branch
• Make your changes
• Run tests and linting: npm run ci
• Submit a pull request