{
  "ok": true,
  "schema": "wisely.local-commerce-bridge.setup.v1",
  "generatedAt": "2026-06-04T20:03:54.813Z",
  "title": "Wisely Local Commerce Browser Bridge",
  "status": {
    "remoteMcpSkillSource": "live",
    "localBridgePattern": "user-approved local install",
    "merchantCredentialsStayLocal": true,
    "serverBrowserNotRequired": true,
    "publicCustomerDoorDashOrders": "gift-card commerce lane remains separately gated by provider/redeem proof"
  },
  "purpose": "Let an agent connected to the Wisely MCP server learn how to install and use a local browser bridge so merchant cart-building happens on the user's own computer/browser session instead of Wisely's server.",
  "whenToUse": [
    "The user wants DoorDash or another merchant cart built from their own account/session.",
    "The agent is connected to Wisely MCP but cannot operate the user's local browser by itself.",
    "The flow needs local login, saved address, local browser cookies, or a merchant checkout screen.",
    "The user wants Wisely to handle quotes, x402/gift-card/crypto payment handoffs, fees, receipts, and local proof storage while the cart stays local."
  ],
  "neverDo": [
    "Do not ask the user to paste a DoorDash password into agent chat.",
    "Do not send merchant cookies, saved-card details, raw card data, CVV, seed phrases, or platform passwords to Wisely.",
    "Do not use Wisely's server browser or a private operator account for a public customer's merchant order.",
    "Do not click Place Order or buy a gift card without explicit final approval."
  ],
  "plainEnglishInstallScriptForAgent": [
    "I can use Wisely directly through MCP for quotes and payments. For DoorDash or merchant carts, I need a tiny local bridge so I can work in your own browser session instead of Wisely's server.",
    "You will install the bridge once. It runs only on your computer at 127.0.0.1 and lets me ask your local browser for safe actions like open the store, add items, and read checkout total.",
    "When the browser opens, log into DoorDash yourself. Do not paste your password into this chat.",
    "After login, I can build the cart locally and stop at checkout. I will show the total, delivery ETA, tip, address label, and payment/gift-card plan before anything is spent or placed.",
    "If you approve payment, I can open the Wisely wallet signing link in your local browser. You sign with your own wallet; I never see private keys or seed phrases.",
    "Wisely's server still handles x402 payment quotes, crypto/gift-card pricing, receipts, and proof. Your merchant login/session and saved local receipt vault stay on your machine."
  ],
  "userSetupSteps": [
    {
      "step": 1,
      "title": "Connect Wisely MCP",
      "instruction": "Add the remote MCP server https://payments.wiselyenterprisesllc.com/ai/mcp to your agent or ask the agent to call start_here."
    },
    {
      "step": 2,
      "title": "Install the local bridge package",
      "instruction": "Run the package install command your agent shows you, or install from the Wisely GitHub package. This is the only local component needed for browser-based merchant flows."
    },
    {
      "step": 3,
      "title": "Install the browser runtime if prompted",
      "instruction": "Run: npx playwright install chromium. This gives the local bridge a browser it can control on your machine."
    },
    {
      "step": 4,
      "title": "Start the bridge",
      "instruction": "Run: wisely-x402 local-bridge start. It starts a localhost-only MCP server at http://127.0.0.1:4027/mcp."
    },
    {
      "step": 5,
      "title": "Connect the local bridge to your agent",
      "instruction": "Add a second MCP server named wisely-local-commerce with URL http://127.0.0.1:4027/mcp. Keep the remote Wisely MCP server connected too."
    },
    {
      "step": 6,
      "title": "Log into DoorDash yourself",
      "instruction": "Tell the agent to open DoorDash through the local bridge. When the browser appears, type your own username/password or OTP directly into the browser. Do not send credentials in chat."
    },
    {
      "step": 7,
      "title": "Run the session test",
      "instruction": "Ask the agent: 'Check my DoorDash local session, empty any stale cart, and stop before adding items.' The agent should report whether it sees the account/session."
    },
    {
      "step": 8,
      "title": "Use it permanently",
      "instruction": "Leave the local bridge running when you want merchant cart help. The agent can build carts locally, then use Wisely MCP for crypto/gift-card/x402 payment quotes and receipts."
    },
    {
      "step": 9,
      "title": "Save receipts and gift-card records locally",
      "instruction": "After payment, ask the agent to save receipts, gift-card intents, and order records with local_vault_save. Gift-card codes/PINs/links are redacted unless you explicitly opt into sensitive local storage."
    }
  ],
  "installCommands": {
    "packageInstall": "npm install -g github:WiselyEnterprisesLLC/wisely-x402-agent-payments#v2.1.8",
    "setupGuide": "wisely-x402 local-bridge setup",
    "installBrowserRuntime": "npx playwright install chromium",
    "startBridge": "wisely-x402 local-bridge start",
    "testBridge": "wisely-x402 local-bridge test"
  },
  "mcpClientConfig": {
    "remoteWisely": {
      "type": "http",
      "url": "https://payments.wiselyenterprisesllc.com/ai/mcp",
      "purpose": "quotes, x402 payments, wallet handoff, gift-card quote, receipts, hosted endpoints"
    },
    "localCommerceBridge": {
      "type": "http",
      "url": "http://127.0.0.1:4027/mcp",
      "purpose": "local browser session, merchant cart building, checkout summary extraction, local wallet signing page, and local receipt/gift-card vault"
    }
  },
  "localToolsExpected": [
    {
      "name": "local_browser_status",
      "purpose": "Confirm the local bridge is running and browser profile is available."
    },
    {
      "name": "doordash_open",
      "purpose": "Open DoorDash or a direct store URL in the user's local browser."
    },
    {
      "name": "doordash_empty_cart",
      "purpose": "Clear stale local cart items before a new quote."
    },
    {
      "name": "doordash_add_items",
      "purpose": "Add straightforward items by name; stop on required options or ambiguity."
    },
    {
      "name": "doordash_checkout_summary",
      "purpose": "Read merchant, items, subtotal, fees, tax, tip, total, ETA, address label, and payment label without placing the order."
    },
    {
      "name": "wallet_open_signing_url",
      "purpose": "Open a Wisely x402 payment-session signing URL in the user's local wallet-capable browser."
    },
    {
      "name": "wallet_payment_session_status",
      "purpose": "Poll the payment session after user signing and save signed proof locally when available."
    },
    {
      "name": "local_vault_save",
      "purpose": "Save receipts, gift-card intents, and order records to the user's local vault with sensitive fields redacted by default."
    },
    {
      "name": "local_vault_list",
      "purpose": "List locally saved records without exposing gift-card codes, PINs, wallet secrets, or tokens."
    }
  ],
  "howWiselyAndLocalBridgeWorkTogether": [
    "Local bridge: builds and reads the DoorDash cart from the user's own browser.",
    "Remote Wisely MCP: quotes gift-card amount, crypto conversion/gas, x402 payment, service fees, receipts, and proof.",
    "Wallet bridge: opens the Wisely signing URL locally so the user signs in their own wallet browser or extension.",
    "Local vault: saves receipts, payment-session status, gift-card intents, and order records for the user. Gift-card codes/PINs/links are redacted unless explicitly opted in.",
    "Agent: explains progress in plain English and asks for final approval before any wallet signing, gift-card purchase, redemption, or Place Order."
  ],
  "exampleUserPrompt": "Use Wisely MCP and my local commerce bridge. Open DoorDash locally, build a Popeyes spicy chicken sandwich combo, use a fair tip, get the checkout total and ETA, then quote the crypto/gift-card route. If I approve, open the wallet signing URL locally and save the receipt/gift-card record to my local vault. Ask before any payment or order placement.",
  "exampleAgentFirstMessage": "I can do that, but first I need your local commerce bridge running so DoorDash stays in your own browser. I will walk you through the one-time setup. You will log into DoorDash yourself; do not paste your password here.",
  "platform": "auto",
  "links": {
    "remoteMcp": "https://payments.wiselyenterprisesllc.com/ai/mcp",
    "installProfile": "https://payments.wiselyenterprisesllc.com/ai/install-profile",
    "repository": "https://github.com/WiselyEnterprisesLLC/wisely-x402-agent-payments",
    "docs": "https://payments.wiselyenterprisesllc.com/guides/x402-agent-payment-infrastructure",
    "giftCardCommerceStatus": "https://payments.wiselyenterprisesllc.com/x402/commerce/gift-card",
    "doorDashGiftCardProcess": "https://payments.wiselyenterprisesllc.com/x402/commerce/gift-card/doordash/process"
  }
}