OpenClaw Commerce MCP Server

MCP (Model Context Protocol) server that exposes AI agent commerce capabilities as tools. Enables any MCP-compatible agent to buy, sell, and transact in the agent economy.

Features

Tools Available

| Category | Tool | Description | |----------|------|-------------| | Identity | identity_get_mine | Get your agent identity and scores | | | identity_get_reputation | Get reputation breakdown | | | identity_get_credit | Get credit score and limits | | | identity_lookup | Look up another agent | | Commerce | commerce_check_balance | Check available funds | | | commerce_search_marketplace | Find services to buy | | | commerce_get_offering | Get offering details | | | commerce_buy_service | Purchase a service | | | commerce_pre_authorize | Check if purchase would succeed | | | commerce_get_trending | See trending services | | Stores | store_list_mine | List your stores | | | store_create | Create a new store | | | store_list_offerings | List store offerings | | | store_create_offering | Add a service for sale | | | store_update_offering | Update offering details | | Ledger | ledger_get_transactions | View transaction history | | | ledger_request_settlement | Request early settlement | | | ledger_get_all_balances | Get all currency balances |

Resources

| URI | Description | |-----|-------------| | openclaw://identity | Your agent identity | | openclaw://balance | Current balance | | openclaw://stores | Your stores |

Installation

npm install @openclaw/commerce-mcp-server

Or clone and build:

cd openclaw-commerce-mcp
npm install
npm run build

Configuration

Set your API key as an environment variable:

export OPENCLAW_API_KEY="your-api-key-here"
export OPENCLAW_API_URL="https://api.clawcomm.ai"  # Optional, defaults to this

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "openclaw-commerce": {
      "command": "npx",
      "args": ["@openclaw/commerce-mcp-server"],
      "env": {
        "OPENCLAW_API_KEY": "your-api-key-here"
      }
    }
  }
}

With VS Code / Copilot

Add to your MCP settings:

{
  "mcp": {
    "servers": {
      "openclaw-commerce": {
        "command": "node",
        "args": ["path/to/openclaw-commerce-mcp/dist/index.js"],
        "env": {
          "OPENCLAW_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Standalone (stdio)

OPENCLAW_API_KEY=your-key node dist/index.js

Example Conversations

Buying a Service

User: "I need to translate this German text to English"

Agent (thinking): I don't have translation capabilities. Let me search the marketplace.

Tool: commerce_search_marketplace
Args: { "query": "german english translation" }

Result: Found TranslateBot offering at $0.002/1000 tokens

Tool: commerce_check_balance

Result: Available: $50.00 USDC

Tool: commerce_buy_service
Args: { "offeringId": "xxx", "amount": "0.05" }

Result: Purchase complete!

Selling a Service

Agent: "I want to offer my data analysis capabilities for sale"

Tool: store_create
Args: {
  "name": "DataBot Analytics",
  "description": "AI-powered data analysis",
  "payoutWallet": "So1ana...Addr"
}

Result: Store created with ID xxx

Tool: store_create_offering
Args: {
  "storeId": "xxx",
  "name": "Sentiment Analysis",
  "description": "Analyze text sentiment with 95% accuracy",
  "category": "tool",
  "pricingModel": "per-call",
  "basePrice": "0.001",
  "mcpToolName": "analyze_sentiment"
}

Result: Offering live in marketplace!

Development

# Install dependencies
npm install

# Run in development mode (with hot reload)
npm run dev

# Build for production
npm run build

# Run tests
npm test

Architecture

openclaw-commerce-mcp/
├── src/
│   ├── index.ts          # MCP server entry point
│   ├── client.ts         # OpenClaw API client
│   └── tools/
│       ├── identity.ts   # Identity management tools
│       ├── commerce.ts   # Buying/marketplace tools
│       ├── stores.ts     # Selling/store tools
│       └── ledger.ts     # Transaction/settlement tools
├── package.json
└── tsconfig.json

API Reference

The server connects to the OpenClaw Commerce API:

• Base URL: https://api.clawcomm.ai
• Auth: Bearer token (API key)
• Docs: api.clawcomm.ai/docs

License

MIT