Etsy MCP server for AI agents

Let Claude, ChatGPT or your own agent read Etsy: 16 typed functions through one MCP server. No Etsy API key needed.

Functions
16
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Etsy

An MCP server for Etsy 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/etsy
Every site

One MCP server for Etsy 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

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

Read 16
  • browseCategoryThe listings in one Etsy category (e.g. jewelry/necklaces), with the category's own filters (price, on sale, ships from, star seller, personalizable)…

    Arguments

    NameTypeRequired
    pathstring | { path: string; minPrice?: number; maxPrice?: number; sort?: "most_relevant" | "price_asc" | "price_desc" | "date_desc"; page?: number }Yes

    Returns EtsyCategoryPage

    interface etsyListing {
      listingId: number;
      title: string;
      price: number | null;
      currencyCode: string | null;
      quantity: number | null;
      tags: string[];
      url: string;
    }
    
    interface EtsyCategoryPage {
      name: string;
      path: string;
      url: string;
      page: number;
      listings: etsyListing[];
      subcategories: { name: string; path: string; url: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/browseCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.browseCategory({ path: "jewelry/necklaces", maxPrice: 50 });
  • estimateShippingWhat one Etsy listing costs to ship and when it would arrive at a destination.

    Arguments

    NameTypeRequired
    args{ listing: number | string; zip?: string; country?: string }Yes

    Returns EtsyShippingEstimate

    interface EtsyShippingEstimate {
      listingId: number;
      destination: string | null;
      deliveryWindow: string | null;
      shippingCost: number | null;
      costText: string | null;
      shipsFrom: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/estimateShipping

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.estimateShipping({ listing: 1371848548, zip: "10001" });
  • findRegistryFinds Etsy gift registries (wedding, baby, gift) by the registrant's first and last name.

    Arguments

    NameTypeRequired
    namestring | { firstName: string; lastName: string }Yes

    Returns EtsyRegistryMatch[]

    interface EtsyRegistryMatch {
      registryId: string;
      name: string;
      location: string | null;
      eventDate: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/findRegistry

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.findRegistry("Emily Smith");
  • getListingOne Etsy listing by its id or etsy.com/listing URL.

    Arguments

    NameTypeRequired
    idOrUrlnumber | stringYes

    Returns EtsyListingDetail

    interface EtsyListingDetail {
      listingId: number;
      title: string;
      description: string | null;
      price: number | null;
      currencyCode: string | null;
      quantityAvailable: number | null;
      freeShipping: boolean | null;
      rating: number | null;
      reviewCount: number | null;
      images: string[];
      shopName: string | null;
      category: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/getListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.getListing(1371848548);
  • getRegistryOne Etsy gift registry by the id findRegistry returns or its URL.

    Arguments

    NameTypeRequired
    registryIdOrUrlstringYes

    Returns EtsyRegistry

    interface EtsyRegistry {
      registryId: string;
      name: string;
      eventType: string | null;
      eventDate: string | null;
      location: string | null;
      itemsRequested: number | null;
      itemsPurchased: number | null;
      items: { listingId: number; title: string; shop: string | null; priceText: string | null; image: string | null; quantityRequested: number | null; quantityPurchased: number | null; stillNeeded: number | null; url: string }[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/getRegistry

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.getRegistry("<registryIdOrUrl>");
  • getShopOne Etsy shop by its name or etsy.com/shop URL.

    Arguments

    NameTypeRequired
    nameOrUrlstringYes

    Returns EtsyShop

    interface EtsyShop {
      name: string;
      tagline: string | null;
      description: string | null;
      location: string | null;
      logo: string | null;
      rating: number | null;
      reviewCount: number | null;
      sales: number | null;
      admirers: number | null;
      onEtsySince: number | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/getShop

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.getShop("Neherpottery");
  • getUserProfileA member's public Etsy profile by username or etsy.com/people URL.

    Arguments

    NameTypeRequired
    usernameOrUrlstringYes

    Returns EtsyUserProfile

    interface EtsyUserProfile {
      username: string;
      displayName: string;
      collections: { name: string; itemCount: number | null; url: string }[];
      followedShops: { name: string; avatar: string | null; rating: number | null; reviewCount: number | null; url: string }[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/getUserProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.getUserProfile("jesmail");
  • listCategoriesEtsy's category tree, top-level departments and their subcategories with their /c/ paths, so a caller can find the path browseCategory takes.

    Arguments

    None.

    Returns EtsyCategory[]

    interface EtsyCategory {
      name: string;
      path: string;
      url: string;
      subcategories: { name: string; path: string; url: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.listCategories();
  • listEditorsPicksEtsy's Editors' Picks.

    Arguments

    NameTypeRequired
    collectionstringNo

    Returns EtsyEditorsPicks

    interface EtsyEditorsPicks {
      collection: string | null;
      title: string;
      subtitle: string | null;
      collections: {
        slug: string;
        title: string;
        blurb: string | null;
        image: string | null;
        url: string;
      }[];
      listings: {
        listingId: number;
        title: string;
        price: number | null;
        originalPrice: number | null;
        rating: number | null;
        reviewCount: number | null;
        image: string | null;
        url: string;
      }[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/listEditorsPicks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.listEditorsPicks();
  • listListingReviewsThe reviews on one Etsy listing, as the listing page's own Product structured data carries them.

    Arguments

    NameTypeRequired
    idOrUrlnumber | stringYes

    Returns EtsyListingReview[]

    interface EtsyListingReview {
      author: string | null;
      rating: number | null;
      maxRating: number | null;
      date: string | null;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/listListingReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.listListingReviews(1371848548);
  • listShopListingsThe items on the first page of an Etsy shop, from the shop page's own ItemList structured data.

    Arguments

    NameTypeRequired
    nameOrUrlstring | { shop: string; page?: number }Yes

    Returns etsyListing[]

    interface etsyListing {
      listingId: number;
      title: string;
      price: number | null;
      currencyCode: string | null;
      quantity: number | null;
      tags: string[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/listShopListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.listShopListings("Neherpottery");
  • listShopReviewsOne page of the reviews an Etsy shop has received across all its listings, newest first.

    Arguments

    NameTypeRequired
    nameOrUrlstring | { shop: string; page?: number }Yes

    Returns EtsyShopReviewPage

    interface EtsyShopReview {
      id: string;
      reviewer: string | null;
      reviewerUrl: string | null;
      date: string | null;
      rating: number | null;
      text: string | null;
      sellerResponse: string | null;
      listingId: number | null;
      listingTitle: string | null;
      listingUrl: string | null;
    }
    
    interface EtsyShopReviewPage {
      page: number;
      hasNextPage: boolean;
      reviews: EtsyShopReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/listShopReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.listShopReviews("Neherpottery");
  • listTrendingSearchesWhat people are searching for on Etsy this week.

    Arguments

    None.

    Returns EtsyTrendingSearch[]

    interface EtsyTrendingSearch {
      query: string;
      url: string;
      image: string | null;
      module: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/listTrendingSearches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.listTrendingSearches();
  • searchShopsFinds Etsy shops whose name contains a word.

    Arguments

    NameTypeRequired
    querystringYes

    Returns EtsyShopSearchRow[]

    interface EtsyShopSearchRow {
      name: string;
      tagline: string | null;
      itemCount: number | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/searchShops

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.searchShops("pottery");
  • suggestSearchesEtsy's search-box suggestions for what a person has typed so far, including 'find shop names containing …'.

    Arguments

    NameTypeRequired
    textstringYes

    Returns EtsySearchSuggestion[]

    interface EtsySearchSuggestion {
      query: string;
      kind: "search" | "shop";
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/etsy/suggestSearches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.etsy.suggestSearches("ceramic");

Use it from code