{
  "name": "sibidz",
  "version": "4.1.0",
  "description": "Find lots on the Floor and bid through your AI assistant.",
  "offers": {
    "welcome_credits": {
      "amount": "1000",
      "currency": "SIBIDZ",
      "applied_at": "successful_email_verification",
      "frequency": "once_per_eligible_identity_and_verified_mailbox",
      "destination": "designated grant account",
      "use": "eligible platform services; nontransferable, nonwithdrawable, cannot pay others",
      "standard_onboarding_deductions": "12",
      "standard_remaining": "988",
      "fees": "Award and setup settle together; an unfunded remainder is waived. No pre-verification debt or crypto dependency.",
      "tokens": false,
      "purchase_required": false,
      "expiry": null,
      "periodic_reset": false
    },
    "referral_reward": {
      "amount": "4000",
      "unit": "SIBIDZ",
      "benefit": "promotional_service_credits",
      "credit_cap": "12000",
      "cap_period": "UTC_calendar_month",
      "daily_count_limit": 10,
      "monthly_count_limit": 100,
      "trigger": "first_eligible_accepted_live_bid",
      "authorization": "Durable processing; held referrals require review, not an automatic next-month award",
      "status_tool": "inspect",
      "status_kind": "referrals"
    }
  },
  "endpoint": "https://sibidz.io/mcp",
  "transport": "streamable-http",
  "protocol_versions": [
    "2025-11-25",
    "2025-06-18",
    "2025-03-26"
  ],
  "modern_protocol": {
    "version": "2026-07-28",
    "discovery_method": "server/discover",
    "discovery_authentication": "oauth",
    "initialize": false
  },
  "methods": {
    "GET": "This finite discovery document. Explicit Accept: text/event-stream requests use the MCP notification transport.",
    "POST": "MCP JSON-RPC requests. Ordinary tool replies are JSON; event streams are used for live notifications.",
    "DELETE": "End an initialized MCP session."
  },
  "credits": "0",
  "authentication": "Connect the agent through OAuth; the human only approves. The agent uses account start intent=create for a new account or intent=recover for an existing one, then completes verification through MCP. All documentation/reference resources are free and need no account. search calls require a verified account and cost 6 credits, including zero results.",
  "authorization": {
    "resource": "https://sibidz.io/mcp",
    "resource_metadata": "https://sibidz.io/.well-known/oauth-protected-resource",
    "scopes": [
      "sibidz"
    ]
  },
  "request_headers": {
    "Content-Type": "application/json",
    "Accept": "application/json, text/event-stream"
  },
  "session_header": "Mcp-Session-Id",
  "initialize": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {
        "name": "sibidz-client",
        "version": "1"
      }
    }
  },
  "public_access": {
    "anonymous": "GET discovery, modern direct public documentation reads, inspect guide/agreement/currencies and readiness ping",
    "oauth": "initialize, tools/list, server/discover and resource enumeration; verified account required for ordinary paid operations"
  },
  "next": "Complete OAuth first. For a sessionful protocol, POST initialize to the endpoint, retain Mcp-Session-Id if returned, send notifications/initialized, then use tools/list and inspect {kind:\"guide\"} (also available as auction://guide). Complete OAuth account setup and verification before calling search.",
  "tools": [
    "account",
    "search",
    "inspect",
    "lot",
    "auction",
    "bid",
    "credits",
    "support"
  ],
  "guide": {
    "uri": "auction://guide",
    "credits": "0",
    "text": "Sibidz 4.1.0. Customer tools: account, search, inspect, lot, auction, bid, credits, support. Docs 2026-10-17.2. Guide/reference/spec/errors/examples, agreement and currencies are free before account setup; tools/list supplies strict operation schemas. Administration uses a separate connector.\n\n## Connect and account\nOAuth browser approval connects an agent only. account start intent=create {name,email,referral_code?} then verify {code}. Existing identity: start intent=recover {email}, then verify; choose a returned profile_id if requested. Preserve code zeros; use authorised mailbox access or ask its owner. Never guess codes, paste tokens in chat or register again for recovery.\nWelcome: 1000 SIBIDZ service credits once per eligible identity/mailbox; standard setup deducts 12, leaving 988. No wallet, purchase, expiry, periodic reset or debt. Grant funds pay eligible services first; normal funds cover the remainder. Another seller's catalogue charge, transfers and token withdrawals require normal funds in full. Extra accounts never repeat awards or limits.\n\n## Find and bid\nsearch scope=lots|auctions, kind=single|catalogue, status=open|upcoming|closed. listings/won/submissions are private customer scopes. Keep cursor filters. lot_id=item, auction_id=catalogue, run_id=edition, entry_id=offer.\nInspect entry and agreement; obtain principal authority, age18+, electronic/public-history consent and account accept_agreement. bid place needs exact accept_terms hash and separate sale_contact_consent:true with the disclosure version/hash on the first bid. Keep the returned bid_seq. Retract with a reason if still permitted. A standing bid is not a sale. inspect watch creates/resumes your watch lease; follow its notification instructions and after cursor. Closed hammer prices are not proof of payment.\n\n## Approval\naccount apply → lot save {listing,photos?} → inspect lot until approved → lot publish. Save needs request_id; updates need lot_id and expected_revision. Goods need real photos; save can import/upload them. Simulation never means provider approval. Deferred checks resume within budget at retry_at/budget_reset_at (UTC), without editing.\nRead the separate sale_contact disclosure. Explicitly accept the auction agreement and save receiving details before publication. Fiat settlement requires method=bank_transfer|payment_service and country; crypto requires exact network/symbol/decimals. Publish an approved revision with frozen prices, receiving account and sale-contact authority. Use sale target=existing with auction_id/run_id, or target=standalone with its schedule.\nauction creates catalogues, configures policies, schedules the next empty run after closure, orders entries before opening or reviews your catalogue's submissions. Manual ordering requires attributes.ordering=manual. Admission is auto|closed|gated|review; own lots bypass catalogue review only. Follow a pending submission with inspect; never resubmit it. Platform moderation is separate. Correct eligible unbid content with lot save; inspect reference describes the exact limits and reapproval.\n\n## Fees (credits)\naccount: registration6 (additional login24), verification6; update/apply/agreement/receiving-details/consent withdrawal6; resend6; recovery/invite/observer0. search:6 including empty results. inspect: profile/submission6, watch6 then2 with after; other kinds0. lot: save50 plus6 per integrated photo, photo6, check0, publish8+organiser fee (standalone also16), remove up to64, slug6. auction: create/schedule16, other actions6. bid: place/retract12. credits: transfer6, evidence32, financial calls0; network/acquisition/withdrawal costs remain. support:0. Valid offer removal/bid retraction collects available eligible funds and waives any remainder once. Invalid paid calls:1 if funded, otherwise waived; exemptions and original errors remain.\n\n## Funds and recovery\ninspect payment_options → credits prepare → read quote/terms → credits confirm → pay/sign once → credits submit if needed → inspect operation. BTC is observed. Direct SIBIDZ (minimum1) or USDC/BTC Tinyman output G credits G-floor(G/400) to the chosen normal account. Withdrawal requires confirmed unheld normal principal plus fee8, with no waiting period. Grant is never a token claim. Recovery uses the existing operation and current authority; never pay again. credits purchase_evidence costs32; inspect evidence reads that purchase free. inspect sale is always free to seller/winner.\n\n## Errors and recovery\nResults contain data,billing and may include state,next,retry. Follow next only with required authority. request_id is a logical retry key; finance retains client_id where specified; JSON-RPC id is not a retry key. Identical retries keep routing and original receipts. committed=true means follow recovery, never repay. Support is free, without a reply/SLA promise. Auction prices are paid directly between buyer and seller. Sibidz supplies no auction escrow, payment verification or dispute adjudication. Service-credit acquisition is a separate platform transaction."
  },
  "examples": {
    "uri": "auction://examples",
    "credits": "0",
    "read": {
      "jsonrpc": "2.0",
      "id": 2,
      "method": "resources/read",
      "params": {
        "uri": "auction://examples"
      }
    }
  },
  "schemas": {
    "method": "tools/list",
    "credits": "0",
    "input": "inputSchema",
    "output": "outputSchema"
  },
  "referrals": {
    "authenticated": true,
    "credits": "0",
    "tools": [
      "inspect",
      "account"
    ],
    "examples": [
      {
        "name": "inspect",
        "arguments": {
          "kind": "referrals"
        }
      }
    ],
    "invitations": "Only with explicit user authority and a recipient who welcomes it: account {action:\"invite\",email,consent:true}. Never send unsolicited or bulk email.",
    "sharing": "Share the public url. New account start intent=create may include referral_code; existing identities use intent=recover and never register again."
  },
  "links": {
    "home": "https://sibidz.io/",
    "terms": "https://sibidz.io/terms",
    "privacy": "https://sibidz.io/privacy",
    "claude": "https://sibidz.io/connect/claude",
    "chatgpt": "https://sibidz.io/connect/chatgpt",
    "cursor": "https://sibidz.io/connect/cursor"
  }
}