Skip to main content
Glama

Bowmark web data: LinkedIn, Amazon, YouTube, Reddit, Airbnb, Instagram

Get the user a link to sign Bowmark in to a site

add_connection

Get a sign-in link for one site, so the user can sign Bowmark in to it right now, before any run needs it. Pass the site as a domain (youtube.com), a URL, or a provider id. Call this whenever the user asks to log in, sign in, connect or link an account on a site — never send them to the Bowmark Link extension or the dashboard to do it themselves.

It returns url, a single-use link that expires (expiresAt). Give the user that URL and say which site it is for. On that page they sign in with Bowmark's own browser, or, in desktop Chrome with Bowmark Link installed, press "Use Chrome extension" to send the login that Chrome already holds. Then call wait_for_sign_in with the returned ref: it answers the moment they finish, and every later run uses the new login.

When Bowmark cannot sign in to that site, it says so and returns sites, the sites it can sign in to. Tell the user plainly. Do not offer a workaround that asks for their password. A public page on that site still works without a login: get_library shows what can read it.

To sign back in to a saved login that stopped working, pass its id from list_connections as connection. The fresh session goes into the SAME id.

Input Schema

NameRequiredDescriptionDefault
siteYesThe site to sign in to: a domain (`youtube.com`), a URL, its name, or a provider id.
connectionNoOptional. The `id` of a saved login from `list_connections`, to sign back in to it.

Output Schema

NameRequiredDescriptionDefault
refNoPass it to `wait_for_sign_in` to hear the sign-in finish.
urlNoThe single-use sign-in link to give the user.
siteNoThe site the link signs in to.
sitesNoEvery site Bowmark can sign in to.
titleNoIts name.
ambiguousNoThe sites a name could mean — ask the user which.
expiresAtNoWhen the link expires.
connectionNoThe saved login this link refreshes, if one was named.
anotherLoginNoTrue when this adds a second login on that site.
signInSupportedNoFalse when Bowmark cannot sign in to that site.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "ambiguous": {
      +      "description": "The sites a name could mean — ask the user which."
      +    },
      +    "anotherLogin": {
      +      "description": "True when this adds a second login on that site.",
      +      "type": "boolean"
      +    },
      +    "connection": {
      +      "description": "The saved login this link refreshes, if one was named."
      +    },
      +    "expiresAt": {
      +      "description": "When the link expires."
      +    },
      +    "ref": {
      +      "description": "Pass it to `wait_for_sign_in` to hear the sign-in finish.",
      +      "type": "string"
      +    },
      +    "signInSupported": {
      +      "description": "False when Bowmark cannot sign in to that site.",
      +      "type": "boolean"
      +    },
      +    "site": {
      +      "description": "The site the link signs in to.",
      +      "type": "string"
      +    },
      +    "sites": {
      +      "description": "Every site Bowmark can sign in to."
      +    },
      +    "title": {
      +      "description": "Its name.",
      +      "type": "string"
      +    },
      +    "url": {
      +      "description": "The single-use sign-in link to give the user.",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.