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.
- Site
- etsy.com
- Functions
- 16
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/etsyOne MCP server for Etsy and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
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
Name Type Required pathstring | { path: string; minPrice?: number; maxPrice?: number; sort?: "most_relevant" | "price_asc" | "price_desc" | "date_desc"; page?: number }Yes Returns
EtsyCategoryPageinterface 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/browseCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.browseCategory({ path: "jewelry/necklaces", maxPrice: 50 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.browseCategory({"path": "jewelry/necklaces", "maxPrice": 50}))curl -X POST https://api.bowmark.ai/v1/sites/etsy/browseCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":{"path":"jewelry/necklaces","maxPrice":50}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ listing: number | string; zip?: string; country?: string }Yes Returns
EtsyShippingEstimateinterface 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/estimateShippingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.estimateShipping({ listing: 1371848548, zip: "10001" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.estimateShipping({"listing": 1371848548, "zip": "10001"}))curl -X POST https://api.bowmark.ai/v1/sites/etsy/estimateShipping \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"listing":1371848548,"zip":"10001"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/findRegistryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.findRegistry("Emily Smith");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.findRegistry("Emily Smith"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/findRegistry \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"Emily Smith"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.findRegistry("Emily Smith");getListingOne Etsy listing by its id or etsy.com/listing URL.Arguments
Name Type Required idOrUrlnumber | stringYes Returns
EtsyListingDetailinterface 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/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.getListing(1371848548);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.getListing(1371848548))curl -X POST https://api.bowmark.ai/v1/sites/etsy/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":1371848548}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.getListing(1371848548);getRegistryOne Etsy gift registry by the id findRegistry returns or its URL.Arguments
Name Type Required registryIdOrUrlstringYes Returns
EtsyRegistryinterface 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/getRegistryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.getRegistry("<registryIdOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.getRegistry("<registryIdOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/getRegistry \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"registryIdOrUrl":"<registryIdOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.getRegistry("<registryIdOrUrl>");getShopOne Etsy shop by its name or etsy.com/shop URL.Arguments
Name Type Required nameOrUrlstringYes Returns
EtsyShopinterface 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/getShopCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.getShop("Neherpottery");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.getShop("Neherpottery"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/getShop \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"nameOrUrl":"Neherpottery"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.getShop("Neherpottery");getUserProfileA member's public Etsy profile by username or etsy.com/people URL.Arguments
Name Type Required usernameOrUrlstringYes Returns
EtsyUserProfileinterface 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/getUserProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.getUserProfile("jesmail");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.getUserProfile("jesmail"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/getUserProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"usernameOrUrl":"jesmail"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/etsy/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.listCategories();listEditorsPicksEtsy's Editors' Picks.Arguments
Name Type Required collectionstringNo Returns
EtsyEditorsPicksinterface 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/listEditorsPicksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.listEditorsPicks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.listEditorsPicks())curl -X POST https://api.bowmark.ai/v1/sites/etsy/listEditorsPicks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.listEditorsPicks();listListingReviewsThe reviews on one Etsy listing, as the listing page's own Product structured data carries them.Arguments
Name Type Required 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/listListingReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.listListingReviews(1371848548);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.listListingReviews(1371848548))curl -X POST https://api.bowmark.ai/v1/sites/etsy/listListingReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":1371848548}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listShopListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.listShopListings("Neherpottery");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.listShopListings("Neherpottery"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/listShopListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"nameOrUrl":"Neherpottery"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.listShopListings("Neherpottery");listShopReviewsOne page of the reviews an Etsy shop has received across all its listings, newest first.Arguments
Name Type Required nameOrUrlstring | { shop: string; page?: number }Yes Returns
EtsyShopReviewPageinterface 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/listShopReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.listShopReviews("Neherpottery");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.listShopReviews("Neherpottery"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/listShopReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"nameOrUrl":"Neherpottery"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listTrendingSearchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.listTrendingSearches();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.listTrendingSearches())curl -X POST https://api.bowmark.ai/v1/sites/etsy/listTrendingSearches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.listTrendingSearches();searchSearches Etsy's live catalog of active listings by keyword and returns each matching listing's id, title, price, currency, quantity available, tags…Arguments
Name Type Required argsstring | { query: string; limit?: 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/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.search("handmade necklace");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.search("handmade necklace"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"handmade necklace"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.search("handmade necklace");searchShopsFinds Etsy shops whose name contains a word.Arguments
Name Type Required 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/searchShopsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.searchShops("pottery");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.searchShops("pottery"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/searchShops \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"pottery"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required textstringYes Returns
EtsySearchSuggestion[]interface EtsySearchSuggestion { query: string; kind: "search" | "shop"; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/etsy/suggestSearchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.etsy.suggestSearches("ceramic");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.etsy.suggestSearches("ceramic"))curl -X POST https://api.bowmark.ai/v1/sites/etsy/suggestSearches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text":"ceramic"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.etsy.suggestSearches("ceramic");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/etsy/<function> - OpenAPI
/v1/sites/etsy/openapi.json