โ† docs

Connect Bazaar to Claude Desktop

Use Bazaar-metered MCP tools directly from Claude Desktop, Cursor, or Windsurf. Every tool call is metered, receipted, and billed transparently.

1. Get Your API Key

Register as a consumer (agent developer) to get a Bazaar API key:

curl -X POST https://noui.bot/api/bazaar/register-consumer \
  -H "Content-Type: application/json" \
  -d '{"name": "My Agent", "email": "dev@example.com"}'

# Returns: { "api_key": "bz_abc123..." }

Or register at noui.bot/developers/register

2. Configure Claude Desktop

Add the noui.bot MCP server to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "noui-bazaar": {
      "command": "npx",
      "args": ["-y", "@noui/mcp-server"],
      "env": {
        "NOUI_API_KEY": "bz_your_key_here"
      }
    }
  }
}

Or connect directly via HTTP (no npm required):

{
  "mcpServers": {
    "noui-bazaar": {
      "url": "https://noui.bot/api/v1",
      "headers": {
        "Authorization": "Bearer bz_your_key_here"
      }
    }
  }
}

3. Load Balance

Pre-fund your account to start calling paid tools:

# Load $5.00 balance (Stripe Checkout)
curl -X POST https://noui.bot/api/bazaar/balance/load \
  -H "Authorization: Bearer bz_your_key" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 500}'

# Check balance
curl https://noui.bot/api/v1/bazaar/balance \
  -H "Authorization: Bearer bz_your_key"

4. Use Tools

Once configured, Claude can discover and call Bazaar tools directly:

Example Claude conversation:

> Check the wallet balance for 0xAgent1

๐Ÿ”ง Calling wallet.balance via Bazaar...

USDC: 142.50 | ETH: 0.0847 | Cost: $0.05 | Receipt: rcpt_a1b2c3d4

5. Monitor Usage

# View usage summary
curl https://noui.bot/api/v1/bazaar/usage/summary \
  -H "Authorization: Bearer bz_your_key"

# Verify any receipt
curl https://noui.bot/api/v1/bazaar/receipts/rcpt_a1b2c3d4

# Check provider trust score
curl https://noui.bot/api/v1/bazaar/providers/{provider_id}/trust

Also Works With

Cursor

Same config as Claude Desktop. Add to MCP settings in Cursor preferences.

Windsurf

Add MCP server in Windsurf settings โ†’ MCP Servers.

LangChain

MCP tools as LangChain StructuredTools.

CrewAI

Multi-agent crews with Bazaar tools.

AutoGen

Microsoft AutoGen + Bazaar tools.