Ring MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Ring: 13 typed functions through one MCP server. No Ring API key needed.

Functions
13
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Ring

An MCP server for Ring alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/ring
Every site

One MCP server for Ring and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 11
  • compareProductsReads a Ring product category's comparison, the specifications of each model side by side.

    Arguments

    None.

    Returns RingComparison

    interface RingCompareProduct { productId: string; name: string; url: string; power: string | null; price: number | null; }
    
    interface RingCompareSpec { section: string; key: string; values: Record<string, string | null>; }
    
    interface RingComparison { products: RingCompareProduct[]; specs: RingCompareSpec[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/compareProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.compareProducts();
  • findRetailerLists Ring's authorized retail partners that carry Ring hardware.

    Arguments

    None.

    Returns RingRetailer[]

    interface RingRetailer { name: string; url: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/findRetailer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.findRetailer();
  • getCartPrices a cart's lines (the lines an earlier cart call returned): items, quantities and totals before checkout.

    Arguments

    NameTypeRequired
    args{ lines: RingCartLine[] }Yes
    interface RingCartLine { sku: string; quantity: number; handle: string; priceId: string; }

    Returns RingCart

    interface RingCartLine { sku: string; quantity: number; handle: string; priceId: string; }
    
    interface RingCartItem { sku: string; title: string; color: string | null; quantity: number; unitPrice: number | null; linePrice: number | null; url: string; imageUrl: string | null; }
    
    interface RingCart { lines: RingCartLine[]; items: RingCartItem[]; itemCount: number; currency: string | null; subtotal: number | null; total: number | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/getCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.getCart({
      lines: [
        {
          sku: "B0FHJ7TKZM",
          quantity: 1,
          handle: "battery-doorbell-2nd-gen",
          priceId: "price_1UZkXTQP23VT5gjk3WCgOrUA"
        }
      ]
    });
  • getPlansReads Ring Protect's subscription plans with their prices and what each one includes.

    Arguments

    None.

    Returns RingPlan[]

    interface RingPlan { name: string; monthlyPrice: number | null; yearlyPrice: number | null; pricing: string; description: string | null; features: string[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/getPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.getPlans();
  • getProductReads a Ring product page's live offer, availability, SKUs, images and server-rendered technical specifications.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns RingProduct

    interface RingProduct { name: string; url: string; price: number | null; wasPrice: number | null; currency: string | null; available: boolean | null; skus: string[]; images: string[]; specs: Record<string, string>; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.getProduct("<url>");
  • getProductReviewsReads a Ring product's customer reviews with their ratings and text.

    Arguments

    NameTypeRequired
    args{ url?: string; asin?: string; nextPage?: string; sortBy?: string }Yes

    Returns RingReviewsPage

    interface RingReview { id: string; title: string | null; text: string; stars: number | null; reviewedLine: string | null; verifiedPurchase: boolean; imageCount: number; }
    
    interface RingReviewsPage { asin: string; total: number | null; reviews: RingReview[]; nextPage: string | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/getProductReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.getProductReviews({ asin: "B07ZDTXJ93" });
  • getSupportArticleReads one Ring support article by the url searchSupport returned.

    Arguments

    NameTypeRequired
    args{ url: string }Yes

    Returns RingSupportArticle

    interface RingSupportArticle { id: string; title: string; url: string; updatedAt: string | null; body: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/getSupportArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.getSupportArticle({});
  • listCollectionReads one collection's product grid by its handle, with each card's name, url, price and image.

    Arguments

    NameTypeRequired
    args{ handle: string }Yes

    Returns RingSearchResult[]

    interface RingSearchResult { name: string; url: string; price: number | null; wasPrice: number | null; imageUrl: string | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/listCollection

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.listCollection({});
  • listCollectionsLists Ring's product collections (category and shelf pages) with their handles and names.

    Arguments

    None.

    Returns RingCollection[]

    interface RingCollection { handle: string; name: string; url: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/listCollections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.listCollections();
  • searchSupportSearches Ring's support center and returns matching help articles with their titles and urls.

    Arguments

    NameTypeRequired
    args{ query: string }Yes

    Returns RingSupportHit[]

    interface RingSupportHit { id: string; title: string; url: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/searchSupport

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.searchSupport({ query: "offline" });
Act 2
  • addToCartAdds a Ring product (by url, optional sku and quantity) to a cart and prices it.

    Arguments

    NameTypeRequired
    args{ url: string; sku?: string; quantity?: number; lines?: RingCartLine[] }Yes
    interface RingCartLine { sku: string; quantity: number; handle: string; priceId: string; }

    Returns RingCart

    interface RingCartLine { sku: string; quantity: number; handle: string; priceId: string; }
    
    interface RingCartItem { sku: string; title: string; color: string | null; quantity: number; unitPrice: number | null; linePrice: number | null; url: string; imageUrl: string | null; }
    
    interface RingCart { lines: RingCartLine[]; items: RingCartItem[]; itemCount: number; currency: string | null; subtotal: number | null; total: number | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.addToCart({});
  • removeFromCartRemoves one sku from a cart's lines and returns the re-priced cart.

    Arguments

    NameTypeRequired
    args{ sku: string; lines: RingCartLine[] }Yes
    interface RingCartLine { sku: string; quantity: number; handle: string; priceId: string; }

    Returns RingCart

    interface RingCartLine { sku: string; quantity: number; handle: string; priceId: string; }
    
    interface RingCartItem { sku: string; title: string; color: string | null; quantity: number; unitPrice: number | null; linePrice: number | null; url: string; imageUrl: string | null; }
    
    interface RingCart { lines: RingCartLine[]; items: RingCartItem[]; itemCount: number; currency: string | null; subtotal: number | null; total: number | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ring/removeFromCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ring.removeFromCart({});

Use it from code