Instacart MCP server for AI agents
Let Claude, ChatGPT or your own agent read Instacart: 17 typed functions through one MCP server. No Instacart API key needed.
- Site
- instacart.com
- Functions
- 17
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Instacart 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/instacartOne MCP server for Instacart 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 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.
compareStoresSearches every store that serves a location at once ("milk" across Costco, Safeway, Aldi…) and returns the best matches per store with price, so an…Arguments
Name Type Required querystringYes postalCodestringYes latitudenumberYes longitudenumberYes maxStoresnumberDefault 10, max 30.No itemsPerStorenumberDefault 5, max 20.No Returns
InstacartCompareStoresResultinterface InstacartStore { shopId: string; retailerId: string; slug: string; name: string; retailerType: string; serviceType: string; logoUrl: string | null; } interface InstacartItem { itemId: string; productId: string; name: string; size: string | null; brand: string | null; price: string | null; fullPrice: string | null; pricePerUnit: string | null; available: boolean | null; stockLevel: string | null; imageUrl: string | null; } interface InstacartStoreMatches { shopId: string; retailerId: string; store: InstacartStore | null; items: InstacartItem[]; } interface InstacartCompareStoresResult { query: string; zoneId: string; stores: InstacartStoreMatches[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/compareStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.compareStores({ query: "milk", postalCode: "94103", latitude: 37.77502, longitude: -122.41934, maxStores: 3, itemsPerStore: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.compareStores({ "query": "milk", "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934, "maxStores": 3, "itemsPerStore": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/compareStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"milk","postalCode":"94103","latitude":37.77502,"longitude":-122.41934,"maxStores":3,"itemsPerStore":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.compareStores({ query: "milk", postalCode: "94103", latitude: 37.77502, longitude: -122.41934, maxStores: 3, itemsPerStore: 2 });findLocationTurns a ZIP code or address text into the location every other Instacart function takes.Arguments
Name Type Required querystringYes Returns
InstacartLocationinterface InstacartLocation { postalCode: string; latitude: number; longitude: number; city: string | null; state: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/findLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.findLocation("94103");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.findLocation("94103"))curl -X POST https://api.bowmark.ai/v1/sites/instacart/findLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"94103"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.findLocation("94103");getCartReturns one cart's contents: each item with quantity, price, any sale, and the cart's subtotal, fees and estimated total.Arguments
Name Type Required cartIdstringFrom listCarts()[i].id.Yes Returns
InstacartCartinterface InstacartCartItem { itemId: string | null; productId: string | null; name: string | null; quantity: number | null; price: string | null; // the site's own display string, e.g. "$4.99" } interface InstacartCart { id: string; retailer: string | null; items: InstacartCartItem[]; subtotal: string | null; // display string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getCart({ cartId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getCart({"cartId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/instacart/getCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"cartId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.getCart({ cartId: "1" });getDeliveryEstimateSays how soon a store can deliver to, or have pickup ready at, a location.Arguments
Name Type Required retailerIdstringYes postalCodestringYes latitudenumberYes longitudenumberYes serviceType"DELIVERY" | "PICKUP"Default both.No Returns
InstacartDeliveryEstimate[]interface InstacartDeliveryEstimate { retailerId: string; serviceType: "DELIVERY" | "PICKUP"; available: boolean; etaSeconds: number | null; etaString: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getDeliveryEstimateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getDeliveryEstimate({ retailerId: "5", postalCode: "94103", latitude: 37.77502, longitude: -122.41934, serviceType: "DELIVERY" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getDeliveryEstimate({ "retailerId": "5", "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934, "serviceType": "DELIVERY" }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/getDeliveryEstimate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"retailerId":"5","postalCode":"94103","latitude":37.77502,"longitude":-122.41934,"serviceType":"DELIVERY"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.getDeliveryEstimate({ retailerId: "5", postalCode: "94103", latitude: 37.77502, longitude: -122.41934, serviceType: "DELIVERY" });getMyAccountReturns the signed-in customer's own account: id, name, email and phone.Arguments
None.
Returns
InstacartAccountinterface InstacartAccount { id: string; firstName: string | null; lastName: string | null; email: string | null; phone: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getMyAccountCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getMyAccount();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getMyAccount())curl -X POST https://api.bowmark.ai/v1/sites/instacart/getMyAccount \ -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.instacart.getMyAccount();getProductReturns one product's detail: name, brand, size, category, description, ingredients, directions and warnings, plus.Arguments
Name Type Required productIdstringNo itemIdstringNo shopIdstringNo postalCodestringYes latitudenumberYes longitudenumberYes Returns
InstacartProductinterface InstacartItem { itemId: string; productId: string; name: string; size: string | null; brand: string | null; price: string | null; fullPrice: string | null; pricePerUnit: string | null; available: boolean | null; stockLevel: string | null; imageUrl: string | null; } interface InstacartProduct { productId: string; name: string; brand: string | null; size: string | null; category: string | null; description: string | null; sections: { kind: string; heading: string; text: string }[]; ingredients: string | null; warnings: string | null; startingPrice: number | null; store: (InstacartItem & { shopId: string }) | null; dietaryLabels: string[]; nutrition: { label: string; value: string; unit: string | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getProduct({ productId: "2798606", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getProduct({ "productId": "2798606", "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934 }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"productId":"2798606","postalCode":"94103","latitude":37.77502,"longitude":-122.41934}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.getProduct({ productId: "2798606", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });getStoreReturns one store by its Instacart slug ("costco", "safeway") at a location: shop id, retailer id, store type, service type and logo.Arguments
Name Type Required slugstringYes postalCodestringYes latitudenumberYes longitudenumberYes Returns
InstacartStoreinterface InstacartStore { shopId: string; retailerId: string; slug: string; name: string; retailerType: string; serviceType: string; logoUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getStoreCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getStore({ slug: "costco", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getStore({ "slug": "costco", "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934 }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/getStore \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"costco","postalCode":"94103","latitude":37.77502,"longitude":-122.41934}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.getStore({ slug: "costco", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });getStoreHoursReturns a store's opening hours for each day of a date range (default the next 7 days).Arguments
Name Type Required shopIdstringA store's shop id, from listStores or getStore.Yes startDatestringFirst day, YYYY-MM-DD.No daysnumberNumber of days from startDate, 1-14.No Returns
InstacartStoreHoursDay[]interface InstacartStoreHoursDay { /** YYYY-MM-DD. */ date: string; /** The site's own line, e.g. "Open 10am - 8:30pm". */ hours: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getStoreHoursCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getStoreHours({ shopId: "12" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getStoreHours({"shopId": "12"}))curl -X POST https://api.bowmark.ai/v1/sites/instacart/getStoreHours \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shopId":"12"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.getStoreHours({ shopId: "12" });getWeeklyAdReturns the flyers (weekly ad / circular) a store is running now: name, the dates it runs, and each page as an image.Arguments
Name Type Required shopIdstringA store's shop id, from listStores or getStore.Yes Returns
InstacartWeeklyAd[]interface InstacartWeeklyAdPage { pageNumber: number; imageUrl: string; width: number | null; height: number | null; } interface InstacartWeeklyAd { id: string; /** The flyer's own name, e.g. "Warehouse Savings". */ name: string; /** The flyer's tag, e.g. "monthly" or "weekly". */ tag: string | null; /** ISO instant the flyer starts. */ startsAt: string | null; /** ISO instant the flyer ends. */ endsAt: string | null; /** The site's own date line, e.g. "Oct 19 - Nov 14". */ dates: string | null; pages: InstacartWeeklyAdPage[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/getWeeklyAdCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.getWeeklyAd({ shopId: "12" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.getWeeklyAd({"shopId": "12"}))curl -X POST https://api.bowmark.ai/v1/sites/instacart/getWeeklyAd \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shopId":"12"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.getWeeklyAd({ shopId: "12" });listCartsLists the signed-in customer's open carts, one per store, with item count and subtotal.Arguments
None.
Returns
InstacartCartSummary[]interface InstacartCartSummary { id: string; // pass to getCart as { cartId } retailer: string | null; // the store this cart is at shopId: string | null; itemCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listCartsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listCarts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listCarts())curl -X POST https://api.bowmark.ai/v1/sites/instacart/listCarts \ -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.instacart.listCarts();listDealsLists what is on sale at a store right now.Arguments
Name Type Required shopIdstringYes postalCodestringYes latitudenumberYes longitudenumberYes maxDealsnumberDefault 20, max 50.No Returns
InstacartDeal[]interface InstacartItem { itemId: string; productId: string; name: string; size: string | null; brand: string | null; price: string | null; fullPrice: string | null; pricePerUnit: string | null; available: boolean | null; stockLevel: string | null; imageUrl: string | null; } interface InstacartDeal extends InstacartItem { saleLabel: string | null; offerLabel: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listDeals({ shopId: "12", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listDeals({ "shopId": "12", "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934 }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/listDeals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shopId":"12","postalCode":"94103","latitude":37.77502,"longitude":-122.41934}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.listDeals({ shopId: "12", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });listDepartmentProductsLists the products in one store department or aisle by its slug, each with price and stock.Arguments
Name Type Required shopIdstringYes slugstringYes postalCodestringYes latitudenumberYes longitudenumberYes maxProductsnumberDefault 20, max 50.No Returns
InstacartDepartmentProductsinterface InstacartItem { itemId: string; productId: string; name: string; size: string | null; brand: string | null; price: string | null; fullPrice: string | null; pricePerUnit: string | null; available: boolean | null; stockLevel: string | null; imageUrl: string | null; } interface InstacartDepartmentProducts { departmentId: string; departmentName: string; slug: string; products: InstacartItem[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listDepartmentProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listDepartmentProducts({ shopId: "12", slug: "produce", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listDepartmentProducts({ "shopId": "12", "slug": "produce", "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934 }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/listDepartmentProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shopId":"12","slug":"produce","postalCode":"94103","latitude":37.77502,"longitude":-122.41934}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.listDepartmentProducts({ shopId: "12", slug: "produce", postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });listDepartmentsLists a store's top-level departments and aisles (Produce, Dairy & Eggs, Sales…) with the slug listDepartmentProducts and listDeals take.Arguments
Name Type Required shopIdstringYes postalCodestringYes Returns
InstacartDepartment[]interface InstacartDepartment { id: string; slug: string; name: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listDepartmentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listDepartments({ shopId: "12", postalCode: "94103" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listDepartments({"shopId": "12", "postalCode": "94103"}))curl -X POST https://api.bowmark.ai/v1/sites/instacart/listDepartments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shopId":"12","postalCode":"94103"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.listDepartments({ shopId: "12", postalCode: "94103" });listMyAddressesLists the signed-in customer's saved delivery addresses with their ids, which cart, delivery-window and checkout calls take.Arguments
None.
Returns
InstacartAddress[]interface InstacartAddress { id: string; // pass to updateAddress / deleteAddress streetAddress: string | null; apartment: string | null; city: string | null; state: string | null; postalCode: string | null; latitude: number | null; longitude: number | null; instructions: string | null; // the courier note saved on the address }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listMyAddressesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listMyAddresses();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listMyAddresses())curl -X POST https://api.bowmark.ai/v1/sites/instacart/listMyAddresses \ -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.instacart.listMyAddresses();listOrdersThe signed-in customer's own Instacart orders, newest first.Arguments
Name Type Required args{ limit?: number; cursor?: string }No Returns
SignedInOrderPageinterface SignedInOrder { id: string; // the shop's own order id placedAt: string | null; // ISO 8601 (YYYY-MM-DD when the shop gives only a date) status: string; // the shop's own words; a cancelled or refunded order keeps them, the site's own labels, read the values off a result, never guess one from prose total: number | null; // major units (dollars) currency: string | null; // ISO 4217, e.g. "USD" merchant: string | null; // the store or restaurant itemCount: number | null; url: string; // the order's own page } interface SignedInOrderPage { orders: SignedInOrder[]; // newest first nextCursor: string | null; // pass back as { cursor } for older orders }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/instacart/listOrders \ -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.instacart.listOrders();listStoresLists the stores Instacart serves at a location.Arguments
Name Type Required postalCodestringYes latitudenumberYes longitudenumberYes Returns
InstacartStore[]interface InstacartStore { shopId: string; retailerId: string; slug: string; name: string; retailerType: string; serviceType: string; logoUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/listStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.listStores({ postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.listStores({ "postalCode": "94103", "latitude": 37.77502, "longitude": -122.41934 }))curl -X POST https://api.bowmark.ai/v1/sites/instacart/listStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postalCode":"94103","latitude":37.77502,"longitude":-122.41934}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.listStores({ postalCode: "94103", latitude: 37.77502, longitude: -122.41934 });suggestSearchesReturns Instacart's search-as-you-type suggestions for a partial query at one store ("chee" → "cheez its").Arguments
Name Type Required querystringWhat the shopper has typed so far, e.g. "chee".Yes shopIdstringA store's shop id, from listStores or getStore.Yes Returns
InstacartSearchSuggestion[]interface InstacartSearchSuggestion { term: string; retailerSlug: string | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/instacart/suggestSearchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.instacart.suggestSearches({ query: "chee", shopId: "12" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.instacart.suggestSearches({"query": "chee", "shopId": "12"}))curl -X POST https://api.bowmark.ai/v1/sites/instacart/suggestSearches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"chee","shopId":"12"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.instacart.suggestSearches({ query: "chee", shopId: "12" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/instacart/<function> - OpenAPI
/v1/sites/instacart/openapi.json