About Bowmark AI
Bowmark AI provides precomputed website navigation recipes for agents, which can run short JavaScript scripts against live sites. The project includes a skill and an MCP server, with plugin installation options for Claude Code and Codex.
Key features
- 01Read a typed function library
- 02Run JavaScript scripts on live sites
- 03Report unsuccessful or incorrect runs
- 04Install as a skill or plugin
Use cases
- 01Look up site functions for a task
- 02Run a prepared interaction on a live website
- 03Send feedback about failed results
MCP support
The skill calls Bowmark’s MCP server, which provides the `get_library`, `run`, and `report` tools. The same library and execution calls are also available over HTTP.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.bowmark.ai/mcp/registryclaude mcp add --transport http skill https://api.bowmark.ai/mcp/registry{"mcpServers":{"skill":{"type":"http","url":"https://api.bowmark.ai/mcp/registry"}}}Open in Cursor{"servers":{"skill":{"type":"http","url":"https://api.bowmark.ai/mcp/registry"}}}Open in VS Code{"mcpServers":{"skill":{"type":"http","url":"https://api.bowmark.ai/mcp/registry"}}}{"mcpServers":{"skill":{"serverUrl":"https://api.bowmark.ai/mcp/registry"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.bowmark.ai/mcp/registryAuth requiredTools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Optional, but pass one — it decides how much detail comes back. What the user wants to do, in their words ("flights", "price a GPU", "book a table", "check stock"), or a company/site if they named one ("Kayak", "newegg.com"). A rough guess is always safe: a value that matches nothing returns the one-line index rather than an error, and so does omitting it. |
Details
From the project READMEbowmark skill
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:
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:
- Folder:
openai/bowmark/— a content mirror ofbowmark/SKILL.mdwith the trailing "Your API key" section and everything after it dropped (ChatGPT signs in by OAuth and cannot send a key), tool names rewritten to bareget_library/run, Claude-only frontmatter/tool-name references trimmed, and the three secret tools (list_secrets,request_secret,get_secret_link) replaced by the dashboard — the plugin's MCP is the ChatGPT directory connector, which does not offer them. That step refuses to build if the canonical wording moves out from under it.build-openai.mjsis the authority on what it cuts; this line described sections that have never existed inbowmark/SKILL.md, and a newcomer went looking for one. - ZIP:
openai/bowmark-openai-skill.zip— the same folder zipped, ready to drop straight into the ChatGPT "Skills" uploader. A committed artifact (not built in CI: the release runner has nozipbinary), so it rides the mirror tobowmark-ai/skillat a stable raw URL like any other file.
Both are generated by build-openai.mjs. Edit bowmark/SKILL.md, then regenerate and commit — never edit the openai/ copies directly (CI's check:openai fails a PR whose text mirror is stale):
pnpm -F @bowmark/skill sync:openai # regenerate openai/bowmark/SKILL.md
pnpm -F @bowmark/skill build:openai-zip # rebuild openai/bowmark-openai-skill.zip (commit it)
License
MIT © Bowmark AI
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.