← docs

Quickstart

First metered MCP tool call in 5 minutes.

⏱ ~5 minutes
1

Get an API key

Register as a consumer to get your API key. This takes 30 seconds.

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

Or use the web registration form.

You'll get a key like bz_live_abc123...— save it, it won't be shown again.

2

Browse the catalog

See what tools are available:

curl https://noui.bot/api/bazaar/catalog | jq '.tools[] | {name: .display_name, price: .pricing.price}'

Or browse visually at /marketplace.

3

Make your first call

Call any tool through the Bazaar proxy:

Proxy a tool call
curl -X POST https://noui.bot/api/bazaar/proxy \
  -H "Authorization: Bearer bz_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "weather_forecast",
    "input": {
      "location": "San Francisco, CA"
    }
  }'

The Bazaar authenticates you, meters the call, proxies it to the provider, and returns the result. If the tool costs money, it's deducted from your balance.

4

Check your usage

See what you've used and what it cost:

curl https://noui.bot/api/bazaar/usage/summary \
  -H "Authorization: Bearer bz_live_your_key_here" | jq

Or visit your dashboard.

5

Load balance (for paid tools)

Free tools work immediately. For paid tools, load your prepaid balance:

curl -X POST https://noui.bot/api/bazaar/balance/load \
  -H "Authorization: Bearer bz_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 500}'

$5.00 minimum. Returns a Stripe Checkout URL. Your balance is available instantly after payment.

Using the TypeScript SDK

Install
npm install @noui/bazaar-sdk
Usage
import { BazaarClient } from '@noui/bazaar-sdk';

const bazaar = new BazaarClient({
  apiKey: 'bz_live_your_key_here'
});

// List available tools
const catalog = await bazaar.catalog();

// Call a tool
const result = await bazaar.call('weather_forecast', {
  location: 'San Francisco, CA'
});

// Check usage
const usage = await bazaar.usage();
console.log(`Total calls: ${usage.total_calls}`);
console.log(`Total cost: $${(usage.total_cost_cents / 100).toFixed(2)}`);

Framework Guides

Claude / Anthropic→LangChain→CrewAI→AutoGen→Monetize Your Server→

Next steps