How do I use @businessmaps/mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@businessmaps/mcp get the text I have currently selected in the browser" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@businessmaps/bifrost

npm

MCP server that lets AI tools call functions running in your browser.

The daemon sits between any MCP client and your browser tab. It speaks JSON-RPC over stdio on one side and WebSocket on the other. Your browser app connects, registers tools, and the AI can call them.

Quick start

1. Add to your AI tool

Claude Code:

claude mcp add --transport stdio bifrost -- npx @businessmaps/bifrost --no-auth

Claude Desktop - add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bifrost": {
      "command": "npx",
      "args": ["@businessmaps/bifrost", "--no-auth"]
    }
  }
}

Cursor - add to .cursor/mcp.json:

{
  "mcpServers": {
    "bifrost": {
      "command": "npx",
      "args": ["@businessmaps/bifrost", "--no-auth"]
    }
  }
}

No install needed. npx downloads and runs the package automatically.

2. Add the client to your browser app

npm i @businessmaps/bifrost-browser

Or via CDN:

<script src="https://unpkg.com/@businessmaps/bifrost-browser"></script>

TypeScript types are included.

3. Register tools

import { BifrostBrowser } from "@businessmaps/bifrost-browser";

const bridge = new BifrostBrowser({ port: 3099 });

bridge.registerTools([
  {
    name: "get_page_title",
    description: "Returns the page title",
    inputSchema: { type: "object", properties: {} },
    handler: async () => document.title,
  },
  {
    name: "get_selection",
    description: "Returns the user's current text selection",
    inputSchema: { type: "object", properties: {} },
    handler: async () => window.getSelection().toString(),
  },
]);

bridge.connect();

That's it. The AI can now call get_page_title and get_selection in your browser tab. Handlers have full access to DOM, Canvas, IndexedDB, Clipboard, fetch, etc.

Auth

By default the daemon generates a random token on startup. Two ways to get it:

Terminal mode - the token prints to screen when the daemon starts
MCP mode - the AI calls the built-in bifrost_connection_info tool to get the token, then tells you what to paste into your app

Pass the token to the client:

const bridge = new BifrostBrowser({ port: 3099, token: "TOKEN" });

Skip auth entirely with --no-auth during local development.

Multiple tabs

Each tab registers its own tools. Calls route to whoever owns the tool. Disconnecting a tab removes its tools.

Options

--port <port>     WebSocket port        (default: 3099)
--timeout <secs>  Tool call timeout     (default: 120)
--no-auth         Disable token auth    (dev only)
--help, -h        Show this message
--version, -v     Show version

Dev

git clone https://github.com/Business-Maps/bifrost.git && cd bifrost
npm install
npm test

Architecture · Client API · Contributing

License

Apache 2.0

Install Server

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

@businessmaps/mcp