x402-bazaar 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x402 Bazaar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# x402-bazaar
+
+> Connect your AI agent to the x402 Bazaar marketplace in one command.
+
+x402 Bazaar is an autonomous marketplace where AI agents buy and sell API services using the HTTP 402 protocol with USDC payments on Base L2.
+
+## Quick Start
+
+```bash
+npx x402-bazaar init
+```
+
+This single command will:
+
+1. **Detect your environment** (Claude Desktop, Cursor, VS Code, Claude Code)
+2. **Install the MCP server** and its dependencies
+3. **Configure your wallet** (Coinbase API keys or read-only mode)
+4. **Generate the config** and write it to the correct location
+5. **Verify the connection** to the live marketplace
+
+## Commands
+
+### `npx x402-bazaar init`
+
+Full interactive setup. Detects your AI client, installs the MCP server, configures payments, and verifies the connection.
+
+```bash
+# Force a specific environment
+npx x402-bazaar init --env claude-desktop
+
+# Skip wallet setup (read-only browsing)
+npx x402-bazaar init --no-wallet
+
+# Use a custom server URL
+npx x402-bazaar init --server-url https://your-server.com
+```
+
+### `npx x402-bazaar config`
+
+Generate an MCP configuration file interactively.
+
+```bash
+# Generate and save to a file
+npx x402-bazaar config --output mcp-config.json
+
+# Force environment
+npx x402-bazaar config --env cursor
+```
+
+### `npx x402-bazaar status`
+
+Check if the marketplace server is online and display stats.
+
+```bash
+npx x402-bazaar status
+npx x402-bazaar status --server-url https://your-server.com
+```
+
+## Supported Environments
+
+| Environment | Config Location |
+|-------------|----------------|
+| Claude Desktop | `%APPDATA%/Claude/claude_desktop_config.json` (Windows) |
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
+| Cursor | `~/.cursor/mcp.json` |
+| VS Code + Continue | `~/.continue/config.json` |
+| Claude Code | `~/.claude.json` |
+
+## What is x402 Bazaar?
+
+x402 Bazaar is a marketplace where AI agents autonomously trade API services:
+
+- **Agents pay with USDC** on Base L2 (Coinbase's Layer 2)
+- **HTTP 402 protocol** — the server responds with payment details, the agent pays, then retries
+- **Every payment is verifiable** on-chain via BaseScan
+- **70+ services** available (search, AI, crypto, weather, and more)
+
+### Pricing
+
+| Action | Cost |
+|--------|------|
+| Browse marketplace info | Free |
+| Search services | 0.05 USDC |
+| List all services | 0.05 USDC |
+| Register a new service | 1.00 USDC |
+
+## Requirements
+
+- Node.js >= 18
+- npm or npx
+
+## Links
+
+- Website: https://x402bazaar.org
+- Dashboard: https://x402-api.onrender.com/dashboard
+- GitHub: https://github.com/Wintyx57
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { initCommand } from '../src/commands/init.js';
+import { configCommand } from '../src/commands/config.js';
+import { statusCommand } from '../src/commands/status.js';
+import chalk from 'chalk';
+
+// Global error handler
+process.on('unhandledRejection', (err) => {
+  console.error('');
+  console.error(chalk.red('Error: ' + (err.message || err)));
+  if (err.code === 'ERR_MODULE_NOT_FOUND') {
+    console.error(chalk.dim('  Run: npm install'));
+  }
+  process.exit(1);
+});
+
+const program = new Command();
+
+program
+  .name('x402-bazaar')
+  .description(chalk.hex('#FF9900')('x402 Bazaar') + ' — Connect your AI agent to the marketplace in one command')
+  .version('1.0.0');
+
+program
+  .command('init')
+  .description('Set up x402 Bazaar MCP server (detect environment, configure wallet, generate config)')
+  .option('--env <environment>', 'Force environment (claude-desktop, cursor, claude-code, vscode-continue, generic)')
+  .option('--no-wallet', 'Skip wallet configuration (read-only mode)')
+  .option('--server-url <url>', 'Custom server URL', 'https://x402-api.onrender.com')
+  .action(initCommand);
+
+program
+  .command('config')
+  .description('Generate MCP configuration file for your environment')
+  .option('--env <environment>', 'Target environment (claude-desktop, cursor, claude-code, vscode-continue, generic)')
+  .option('--output <path>', 'Output file path')
+  .action(configCommand);
+
+program
+  .command('status')
+  .description('Check connection to x402 Bazaar marketplace')
+  .option('--server-url <url>', 'Server URL to check', 'https://x402-api.onrender.com')
+  .action(statusCommand);
+
+// Default: show help if no command given
+if (process.argv.length <= 2) {
+  console.log('');
+  console.log(chalk.hex('#FF9900').bold('  x402 Bazaar') + chalk.dim(' — AI Agent Marketplace CLI'));
+  console.log('');
+  console.log('  Quick start:');
+  console.log(chalk.cyan('    npx x402-bazaar init') + chalk.dim('      Full interactive setup'));
+  console.log(chalk.cyan('    npx x402-bazaar status') + chalk.dim('    Check server connection'));
+  console.log(chalk.cyan('    npx x402-bazaar config') + chalk.dim('    Generate MCP config'));
+  console.log('');
+  console.log(chalk.dim('  Run with --help for all options'));
+  console.log('');
+  process.exit(0);
+}
+
+program.parse();

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "x402-bazaar",
+  "version": "1.0.0",
+  "description": "CLI to set up x402 Bazaar MCP server for AI agents. One command to connect your agent to the marketplace.",
+  "type": "module",
+  "main": "bin/cli.js",
+  "bin": {
+    "x402-bazaar": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node bin/cli.js",
+    "test": "node bin/cli.js --help"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "x402",
+    "mcp",
+    "ai-agents",
+    "marketplace",
+    "crypto",
+    "usdc",
+    "base",
+    "coinbase",
+    "claude",
+    "cursor",
+    "model-context-protocol"
+  ],
+  "author": "x402 Bazaar",
+  "license": "MIT",
+  "homepage": "https://x402bazaar.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wintyx57/x402-bazaar-cli"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "inquirer": "^9.3.0",
+    "ora": "^8.0.1"
+  }
+}

