Solamar MCP server
Commit Nov 5, 2026An open-source browser that allows AI agents like Claude Code to open tabs, read pages, click, and type through an MCP server.
Also known as Bambeek/solamar
- Stars
- 7
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 5, 2026
- License
- GPL-3.0
What is Solamar MCP?
Solamar is an open-source browser that allows AI agents like Claude Code to open tabs, read pages, click, and type through an MCP server.
Summary generated from the project's README
About Solamar MCP server
Automating web navigation and data extraction through Claude Code is what Solamar enables. This open-source browser provides an MCP server that allows AI agents to open tabs, read page content, click elements, and type text directly within a browser environment. It is designed for developers who want to give their AI agents a functional interface to interact with the web on their local machine.
Users set up the connection by running a specific command in their terminal to add the server to Claude Code. The MCP server runs locally on 127.0.0.1 and is protected by a secret token. While the browser supports local models via Ollama, it can also connect to Claude using an Anthropic API key stored in the system keychain. The agent operates within its own Claude space or in tabs that the user explicitly shares with it, ensuring privacy and control over which pages the AI can see.
What you can do with it
- 1Automate web form completionYou can instruct an AI agent to fill out complex web forms on your behalf.
- 2Extract data from web pagesAn AI client can be tasked with gathering specific information like addresses from a website.
- 3Control a browser via terminalDevelopers can use Claude Code to drive browser actions like opening tabs and clicking.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebambeek/solamar is public and reachablegithub.com/bambeek/solamar ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-05github.com/bambeek/solamar ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubThe Browser Company ends Arc on December 22, 2026. Solamar keeps what Arc got right, like spaces, a vertical sidebar, pinned tabs and folders, and brings your Arc sidebar over in one click. It also has an ad blocker built in, and an AI agent that stays off until you switch it on. Solamar is free and open source. There is no account and no telemetry.
Moving out of Arc
- Arc spaces, one click. Solamar reads the sidebar file Arc keeps on your computer, without changing it. It brings over your spaces with their colours and icons, your pinned tabs and your folders. Nothing is uploaded.
- Or from another browser. It brings in bookmarks and history from the other browsers on your computer in one click. Passwords come in from the CSV file a browser or password manager exports.
- Your layout. Keep Arc's vertical sidebar, or switch to a top bar. Every tab shows its title and its own close button.
What's inside
AI, only if you want it
AI is off until you switch it on. Then you pick what runs each feature:
- a local model through Ollama, so nothing leaves your computer;
- or Claude, on your own Anthropic API key, which Solamar keeps in your system's keychain.
- Do it for me. Tell the agent what to do on the page you are looking at, like filling in a form or collecting every address on a page. It shows each step, and you can stop it any time. It always waits for your click before it pays for anything. Settings > Claude Code > "How much it does on its own" makes it wait before sending, submitting or deleting too. It cannot type into password, card or one-time-code fields.
- Draft a reply. In a mail or chat box, press
Ctrl+Shift+Space. It writes the reply in your voice and leaves it for you to send. - Ask about a page. Press
Ctrl+Jto get the gist of a long page or ask a question about it. - Better search. Press Tab in the command bar for a sharper search, or ask a question and get the answer in the bar.
- Tidy tabs. It suggests groups for today's tabs. Nothing moves until you apply them.
Drive it from Claude Code
Turn on Settings > Claude Code and Solamar starts an MCP server that only this computer can reach. The settings page
shows a claude mcp add line to run once in a terminal. Claude Code can then open tabs, read pages, click and type.
It works in its own Claude space, or in tabs you share with it ("Share with Claude Code"). It follows the same rules as
Solamar's own agent: payments wait for your click, and it never types passwords or card numbers. A pill in the top bar
shows when it is working, and you can stop it from there.
A browser, not a service
- No account. There is nothing to create and nothing to sign in to.
- No sync server. Your tabs never pass through a server of ours.
- No telemetry. Solamar has no analytics and no usage tracking.
- Your data stays on your computer. Spaces, tabs and settings are one JSON file in the app data folder. Passwords and your API key are encrypted with your system's keychain. Imports only read your other browsers' files, and private spaces write nothing to disk.
Installing
The installers are not code-signed yet:
- Windows may show "Windows protected your PC". Click More info, then Run anyway.
- On a Mac, open Solamar once, then go to System Settings > Privacy & Security and click Open Anyway.
The Windows app updates itself from GitHub Releases. The Mac app tells you when a new version is out.
Engine and security updates
Solamar is built on castLabs' Electron 44.9.3: Electron with Google's Widevine module added, for DRM video. Services that demand a production signature, like Netflix, do not play in released builds yet. It bundles Chromium 152.0.7977.167 and Node.js 24.22.0. Pages are rendered, sandboxed and isolated by Chromium itself; Solamar adds its own interface around it, not its own engine.
- Security fixes: Electron ships Chromium's security fixes in patch releases of each supported line, and castLabs follows within days. When one comes out, Solamar moves to it and makes a release within a week.
- New engine versions: Electron puts out a new major version, with a newer Chromium, about every eight weeks and supports the latest three. Solamar moves to each new major within a month of castLabs releasing it, so it is always on a supported line.
- Dangerous sites: Electron leaves out Chrome's Safe Browsing. Solamar stops known phishing and malware pages itself, from lists refreshed every 12 hours; the lists come down to your computer, nothing about what you browse goes up.
- Getting them: the Windows app installs updates itself. The Mac app shows a notice with a download link until it is notarized; once it is, it will update itself too.
A daily workflow (.github/workflows/electron.yml) checks castLabs' releases and opens a pull request for each new one.
Building from source
Solamar is built with Electron, React and TypeScript.
npm install
npm run dev
To run the production build, use npm run build and then npm start.
Tests
npm test
npm run typecheck
The end-to-end tests run after npm run build. They use a hidden window and a throwaway profile, and make no real
API calls:
node tests/e2e/smoke.mjs <tmp-profile-dir> <screenshot-dir>covers browsing, spaces, Arc import, and local AI against a mock Ollama.node tests/e2e/agent.mjs <tmp-profile-dir> <screenshot-dir>covers the Claude engine against a mock API, and the MCP server driven by the official MCP client.
Layout
src/main: the window and tab views (browser.ts), storage, ad blocking, AI, the MCP server (agent.ts) and the importers.arc-parse.tsis pure and tested.src/preload: the bridge for Solamar's own pages only. Web pages get no preload.src/renderer: the frame (sidebar, AI panel) and the overlay (command bar, dialogs).site/: the website at solamar.app.MODLOG.md: Arc's on-disk format, for the importer.
Releasing
- Bump
versionin package.json and commit. - Tag the commit and push the tag:
git tag v0.1.1 && git push origin v0.1.1. - CI (
.github/workflows/build.yml) builds the Windows installer and both Mac disk images, tests the packaged apps, and uploads everything to a draft release. - Publish the draft. The apps' updater and the website only see published releases.
Contributing
Issues and pull requests are welcome. If you are moving from Arc, the most useful thing you can tell us is which Arc feature you miss.
License
Solamar is licensed under GPL-3.0-or-later (see LICENSE). Chrome extension support comes from electron-chrome-extensions, used under its GPL-3.0 option.
Solamar MCP questions
How do I connect Claude Code to Solamar?
You can connect by running the specific 'claude mcp add solamar' command provided in the Solamar settings page.
Can the AI agent handle sensitive information like passwords?
No, the agent is restricted from typing into password, credit card, or one-time-code fields.