How to integrate Browserbase tool MCP with Kimi Code

Connect Kimi Code to Browserbase tool MCP. Start a new headless browser session now, download all artifacts from last session, and more using natural language, with authentication handled for you.

Browserbase tool logoBrowserbase tool
Api Key

Browserbase is a serverless platform for running and managing headless browsers at scale. It lets you automate and monitor browser tasks with Playwright, Puppeteer, and Selenium—no infrastructure headaches.

64 Tools

How to integrate Browserbase tool MCP with Kimi Code

Kimi Code is Moonshot AI's open-source coding agent, powered by Kimi K2.6. It runs in your terminal, reads and edits code, executes shell commands, and plans multi-step tasks, with native MCP support for extending it to outside tools.

In this guide, I will explain the easiest and most secure way to connect your Browserbase tool account to Kimi Code via Composio Connect, so it can start a new headless browser session now, download all artifacts from last session, retrieve debug URLs for active sessions, and more without ever putting your account credentials at risk.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Browserbase tool with

Why use Composio?

Composio provides:

  • Access to 1,700+ managed apps from a single MCP endpoint. This makes it convenient for agents to run cross-app workflows.
  • Managed OAuth. You do not have to worry about authentication and authorization flows for every app.
  • Programmatic tool calling. Allows LLMs to write code in a remote workbench to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Large tool response handling outside the LLM context. This minimizes context bloat from large tool responses.
  • Dynamic just-in-time access to thousands of tools across hundreds of apps. Composio loads the tools your agent needs, so LLMs are not overwhelmed by tools they do not need.

Connect Browserbase tool to Kimi Code

Kimi Code is a TypeScript agent distributed through npm. It acts as an MCP client and reads server definitions from an mcp.json file, and it can also add and authenticate servers conversationally through /mcp-config. Composio is a remote HTTP server that authenticates with OAuth, so no API key is stored anywhere.

1. Install Kimi Code

The quickest way is the official install script, which requires no pre-installed Node.js and places the kimi executable on your PATH.

bash
# macOS or Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# Confirm the installation
kimi --version

2. Log in

Start Kimi Code in your project directory, then sign in from the interactive UI:

bash
kimi

Run /login and choose Kimi Code OAuth using the device-code flow, or use a Moonshot API key.

3. Add Composio with /mcp-config

In current versions of Kimi Code, MCP servers are managed inside the app, not with a shell subcommand. From the interactive UI, run:

bash
/mcp-config
Kimi Code MCP config flow for adding the Composio MCP server

Tell it the server name and URL in plain language. For example:

Server name is Composio, and here is the server URL: https://connect.composio.dev/mcp

Kimi Code asks whether to add it globally, at ~/.kimi-code/mcp.json, or project-local for the current checkout, then writes the entry for you:

bash
{
  "mcpServers": {
    "Composio": {
      "url": "https://connect.composio.dev/mcp"
    }
  }
}

There is no transport field to set. Kimi Code infers HTTP from the url.

4. Restart the session

The new server is picked up on a fresh session, not the current one. Start a new session:

bash
/new

On the new session, Kimi Code detects that the server needs authorization and prompts you to run:

bash
/mcp-config login Composio

5. Authorize with OAuth

Run the command Kimi suggests:

bash
/mcp-config login composio

Kimi Code opens Composio's authorization page or surfaces a URL. Approve access, then return to the session. You should see confirmation that the Composio MCP server is connected.

Composio authorization page for Kimi Code MCP setup

Check the connection status any time with /mcp. Composio should appear as connected with its tools listed.

Kimi Code showing Composio connected after OAuth authorization

Connect your Browserbase tool account

Back in a Kimi Code session, ask the agent to connect to Browserbase tool or give it any Browserbase tool-related task.

For example, ask it to:

  • "Start a new headless browser session now"
  • "Download all artifacts from last session"
  • "Retrieve debug URLs for active sessions"

It will prompt you to authenticate and authorize access to Browserbase tool.

That is it. Composio tools are now available in Kimi Code, and your Browserbase tool account is ready to use.

Conclusion

You have successfully connected Browserbase tool to Kimi Code using Composio Connect. Your agent can now manage Browserbase tool from the terminal with natural language, without exposing credentials in prompts or local scripts.

Since the same Composio endpoint exposes 1,700+ apps, you can add Slack, Calendar, Linear, and more to the same server and chain them into cross-app workflows.

TOOLS

Supported Tools

Every Browserbase tool action and event your agent gets out of the box.

Attach Browserbase Function Secret

Attach an existing project secret to a Function by UUID.

Update Browser Context

Tool to update a specific browser context.

Create Browserbase Agent

Create a reusable browser agent with a name and optional system prompt and result schema.

Create Browser Context

Create a reusable browser context; the API key can select the project.

Create Browser Session

Create an isolated Browserbase session and return its connection details.

Create Browserbase Webhook

Register a publicly reachable HTTPS endpoint for project event deliveries.

Delete Browserbase Agent