package/src/commands/config.js

@@ -0,0 +1,137 @@
+import inquirer from 'inquirer';
+import { writeFileSync, existsSync, readFileSync } from 'fs';
+import chalk from 'chalk';
+import { log } from '../utils/logger.js';
+import { detectEnvironment, getDefaultInstallDir } from '../detectors/environment.js';
+import { generateMcpConfig } from '../generators/mcp-config.js';
+
+export async function configCommand(options) {
+  log.banner();
+  log.info('MCP Configuration Generator');
+  log.separator();
+
+  // Detect or ask for environment
+  let targetEnv = options.env;
+
+  if (!targetEnv) {
+    const environments = detectEnvironment();
+    const detected = environments.filter(e => e.detected);
+
+    const choices = [
+      ...environments.map(e => ({
+        name: `${e.label}${e.detected ? chalk.hex('#34D399')(' (detected)') : ''}`,
+        value: e.name,
+      })),
+      { name: 'Generic (print JSON to stdout)', value: 'generic' },
+    ];
+
+    const { env } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'env',
+        message: 'Which environment do you want to configure?',
+        choices,
+        default: detected.length > 0 ? detected[0].name : 'claude-desktop',
+      },
+    ]);
+    targetEnv = env;
+  }
+
+  // Ask for config values
+  const { serverUrl, maxBudget, network } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'serverUrl',
+      message: 'x402 Bazaar server URL:',
+      default: 'https://x402-api.onrender.com',
+    },
+    {
+      type: 'input',
+      name: 'maxBudget',
+      message: 'Max USDC budget per session:',
+      default: '1.00',
+    },
+    {
+      type: 'list',
+      name: 'network',
+      message: 'Network:',
+      choices: [
+        { name: 'Base Mainnet (real USDC)', value: 'mainnet' },
+        { name: 'Base Sepolia (testnet)', value: 'testnet' },
+      ],
+      default: 'mainnet',
+    },
+  ]);
+
+  // Ask for wallet config
+  const { walletMode } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'walletMode',
+      message: 'Wallet configuration:',
+      choices: [
+        { name: 'I have Coinbase API keys', value: 'existing' },
+        { name: 'Read-only mode (browse only, no payments)', value: 'readonly' },
+      ],
+    },
+  ]);
+
+  let coinbaseApiKey = '';
+  let coinbaseApiSecret = '';
+
+  if (walletMode === 'existing') {
+    const walletAnswers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'coinbaseApiKey',
+        message: 'Coinbase API Key:',
+        validate: (v) => v.length > 0 || 'API key is required',
+      },
+      {
+        type: 'password',
+        name: 'coinbaseApiSecret',
+        message: 'Coinbase API Secret:',
+        mask: '*',
+        validate: (v) => v.length > 0 || 'API secret is required',
+      },
+    ]);
+    coinbaseApiKey = walletAnswers.coinbaseApiKey;
+    coinbaseApiSecret = walletAnswers.coinbaseApiSecret;
+  }
+
+  const installDir = getDefaultInstallDir();
+
+  // Generate config
+  const config = generateMcpConfig({
+    environment: targetEnv,
+    installDir,
+    serverUrl,
+    maxBudget,
+    network,
+    coinbaseApiKey,
+    coinbaseApiSecret,
+    readOnly: walletMode === 'readonly',
+  });
+
+  log.separator();
+  log.success('Generated configuration:');
+  console.log('');
+  console.log(JSON.stringify(config, null, 2));
+  console.log('');
+
+  // Output
+  const outputPath = options.output;
+
+  if (outputPath) {
+    writeFileSync(outputPath, JSON.stringify(config, null, 2));
+    log.success(`Config written to ${outputPath}`);
+  } else {
+    const environments = detectEnvironment();
+    const envInfo = environments.find(e => e.name === targetEnv);
+    if (envInfo) {
+      log.info(`To apply, paste this into: ${chalk.bold(envInfo.configPath)}`);
+    }
+  }
+
+  console.log('');
+}