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

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

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

• 🚀 Deploy and manage applications in the cloud
• 🌐 Launch and control headless Chromium sessions for web automation
• 📊 Monitor deployments and track invocations
• 🔍 Search Kernel documentation and inject context
• 💻 Evaluate JavaScript and stream DOM snapshots

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.

• Kernel Account: Sign up at onkernel.com

The easiest way to get started is using our hosted service at https://mcp.onkernel.com/mcp. No installation or deployment required!

Team & Enterprise (Claude.ai):

1. Go to Settings → Integrations → Add more
2. Fill in:
   • Integration name: Kernel
   • Integration URL: https://mcp.onkernel.com/mcp
3. Start a chat, enable Tools, and finish auth

Free & Pro (Claude Desktop): Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restart Claude Desktop.

Claude Code CLI:

claude mcp add --transport http kernel https://mcp.onkernel.com/mcp
/mcp   # run inside a REPL to start auth

Install via Cursor → MCP tools, or click to install in Cursor.

Alternatively, run:

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

Install via Goose → MCP tools, or click to install in Goose.

Alternatively, run:

goose mcp add kernel https://mcp.onkernel.com/mcp

In settings.json:

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

Use ⌘/Ctrl+P → MCP: Add Server → Command (stdio), paste the command, name it Kernel, and start via MCP: List Servers.

1. ⌘/Ctrl , → Cascade → MCP servers → Add custom server
2. Paste:

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

In settings.json:

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

Most modern MCP-capable tools accept:

• Command: npx
• Arguments: -y mcp-remote https://mcp.onkernel.com/mcp
• Environment: (none)

The server provides these tools for AI assistants:

• list_apps - List applications in your Kernel workspace
• invoke_action - Execute actions in Kernel applications
• get_deployment - Get deployment status and logs
• list_deployments - List all deployments
• get_invocation - Get action invocation details

• create_browser - Launch a new browser session
• get_browser - Get browser session information
• delete_browser - Terminate a browser session
• list_browsers - List active browser sessions

• search_docs - Search Kernel platform documentation and guides

Human: List my Kernel applications
Assistant: I'll check your Kernel applications for you.
[Uses list_apps tool]

Human: Create a browser session and navigate to example.com
Assistant: I'll create a browser session for you and navigate to example.com.
[Uses create_browser and browser automation tools]

Human: Check the status of my latest deployment
Assistant: Let me check your recent deployments and their status.
[Uses list_deployments and get_deployment tools]

Is the server open source? Yes — the code lives at github.com/onkernel/kernel-mcp-server. You're welcome to browse the code and contribute. We provide a hosted instance at https://mcp.onkernel.com/mcp for convenience.

Does Kernel store my data? Only encrypted refresh tokens and minimal metadata required for auth; browser state lives in your Kernel workspace and never leaves your tenancy.

What scopes are requested? browser.session, dom.read, and js.eval by default. You can narrow scopes in your client during OAuth.

What if the handshake fails? Restart your MCP client or disable/re-enable the Kernel server before opening a support ticket. Most connection issues resolve with a simple restart.

We welcome contributions! Please see our contributing guidelines:

1. Fork the repository and create your feature branch
2. Make your changes and add tests if applicable
3. Run the linter and formatter:

   npm run lint
   npm run format

4. Test your changes thoroughly
5. Submit a pull request with a clear description

• Follow the existing code style and formatting
• Add TypeScript types for new functions and components
• Update documentation for any API changes
• Ensure all tests pass before submitting

This project is licensed under the MIT License - see the LICENSE file for details.

• Model Context Protocol - The protocol specification
• Kernel Platform - The platform this server integrates with
• Clerk - Authentication provider
• @onkernel/sdk - Kernel JavaScript SDK

• Issues & Bugs: GitHub Issues
• MCP Feedback: github.com/kernelxyz/mcp-feedback
• Documentation: Kernel Docs • MCP Setup Guide
• Community: Kernel Discord

Built with ❤️ by the Kernel Team