← 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", "@forthebots/mcp-server"],
      "env": {
        "NOUI_API_KEY": "bz_your_key_here"
      }
    }
  }
}

This guide uses the packaged stdio server. https://noui.bot/api/v1 is an API index, not a supported desktop MCP transport.

The key enables three tools: bazaar_list_tools (catalog and prices), bazaar_call_tool (runs a tool through the metered proxy) and bazaar_balance.

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:

> Is https://example.com up?

🔧 Calling monitor.health via Bazaar...

status: 200 | Cost: $0.01 | 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.