Delete a reusable browser agent by its agentId.

Delete a browser context

Tool to delete a browser context and all its stored data (cookies, localStorage, etc.).

Delete Download

Delete a download file from storage and mark it as deleted.

Delete a browser extension

Tool to delete an uploaded browser extension by its ID.

Delete Session Downloads

Tool to delete all file downloads from a specific browser session.

Delete Browserbase Webhook

Delete a webhook, immediately stopping deliveries and retiring its secret.

Detach Browserbase Function Secret

Detach a project secret from a Function by UUID.

Download Session Artifacts

Download a completed session's generated files as a ZIP archive.

Fetch Browserbase Page

Fetch a page and return its content, headers, and metadata.

Get Browserbase Agent

Retrieve a reusable browser agent by its agentId.

Get Certificate

Retrieve a Browserbase certificate by its ID.

Get Browser Context

Return metadata for a browser context by ID.

Get Download

Get a single download by ID as metadata or a downloadable file object.

Retrieve a browser extension

Tool to retrieve details of a specific browser extension.

Get Browserbase Function

Retrieve a Browserbase function by its ID.

Get Browserbase Function Build

Retrieve a Browserbase function build by its build ID.

Get Browserbase Function Build Logs

Retrieve Browserbase function build logs by the build ID.

Get Browserbase Function Version

Retrieve a Browserbase function version by its version ID.

Get Browserbase Invocation

Retrieve a Browserbase function invocation by its invocation ID.

Get Browserbase Invocation Logs

Retrieve Browserbase function invocation logs by the invocation ID.

Get Browserbase Keypair

Retrieve the project's public HPKE encryption key and keypair ID.

Get Browserbase Project

Return project metadata, default timeout, and assigned concurrency.

Get project usage statistics

Tool to retrieve usage statistics for a project including browser minutes and proxy bytes consumed.

Get Browserbase Agent Run

Retrieve a browser agent run's current status, result, and session details.

Get Browserbase Secret

Retrieve a project secret's ID and name by UUID, without its secret value.

Get Browser Session

Return status, connection details, and timestamps for a browser session.

Get Session Debug URLs

Return live debugger and WebSocket URLs for a running browser session.

Get Session Logs

Return network request and response events captured during a browser session.

Get Session Replay

Return HLS replay metadata and page playlist paths for a recorded session.

Get Session Replay Page

Return the HLS M3U8 playlist for one recorded replay page.

Get Browserbase Webhook

Retrieve a single webhook by ID, without its signing secret.

Invoke Browserbase Function

Invoke a deployed Browserbase function asynchronously.

List Browserbase Agents

List one page of reusable browser agents across your account.

List Certificates

List Browserbase certificates with their IDs, timestamps, and project IDs.

List Browserbase Downloads

List one page of download metadata for a required browser session.

List Browserbase Function Builds

List one page of Browserbase function builds, optionally filtered by status.

List Browserbase Functions

List one page of Browserbase functions and the total number available.

List Browserbase Function Secrets

List one page of secret IDs and names attached to a Browserbase function, optionally filtered by creation time.

List Browserbase Function Versions

List one page of versions for a Browserbase function by its UUID.

List Browserbase Projects

List projects with their default timeout and assigned concurrency.

List Recording Downloads

Poll per-page MP4 assembly after requesting recording downloads until every page is COMPLETED or FAILED.

List Browserbase Run Messages

List a page of a browser agent run's messages, oldest first, with assistant or tool roles and text or typed content parts.

List Browserbase Agent Runs

List a page of browser agent runs across your account.

List Browserbase Secrets

List one page of project secret IDs and names, optionally filtered by creation time.

List Browser Sessions

List browser sessions, optionally filtered by status or user metadata.

List Browserbase Function Version Invocations

List one page of invocations for a Browserbase function version by its UUID.

List Browserbase Webhooks

List one page of the project's webhooks, newest first, without signing secrets.

Release Browser Session

Irreversibly request release of a running browser session, ending it before its configured timeout to avoid further charges.

Request Recording Downloads

Start asynchronous MP4 assembly for every recorded page of a completed session, then poll List Recording Downloads until every page is COMPLETED or FAILED.

Resume Browserbase Agent Run

Resume only a PAUSED browser agent run with optional additional input.

Run Browserbase Agent

Start a browser agent run to complete a task using web search and browser tools.

Stop Browserbase Agent Run

Request that an in-progress browser agent run stop.

Update Browserbase Agent

Update a reusable browser agent's name, system prompt, or result schema.

Update Browserbase Webhook

Update a webhook's delivery URL, subscribed event types, or both.

Upload Browser Extension

Tool to upload a browser extension for use in sessions.

Upload Session File

Upload one file so browser interactions can select it in a file input field.

Upload Session Files

Upload multiple files to one browser session for file-input interactions.

Web Search

Perform a web search and return structured results.

FAQ

Frequently asked questions

Start with Browserbase tool.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Browserbase tool tool your agent needs.Free to start.

Start building