Kernel MCP Server

Access Kernel's cloud-based browsers and app actions via MCP (remote HTTP + OAuth).

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kernel-mcp-server": {
      "url": "https://mcp.onkernel.com/mcp"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (29)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Kernel MCP Server.

manage_browsers

Create, update, list, get, and delete browser sessions, and read archived telemetry for active or deleted sessions. Supports headless/stealth modes, profiles, proxies, viewports, extensions, names and tags, and SSH tunneling. The browser tools (`manage_browsers`, `computer_action`, `execute_playwri…

manage_profiles

Setup (with guided live browser session), search/list with pagination, get, and delete browser profiles for persisting cookies and logins.

manage_projects

Create, list, get, update, and delete organization projects. Inspect and update per-project resource limits.

manage_api_keys

Create, list, get, update, and delete org-wide or project-scoped API keys. Create returns the plaintext key once.

manage_browser_pools

Create, list, get, delete, and flush pools of pre-warmed browsers. Acquire and release browsers from pools.

manage_config_registry

Look up current browser and proxy recommendations, start and inspect analyses, request cancellation, and list project configurations or analysis history.

Documentation Overview

Kernel MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with secure access to Kernel platform tools and browser automation capabilities.

Architecture Overview

🌐 Use instantly at https://mcp.onkernel.com/mcp — no installation required!

What is this?

The Kernel MCP Server bridges AI assistants (like Claude, Cursor, fx, or other MCP-compatible tools) with the Kernel platform, enabling them to:

🚀 Deploy and manage Kernel apps in the cloud
🌐 Launch and control headless Chromium sessions for web automation
📊 Monitor deployments and track invocations
🔍 Search Kernel documentation and inject context
💻 Execute arbitrary Playwright code against live browsers
🧠 Run persistent JavaScript Browser REPL cells with native helpers, Patchright, Playwright, and raw CDP
🎥 Record MP4 video replays of browser automation

Open-source & fully-managed — the complete codebase is available here, and we run the production instance so you don't need to deploy anything.

The server uses OAuth 2.0 authentication via Clerk to ensure secure access to your Kernel resources. During authorization, users can grant organization-wide access or restrict the resulting access and refresh tokens to one Kernel project. Project-scoped tokens cannot switch projects; organization-wide authorization remains available for existing workflows.

For a deeper dive into why and how we built this server, see our blog post: Introducing Kernel MCP Server.

Setup Instructions

General (Transports)

Streamable HTTP (recommended): https://mcp.onkernel.com/mcp
stdio via mcp-remote (for clients without remote MCP support): npx -y mcp-remote https://mcp.onkernel.com/mcp

Use the streamable HTTP endpoint where supported for increased reliability. If your client does not support remote MCP, use mcp-remote over stdio.

Kernel's server is a centrally hosted, authenticated remote MCP using OAuth 2.1 with dynamic client registration.

Protocol compatibility

The same /mcp endpoint serves SDK v1 / 2025-era Streamable HTTP clients and protocol revision 2026-07-28 clients through the SDK v2 stateless handler. Legacy clients still initialize normally. Modern clients use per-request metadata and do not initialize or receive an MCP session ID. Both use the same tools and authentication checks; MCP Apps capabilities are read per request for modern clients.

Legacy clients should handle both JSON-RPC errors and isError tool results. Unknown tools now produce JSON-RPC error -32602; ordinary tool failures still return isError. Validation-error text and generated tool schemas can differ from SDK v1. No byte-preserving compatibility layer or Tasks extension is installed.

Run bun test 'src/app/[transport]/dual-era.test.ts' to exercise both SDK client generations over HTTP, including OAuth authorization and refresh with local upstream service fixtures. The v1 SDK is retained only as a test dependency.

Quick Setup with Kernel CLI

The fastest way to configure the MCP server is using the Kernel CLI:

bash

# Install the CLI
brew install onkernel/tap/kernel
# or: npm install -g @onkernel/cli

# Install MCP for your tool
kernel mcp install --target <target>

Supported Targets

Target	Command
Cursor	`kernel mcp install --target cursor`
Claude Desktop	`kernel mcp install --target claude`
Claude Code	`kernel mcp install --target claude-code`
VS Code	`kernel mcp install --target vscode`
Windsurf	`kernel mcp install --target windsurf`
Zed	`kernel mcp install --target zed`
Goose	`kernel mcp install --target goose`
fx	`kernel mcp install --target fx`

The CLI automatically locates your tool's config file and adds the Kernel MCP server configuration.

Connect in your client

Claude

Our remote MCP server is not compatible with the method Free users of Claude use to add MCP servers.

Pro, Max, Team & Enterprise (Claude.ai and Claude Desktop)

Go to Settings → Connectors → Add custom connector.
Enter: Integration name: Kernel, Integration URL: https://mcp.onkernel.com/mcp, then click Add.
In Settings → Connectors, click Connect next to Kernel to launch OAuth and approve.
In chat, click Search and tools and enable the Kernel tools if needed.

On Claude for Work (Team/Enterprise), only Primary Owners or Owners can enable custom connectors for the org. After it's configured, each user still needs to go to Settings → Connectors and click Connect to authorize it for their account.

Claude Code CLI

Terminal

claude mcp add --transport http kernel https://mcp.onkernel.com/mcp
# Then in the REPL run once to authenticate:
/mcp

Cursor

Automatic setup

Manual setup

Press ⌘/Ctrl Shift J.
Go to MCP & Integrations → New MCP server.
Add this configuration:

config.json

{
  "mcpServers": {
    "kernel": {
      "url": "https://mcp.onkernel.com/mcp"
    }
  }
}

Save. The server will appear in Tools.

OpenCode

Add the following to your ~/.config/opencode/opencode.jsonc:

JSON Config

{
  "mcp": {
    "kernel": {
      "type": "remote",
      "url": "https://mcp.onkernel.com/mcp",
    },
  },
}

Then authenticate using the OpenCode CLI:

bash

# Authenticate with Kernel
opencode mcp auth kernel

# If you need to re-authenticate, first logout then auth again
opencode mcp logout kernel
opencode mcp auth kernel

fx

Configure Kernel with the Kernel CLI:

bash

kernel mcp install --target fx

Or add Kernel to the mcp map in ~/.fx/mcp.json manually:

config.json

{
  "mcp": {
    "kernel": {
      "type": "http",
      "url": "https://mcp.onkernel.com/mcp",
      "oauth": {}
    }
  }
}

Start fx, or reload the configuration in an existing session:

text

/mcp reload

Then authenticate with Kernel:

text

/mcp auth kernel --open

Authorize access in the browser window that opens. Run /mcp list to verify that Kernel is connected.

Goose

Click here to install Kernel on Goose in one click.

Goose Desktop

Click Extensions in the sidebar of the Goose Desktop.
Click Add custom extension.
On the Add custom extension modal, enter:
- Extension Name: Kernel
- Type: STDIO
- Description: Access Kernel's cloud-based browsers via MCP
- Command: npx -y mcp-remote https://mcp.onkernel.com/mcp
- Timeout: 300
Click Save Changes button.

Goose CLI

Run the following command:
bash
```
goose configure
```
Select Add Extension from the menu.
Choose Command-line Extension.
Follow the prompts:
- Extension name: Kernel
- Command: npx -y mcp-remote https://mcp.onkernel.com/mcp
- Timeout: 300
- Description: Access Kernel's cloud-based browsers via MCP

Visual Studio Code

config.json

{
  "mcpServers": {
    "kernel": {
      "url": "https://mcp.onkernel.com/mcp",
      "type": "http"
    }
  }
}

Press ⌘/Ctrl P → search MCP: Add Server.
Select HTTP (HTTP or Server-Sent Events).
Enter: https://mcp.onkernel.com/mcp
Name the server Kernel → Enter.

Windsurf

Press ⌘/Ctrl , to open settings.
Navigate Cascade → MCP servers → View raw config.
Paste:

config.json

{
  "mcpServers": {
    "kernel": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
    }
  }
}

On Manage MCPs, click Refresh to load Kernel MCP.

Zed

Press ⌘/Ctrl , to open settings.
Paste:

config.json

{
  "context_servers": {
    "kernel": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
    }
  }
}

Smithery

You can connect directly to https://mcp.onkernel.com/mcp, or use Smithery as a proxy using its provided URL.

Use Smithery URL in any MCP client:
1. Open Smithery: Kernel.
2. Copy the URL from "Get connection URL".
3. Paste it into your MCP client's "Add server" flow.
Use Kernel in Smithery's Playground MCP client:
1. Open Smithery Playground.
2. Click "Add servers", search for "Kernel", and add it.
3. Sign in and authorize Kernel when prompted.

Others

Many other MCP-capable tools accept:

Command: npx
Arguments: -y mcp-remote https://mcp.onkernel.com/mcp

config.json

{
  "kernel": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
  }
}

Configure these values wherever the tool expects MCP server settings.

Tools

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

Package downloads in the last 30 days.

Last commit

4d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Kernel MCP Server

kernel-mcp-server is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "kernel-mcp-server": { "url": "https://mcp.onkernel.com/mcp" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Kernel MCP Server AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kernel-mcp-server?style=directory)](https://allmcps.com/mcp/kernel-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/kernel-mcp-server"><img src="https://allmcps.com/api/badge/kernel-mcp-server?style=directory" alt="Kernel MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

11/15 checks healthy over the last 46d

57Quality signal: Good · 57/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership7/20

Documentation & tools25/30

Adoption & activity11/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

1 high-severity advisory on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 1High 0Medium 0Low 0

Scanned 25d ago via OSV.dev · https://mcp.onkernel.com/mcp (npm)

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Kernel MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Kernel MCP Server

Access Kernel's cloud-based browsers and app actions via MCP (remote HTTP + OAuth).

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kernel-mcp-server": {
      "url": "https://mcp.onkernel.com/mcp"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (29)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Kernel MCP Server.

manage_browsers

manage_profiles

Setup (with guided live browser session), search/list with pagination, get, and delete browser profiles for persisting cookies and logins.

manage_projects

Create, list, get, update, and delete organization projects. Inspect and update per-project resource limits.

manage_api_keys

Create, list, get, update, and delete org-wide or project-scoped API keys. Create returns the plaintext key once.

manage_browser_pools

Create, list, get, delete, and flush pools of pre-warmed browsers. Acquire and release browsers from pools.

manage_config_registry

Look up current browser and proxy recommendations, start and inspect analyses, request cancellation, and list project configurations or analysis history.

Documentation Overview

Kernel MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with secure access to Kernel platform tools and browser automation capabilities.

Architecture Overview

🌐 Use instantly at https://mcp.onkernel.com/mcp — no installation required!

What is this?

The Kernel MCP Server bridges AI assistants (like Claude, Cursor, fx, or other MCP-compatible tools) with the Kernel platform, enabling them to:

🚀 Deploy and manage Kernel apps in the cloud
🌐 Launch and control headless Chromium sessions for web automation
📊 Monitor deployments and track invocations
🔍 Search Kernel documentation and inject context
💻 Execute arbitrary Playwright code against live browsers
🧠 Run persistent JavaScript Browser REPL cells with native helpers, Patchright, Playwright, and raw CDP
🎥 Record MP4 video replays of browser automation

Open-source & fully-managed — the complete codebase is available here, and we run the production instance so you don't need to deploy anything.

For a deeper dive into why and how we built this server, see our blog post: Introducing Kernel MCP Server.

Setup Instructions

General (Transports)

Streamable HTTP (recommended): https://mcp.onkernel.com/mcp
stdio via mcp-remote (for clients without remote MCP support): npx -y mcp-remote https://mcp.onkernel.com/mcp

Use the streamable HTTP endpoint where supported for increased reliability. If your client does not support remote MCP, use mcp-remote over stdio.

Kernel's server is a centrally hosted, authenticated remote MCP using OAuth 2.1 with dynamic client registration.

Protocol compatibility

Quick Setup with Kernel CLI

The fastest way to configure the MCP server is using the Kernel CLI:

bash

# Install the CLI
brew install onkernel/tap/kernel
# or: npm install -g @onkernel/cli

# Install MCP for your tool
kernel mcp install --target <target>

Supported Targets

Target	Command
Cursor	`kernel mcp install --target cursor`
Claude Desktop	`kernel mcp install --target claude`
Claude Code	`kernel mcp install --target claude-code`
VS Code	`kernel mcp install --target vscode`
Windsurf	`kernel mcp install --target windsurf`
Zed	`kernel mcp install --target zed`
Goose	`kernel mcp install --target goose`
fx	`kernel mcp install --target fx`

The CLI automatically locates your tool's config file and adds the Kernel MCP server configuration.

Connect in your client

Claude

Our remote MCP server is not compatible with the method Free users of Claude use to add MCP servers.

Pro, Max, Team & Enterprise (Claude.ai and Claude Desktop)

Go to Settings → Connectors → Add custom connector.
Enter: Integration name: Kernel, Integration URL: https://mcp.onkernel.com/mcp, then click Add.
In Settings → Connectors, click Connect next to Kernel to launch OAuth and approve.
In chat, click Search and tools and enable the Kernel tools if needed.

On Claude for Work (Team/Enterprise), only Primary Owners or Owners can enable custom connectors for the org. After it's configured, each user still needs to go to Settings → Connectors and click Connect to authorize it for their account.

Claude Code CLI

Terminal

claude mcp add --transport http kernel https://mcp.onkernel.com/mcp
# Then in the REPL run once to authenticate:
/mcp

Cursor

Automatic setup

Manual setup

Press ⌘/Ctrl Shift J.
Go to MCP & Integrations → New MCP server.
Add this configuration:

config.json

{
  "mcpServers": {
    "kernel": {
      "url": "https://mcp.onkernel.com/mcp"
    }
  }
}

Save. The server will appear in Tools.

OpenCode

Add the following to your ~/.config/opencode/opencode.jsonc:

JSON Config

{
  "mcp": {
    "kernel": {
      "type": "remote",
      "url": "https://mcp.onkernel.com/mcp",
    },
  },
}

Then authenticate using the OpenCode CLI:

bash

# Authenticate with Kernel
opencode mcp auth kernel

# If you need to re-authenticate, first logout then auth again
opencode mcp logout kernel
opencode mcp auth kernel

fx

Configure Kernel with the Kernel CLI:

bash

kernel mcp install --target fx

Or add Kernel to the mcp map in ~/.fx/mcp.json manually:

config.json

{
  "mcp": {
    "kernel": {
      "type": "http",
      "url": "https://mcp.onkernel.com/mcp",
      "oauth": {}
    }
  }
}

Start fx, or reload the configuration in an existing session:

text

/mcp reload

Then authenticate with Kernel:

text

/mcp auth kernel --open

Authorize access in the browser window that opens. Run /mcp list to verify that Kernel is connected.

Goose

Click here to install Kernel on Goose in one click.

Goose Desktop

Click Extensions in the sidebar of the Goose Desktop.
Click Add custom extension.
On the Add custom extension modal, enter:
- Extension Name: Kernel
- Type: STDIO
- Description: Access Kernel's cloud-based browsers via MCP
- Command: npx -y mcp-remote https://mcp.onkernel.com/mcp
- Timeout: 300
Click Save Changes button.

Goose CLI

Run the following command:
bash
```
goose configure
```
Select Add Extension from the menu.
Choose Command-line Extension.
Follow the prompts:
- Extension name: Kernel
- Command: npx -y mcp-remote https://mcp.onkernel.com/mcp
- Timeout: 300
- Description: Access Kernel's cloud-based browsers via MCP

Visual Studio Code

config.json

{
  "mcpServers": {
    "kernel": {
      "url": "https://mcp.onkernel.com/mcp",
      "type": "http"
    }
  }
}

Press ⌘/Ctrl P → search MCP: Add Server.
Select HTTP (HTTP or Server-Sent Events).
Enter: https://mcp.onkernel.com/mcp
Name the server Kernel → Enter.

Windsurf

Press ⌘/Ctrl , to open settings.
Navigate Cascade → MCP servers → View raw config.
Paste:

config.json

{
  "mcpServers": {
    "kernel": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
    }
  }
}

On Manage MCPs, click Refresh to load Kernel MCP.

Zed

Press ⌘/Ctrl , to open settings.
Paste:

config.json

{
  "context_servers": {
    "kernel": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
    }
  }
}

Smithery

You can connect directly to https://mcp.onkernel.com/mcp, or use Smithery as a proxy using its provided URL.

Use Smithery URL in any MCP client:
1. Open Smithery: Kernel.
2. Copy the URL from "Get connection URL".
3. Paste it into your MCP client's "Add server" flow.
Use Kernel in Smithery's Playground MCP client:
1. Open Smithery Playground.
2. Click "Add servers", search for "Kernel", and add it.
3. Sign in and authorize Kernel when prompted.

Others

Many other MCP-capable tools accept:

Command: npx
Arguments: -y mcp-remote https://mcp.onkernel.com/mcp

config.json

{
  "kernel": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
  }
}

Configure these values wherever the tool expects MCP server settings.

Tools

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

Package downloads in the last 30 days.

Last commit

4d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Kernel MCP Server

kernel-mcp-server is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "kernel-mcp-server": { "url": "https://mcp.onkernel.com/mcp" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kernel-mcp-server?style=directory)](https://allmcps.com/mcp/kernel-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/kernel-mcp-server"><img src="https://allmcps.com/api/badge/kernel-mcp-server?style=directory" alt="Kernel MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

11/15 checks healthy over the last 46d

57Quality signal: Good · 57/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership7/20

Documentation & tools25/30

Adoption & activity11/15

Community engagement0/10

Supply-chain signal

Critical 1High 0Medium 0Low 0

Scanned 25d ago via OSV.dev · https://mcp.onkernel.com/mcp (npm)

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.