Quickstart

Get an API key, run one script from your terminal, then add Bowmark to your agent.

Bowmark covers over 100,000 websites with more than a million functions your agent can call. This page gets you from a key to a live result in a few minutes.

Get an API key

Sign up, then create a key on the keys page. Your first $10 of usage is free, no card needed.

export BOWMARK_API_KEY="bmk_..."

Check coverage

Before writing a script for a site, ask the library by hostname:

curl -s "https://api.bowmark.ai/v1/library?query=example.com" \
  -H "Authorization: Bearer $BOWMARK_API_KEY"

It is the definitive coverage answer. Every covered site lists them all. See the library reference for the response and what to do for an uncovered site.

Run a script

Send one script to POST /v1/run. This one prices a 3 lb package from San Francisco to New York across USPS and Pirate Ship, cheapest service first:

curl -s https://api.bowmark.ai/v1/run \
  -H "Authorization: Bearer $BOWMARK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"script":"const { rates } = await bowmark.shipping.estimate({ fromZip: \"94103\", toZip: \"10001\", weightOz: 48 }); return rates.slice(0, 3);"}'

It usually answers in under ten seconds. Your script's return value is in result (recorded 2026-11-16, each row shortened to its main fields):

{
  "ok": true,
  "status": "ok",
  "result": [
    {
      "price": { "amount": 586, "currency": "USD" },
      "source": "usps",
      "serviceName": "Media Mail®"
    },
    {
      "price": { "amount": 992, "currency": "USD" },
      "source": "pirateship",
      "serviceName": "UPS Ground Saver®"
    },
    {
      "price": { "amount": 1002, "currency": "USD" },
      "source": "pirateship",
      "serviceName": "USPS Ground Advantage Cubic"
    }
  ]
}

price.amount is in cents, so 586 is $5.86. Rates are live, so yours will differ.

Check status on every response. ok means everything your script asked for answered. partial means the result is real but narrower than you asked for, and an incomplete field names what is missing. Every field is on Read the response.

Add Bowmark to your agent

Point any MCP client at this URL with your key in the Authorization header:

https://api.bowmark.ai/mcp

In Claude Code that is one command:

claude mcp add bowmark --transport http https://api.bowmark.ai/mcp \
  --header "Authorization: Bearer $BOWMARK_API_KEY"

Config for ChatGPT, Cursor, Codex, the plugin and your own code is on Install.

Then ask your agent something that needs a live site:

Compare USPS and UPS prices to ship a 3 lb box from ZIP 94103 to
ZIP 10001, and tell me which service is cheapest right now.

It calls get_library (an MCP tool, also GET /v1/library over HTTP) to find the functions, then run with a short script.

If it doesn't work

  • The agent answered without calling a tool. In ChatGPT, type @ and pick Bowmark on every turn.
  • A 403 from Python. Set a User-Agent header. Stdlib urllib's default one is refused.
  • The site you need isn't in the library. Read the page with bowmark.read.page(url). See Read any page.

Next