Commerce & RetailMCP Registrypypi3 toolsB · 67

Bowmark MCP server

Name: Bowmark
Author: bowmark.ai

ai.bowmark · Updated today

Web scraping and automation for AI agents: live prices, quotes, bookings, anything behind a login.

At a glance

Bowmark is an MCP server in the Commerce & Retail category. It runs locally over stdio via `uvx bowmark-mcp`, and needs BOWMARK_API_KEY and Authorization. It exposes 3 tools, including get_library, run and report. It scores B (67/100) on the MCP Skills Hub health score as of Oct 28, 2026.

Source 1

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install Bowmark in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install Bowmark in Claude CodeAnthropic's agentic CLI

Add the server

bash

claude mcp add bowmark -e 'BOWMARK_API_KEY=<BOWMARK_API_KEY>' -- uvx bowmark-mcp

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.
3
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. get_library, run, report). It discovers them automatically.

How to install Bowmark in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

{
  "mcpServers": {
    "bowmark": {
      "command": "uvx",
      "args": [
        "bowmark-mcp"
      ],
      "env": {
        "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
      }
    }
  }
}

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install Bowmark in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

{
  "mcpServers": {
    "bowmark": {
      "command": "uvx",
      "args": [
        "bowmark-mcp"
      ],
      "env": {
        "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
      }
    }
  }
}

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install Bowmark in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.bowmark]
command = "uvx"
args = ["bowmark-mcp"]
env = { BOWMARK_API_KEY = "<BOWMARK_API_KEY>" }

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install Bowmark in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "bowmark": {
      "command": "uvx",
      "args": [
        "bowmark-mcp"
      ],
      "env": {
        "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
      }
    }
  }
}

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install Bowmark in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

{
  "mcpServers": {
    "bowmark": {
      "command": "uvx",
      "args": [
        "bowmark-mcp"
      ],
      "env": {
        "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
      }
    }
  }
}

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

How to install Bowmark in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "servers": {
    "bowmark": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bowmark-mcp"
      ],
      "env": {
        "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
      }
    }
  }
}

Fill in your credentials
Replace <BOWMARK_API_KEY>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What does Bowmark need from you?

Bearer token — Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. Your first $10 of usage is free.

BOWMARK_API_KEYrequiredsecretEnvironment variable
Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. Your first $10 of usage is free.
BOWMARK_API_KEYrequiredsecretEnvironment variable
Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. Your first $10 of usage is free.
AuthorizationrequiredHTTP header
Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. Your first $10 of usage is free.

Pass secrets through your shell environment rather than committing them into a config file.

What tools does Bowmark expose? (3)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

get_libraryRead the typed function library for a task or a site. Read-only, touches no site, and an unrecognized query returns the index rather than an error.
runExecute a short async JavaScript script against the live sites and return `{ ok, result, logs, error, ms }`.
reportTell Bowmark what it could not do, or which run came back wrong. Recorded as feedback; retries nothing.

What the code can do

Read from the published package source — never executed. Parsed 2 of 2 source files.

This server can read your environment variables.

How it was published

Published by a verified CI identity (github trusted publishing) rather than a personal token.
Has a provenance attestation tying this artifact to the commit it was built from.
1 npm maintainer — a single point of compromise · last published by GitHub Actions.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit today — Actively maintained.
1 GitHub stars — Very little community usage so far.
Package repo does not match registry entry — The npm package points at bowmark-ai/mcp, while the registry lists bowmark-ai/skill. Worth confirming you are installing what you think you are.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

B · 67

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%100%
Last commit 0 days ago.
Adoption20%9%
1 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%0%
The package's declared repository does not match the registry entry.
Packaging15%100%
Publishes a pinned version (2.1.0).

Documentation

Full README

bowmark skill

<sub>LM Studio — GitHub strips a raw lmstudio: link, so this one is a paste, not a button. Copy it into your browser's address bar:</sub>

text

lmstudio://add_mcp?name=bowmark&config=eyJ1cmwiOiJodHRwczovL2FwaS5ib3dtYXJrLmFpL21jcC9iYWRnZS1sbXN0dWRpbyJ9

The skill for Bowmark — the web as callable functions. The agent reads a typed function library, writes a short script against it, and Bowmark runs it on the live sites.

npx skills add bowmark-ai/skill

Works on any host that supports the SKILL.md standard — Claude Code, Codex (which adopted the standard natively), Cursor, GitHub Copilot, OpenCode, and others.

The skill calls Bowmark's MCP server — wire that up at bowmark.ai/#install or via Smithery.

Want both in one step? On Claude Code and Codex, install the plugin instead — it bundles this skill *and* auto-wires the MCP:

# Claude Code
claude plugin marketplace add bowmark-ai/plugin && claude plugin install bowmark@bowmark-ai
# Codex
codex plugin marketplace add bowmark-ai/plugin   # then `codex /plugins` to install

Tools

| Tool | What it does | |---|---| | get_library | Read the typed function library for a task or a site. Read-only, touches no site, and an unrecognized query returns the index rather than an error. | | run | Execute a short async JavaScript script against the live sites and return { ok, result, logs, error, ms }. | | report | Tell Bowmark what it could not do, or which run came back wrong. Recorded as feedback; retries nothing. |

No MCP client? The same two calls are plain HTTP — GET https://api.bowmark.ai/v1/library?query=… and POST https://api.bowmark.ai/v1/run, both taking Authorization: Bearer $BOWMARK_API_KEY. The reference is bowmark.ai/docs/api; worked examples are at bowmark.ai/docs/scripting#no-install-at-all.

OpenAI Apps (ChatGPT plugin) variant

The ChatGPT Apps submission takes a skill as a ZIP or folder, and its needs differ slightly from the general skill: the plugin always ships the MCP alongside the skill, and ChatGPT exposes the tools under bare names. So there's a tailored variant, generated from this same canonical skill — never hand-maintained:

Alternatives to Bowmark

Maintain Bowmark? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![Bowmark on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/ai-bowmark-bowmark)](https://mcp-skills-hub.vercel.app/mcps/ai-bowmark-bowmark)

Catalog data refreshed Oct 28, 2026. Something wrong? Report it.