Tool Marketplace — Publish, Discover, Call

What is the Tool Marketplace?

The BizNode Tool Marketplace is the capability layer of the network. Every BizNode instance — Basic, Pro, or Admin — can publish tools that other nodes can discover and call. Think of it as an API marketplace that runs itself: no central gatekeepers, no manual integrations, just tools registered in a global directory and invoked over the BizNode mesh network.

Tools range from simple utilities (PDF generation, image compression) to complex AI pipelines (market analysis, lead scoring, content generation). Publishers set pricing — free, per-call, or subscription — and the marketplace handles discovery, authentication, metering, and payment.

How Tool Publishing Works

Any node operator can publish a tool to the marketplace. The process is straightforward: define a tool manifest, register it with the registry, and your tool is live on the network.

1. Define the Tool Manifest

Every tool is described by a JSON manifest that specifies its name, version, input/output schema, pricing model, and the endpoint where it can be called.

{
  "tool_id": "pdf-generator-v2",
  "name": "PDF Report Generator",
  "version": "2.1.0",
  "description": "Generate branded PDF reports from structured data",
  "category": "document",
  "tags": ["pdf", "report", "generation"],
  "endpoint": "https://mynode.1bz.biz/tools/pdf-generate",
  "auth": "api_key",
  "input_schema": {
    "type": "object",
    "properties": {
      "title": { "type": "string" },
      "sections": { "type": "array" },
      "branding": { "type": "object" }
    },
    "required": ["title", "sections"]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "pdf_url": { "type": "string" },
      "page_count": { "type": "integer" }
    }
  },
  "pricing": {
    "model": "per_call",
    "price_bzeusd": 0.50,
    "free_tier_calls": 10
  },
  "sla": {
    "max_latency_ms": 5000,
    "uptime_target": 99.5
  }
}

2. Register with the Registry

Submit the manifest to registry.1bz.biz. The registry validates the schema, pings your endpoint for a health check, and adds the tool to the global directory.

POST https://registry.1bz.biz/api/tools/register
Authorization: Bearer <node_api_key>
Content-Type: application/json

{
  "manifest": { ... },
  "publisher_node_id": "BZN-A1B2C-D3E4F-G5H6I",
  "polygon_address": "0xABC...DEF"
}

3. Automatic Health Monitoring

Once registered, the registry pings your tool endpoint every 60 seconds. Tools that fail three consecutive health checks are marked degraded and deprioritized in search results. Sustained downtime triggers offline status.

4. Version Management

• Publish new versions without breaking existing callers — old versions stay active until deprecated
• Semantic versioning enforced: callers can pin to ^2.0.0 or ~2.1.0
• Deprecation notices are broadcast to all active callers 7 days before removal

How Tool Discovery Works

The registry at registry.1bz.biz is the global directory for all published tools. Agents and nodes search by capability, category, or keyword — not by knowing a specific tool name.

Search by Capability

AI agents describe what they need in natural language. The registry uses embedding-based semantic search to match the request against tool descriptions, tags, and schemas.

POST https://registry.1bz.biz/api/tools/search
{
  "query": "convert HTML content to a branded PDF document",
  "category": "document",
  "max_price_bzeusd": 1.00,
  "min_uptime": 95.0,
  "limit": 5
}

{
  "results": [
    {
      "tool_id": "pdf-generator-v2",
      "name": "PDF Report Generator",
      "relevance_score": 0.94,
      "price_per_call": 0.50,
      "uptime_30d": 99.8,
      "avg_latency_ms": 1200,
      "total_calls_30d": 14520,
      "publisher": "BZN-A1B2C-D3E4F-G5H6I",
      "rating": 4.8
    },
    {
      "tool_id": "html2pdf-lite",
      "name": "HTML to PDF Converter",
      "relevance_score": 0.87,
      "price_per_call": 0.00,
      "uptime_30d": 97.2,
      "avg_latency_ms": 800,
      "total_calls_30d": 3100,
      "publisher": "BZN-X9Y8Z-W7V6U-T5S4R",
      "rating": 4.3
    }
  ],
  "total_matches": 12
}

Ranking Factors

Category Browsing

How Tool Calling Works — Free vs Paid

Once a tool is discovered, calling it follows a uniform protocol regardless of whether the tool is free or paid. The difference is in the settlement step.

// Step 1: Resolve
GET https://registry.1bz.biz/api/tools/pdf-generator-v2/resolve
→ { "endpoint": "https://mynode.1bz.biz/tools/pdf-generate",
    "call_token": "ct_7f3a...b2e1", "escrow_locked": 0.50 }

// Step 2: Execute
POST https://mynode.1bz.biz/tools/pdf-generate
Authorization: Bearer ct_7f3a...b2e1
{
  "title": "Q1 Sales Report",
  "sections": [
    { "heading": "Revenue", "content": "Total: $142,000" },
    { "heading": "Growth", "content": "+23% QoQ" }
  ]
}
→ { "pdf_url": "https://mynode.1bz.biz/output/q1-report.pdf",
    "page_count": 4 }

// Step 3: Settle (automatic)
→ 0.475 BZeUSD → publisher, 0.025 BZeUSD → platform

Free Tier Rules

• Publishers can offer a free tier with a call limit (e.g., 10 free calls per node per month)
• Free calls still require a call_token for authentication and metering
• Once the free tier is exhausted, subsequent calls require BZeUSD escrow
• Tools marked "pricing.model": "free" have unlimited free calls with no escrow

Cost Calculator

Estimate your monthly tool marketplace costs based on usage volume and tool mix.

The Global Registry — registry.1bz.biz

The registry is the central directory for all tools on the BizNode network. It runs as a dedicated service and provides the APIs that nodes use for publishing, discovery, resolution, and settlement.

Registry API Endpoints