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/mcpIn 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
403from Python. Set aUser-Agentheader. Stdliburllib'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
- Write a script
- Read the response
- Signed-in sites
- Browser agent, for forms and multi-step tasks
- Every covered site
- Pricing