MPP quickstart

Use link-cli mpp pay to request a browser session, approve the payment in Link, and connect with Stagehand, Playwright, or Puppeteer. You don’t need a Browserbase account or API key.

Connect your Link account

Install Link CLI with Node.js:

npm install -g @stripe/link-cli
link-cli auth status

If Link isn’t connected, start the login flow:

link-cli auth login \
  --client-name "Browserbase agent" \
  --scope "userinfo:read payment_methods.agentic" \
  --interval 5 \
  --timeout 300

Open the verification URL, sign in, and approve the connection. Wait for authentication to finish before requesting a payment. Add a payment method in Link if needed. If an existing connection doesn’t include the payment_methods.agentic scope, use link-cli auth upgrade with the same options to add it.

Inspect the payment challenge

Make an unauthenticated request to see the price before paying:

cURL

curl -i https://mpp.browserbase.com/browser/session/create \
  -H 'Content-Type: application/json' \
  -d '{"estimatedMinutes": 250}'

Browserbase returns 402 Payment Required with payment challenges in the WWW-Authenticate header. Link CLI uses the challenge with method="stripe", which specifies the merchant, amount, and currency. This request doesn’t create a session or make a payment. This example requests 250 minutes for 0.50 USD, the minimum purchase. Increase estimatedMinutes to buy more time.

Pay with Link

Run link-cli mpp pay with the same session request:

link-cli mpp pay https://mpp.browserbase.com/browser/session/create \
  --method POST \
  --header 'Content-Type: application/json' \
  --data '{"estimatedMinutes": 250}' \
  --context "Pay for 250 minutes of Browserbase browser access so my agent can complete the web browsing task I requested, using the amount quoted by Browserbase."

The CLI reads the amount and currency from the payment challenge and creates the spend request for you. The --context explains the purchase in Link’s approval screen and must be at least 100 characters. Open the approval URL returned by the CLI and review the amount before approving. Follow the CLI’s continuation instructions to finish the request. After approval, Link CLI retrieves a one-time Shared Payment Token and sends it to Browserbase in an MPP payment credential. When calling the CLI from an agent, invoke the returned _next.pay_argv command and argument array directly. Set its JSON header to Content-Type: application/json, preserving capitalization, and keep the original --approved-challenge, method, and body. See Stripe’s Link CLI guide for details. After a successful payment, Browserbase returns session details including:

{
  "sessionId": "<session-id>",
  "connectUrl": "wss://connect.browserbase.com/...",
  "paidMinutes": 250,
  "expiresAt": "<expiration-timestamp>",
  "pricing": {
    "ratePerHour": 0.12,
    "amountPaid": 0.5,
    "currency": "USD"
  }
}

Keep the sessionId for status checks and the connectUrl for browser access. Treat the connection URL as a credential: anyone with it can connect while the session is active.

Connect to the session

Set BROWSERBASE_CONNECT_URL in your environment to the connectUrl from the response. Choose a browser library, install it, and save its example as browser.mjs.

Stagehand
Playwright
Puppeteer

Stagehand runs in your Node.js process and connects to the paid browser session over CDP.

npm install @browserbasehq/stagehand@3

Node.js

import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "LOCAL",
  localBrowserLaunchOptions: {
    cdpUrl: process.env.BROWSERBASE_CONNECT_URL,
  },
});

await stagehand.init();

try {
  const page =
    stagehand.context.pages()[0] ?? (await stagehand.context.newPage());
  await page.goto("https://example.com");
  console.log(await page.title());
} finally {
  await stagehand.close();
}

npm install playwright-core

Node.js

import { chromium } from "playwright-core";

const browser = await chromium.connectOverCDP(
  process.env.BROWSERBASE_CONNECT_URL,
);

try {
  const context = browser.contexts()[0];
  const page = context.pages()[0] ?? (await context.newPage());
  await page.goto("https://example.com");
  console.log(await page.title());
} finally {
  await browser.close();
}

npm install puppeteer-core

Node.js

import puppeteer from "puppeteer-core";

const browser = await puppeteer.connect({
  browserWSEndpoint: process.env.BROWSERBASE_CONNECT_URL,
});

try {
  const pages = await browser.pages();
  const page = pages[0] ?? (await browser.newPage());
  await page.goto("https://example.com");
  console.log(await page.title());
} finally {
  await browser.disconnect();
}

Run the example:

node browser.mjs

Expected output

The script prints Example Domain.

Manage the session

Set SESSION_ID to the returned sessionId. You can check the remaining browser time without another payment:

cURL

curl "https://mpp.browserbase.com/browser/session/$SESSION_ID/status"

Cleanup

When you’re finished, terminate the session:

cURL

curl -X DELETE "https://mpp.browserbase.com/browser/session/$SESSION_ID"

MPP overview

Review pricing, prerequisites, and how the payment flow works.

x402 quickstart

Create browser sessions using x402 payments.

Integrations

Connect your Link account

Inspect the payment challenge

Pay with Link

Connect to the session

Expected output

Manage the session

Cleanup

Further reading

MPP overview

x402 quickstart

​Connect your Link account

​Inspect the payment challenge

​Pay with Link

​Connect to the session

​Expected output

​Manage the session

​Cleanup

​Further reading

MPP overview

x402 quickstart

Connect your Link account

Inspect the payment challenge

Pay with Link

Connect to the session

Expected output

Manage the session

Cleanup

Further reading