# Bowmark

Turns live websites into typed callable functions, letting coding agents pull pricing, book slots, and submit web forms.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: bowmark-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bowmark-ai/skill
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/bowmark

## What it does

Bowmark lets agents interact with live web pages as if they were typed code libraries. Instead of wrestling with raw browser sessions, the agent looks up site actions using `get_library`, writes a brief async JavaScript snippet, and executes it via the `run` tool. This handles tasks behind logins and dynamic web forms.

The server provides three tools: `get_library` to inspect available routines, `run` to execute actions against targets, and `report` for submitting feedback on failed runs. For environments lacking native MCP integration, both discovery and execution endpoints remain reachable via direct HTTP requests.

To run the stdio server, you must provide a valid `BOWMARK_API_KEY` environment variable. Execution fails if the token is omitted.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.bowmark.ai/mcp/registry`
- Environment variables: `BOWMARK_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add bowmark -e BOWMARK_API_KEY=<BOWMARK_API_KEY> -- npx -y @bowmark/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http bowmark https://api.bowmark.ai/mcp/registry
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add bowmark --url https://api.bowmark.ai/mcp/registry
```

2. **Platform CLI**
```bash
codex mcp add bowmark --env BOWMARK_API_KEY=<BOWMARK_API_KEY> -- npx -y @bowmark/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bowmark": {
            "url": "https://api.bowmark.ai/mcp/registry"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bowmark": {
            "command": "npx",
            "args": [
                "-y",
                "@bowmark/mcp"
            ],
            "env": {
                "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bowmark": {
            "type": "http",
            "url": "https://api.bowmark.ai/mcp/registry"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bowmark": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@bowmark/mcp"
            ],
            "env": {
                "BOWMARK_API_KEY": "<BOWMARK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http bowmark https://api.bowmark.ai/mcp/registry
```

2. **Platform CLI**
```bash
gemini mcp add -e BOWMARK_API_KEY=<BOWMARK_API_KEY> bowmark npx -y @bowmark/mcp
```
Replace <…> with your own values

## When to use it
- fetch live pricing from protected web forms
- check availability and booking schedules on websites
- automate actions behind login screens
- execute async JavaScript routines against web platforms

## Example prompts
- Check current flight prices using the Bowmark library
- Run a script through `run` to inspect booking slot availability
- Query `get_library` for ecommerce checkout functions

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md