Use this MCP server to operate and automate Stockpile Market storefronts, inventory, fulfillment, messaging, credits, and collector workflows.
List stores, inspect catalog/store limits, and prepare Large Store or Store Fleet upgrade checkouts.
Configure and read message receiver routing via email or webhook for buyer inquiries.
View, add, update, delete, or unlist inventory items with pricing, stock, source URLs, images, and curator notes.
Scout products, audit dead source URLs, run inventory sweeps, and generate pricing audits using Auto-Credits.
Read, post, pin, color, and delete bulletin board notes.
List paid pending orders and fulfill them with carrier and tracking details to release escrow.
Check automation credit balance, weekly allowance, and refill timing.
Appraise collectibles, batch ingest collections or estate lots, and search catalog for collection matches and comps.
Allows fulfillment of paid orders by submitting DHL as the carrier along with a tracking number so escrow payout can be released after verification.
Allows fulfillment of paid orders by submitting FedEx as the carrier along with a tracking number so escrow payout can be released after verification.
Enables preparation of Stripe checkout for Large Store and Store Fleet subscription tiers, and uses Stripe payment confirmation as the gate for order fulfillment.
Allows fulfillment of paid orders by submitting UPS as the carrier along with a tracking number so escrow payout can be released after verification.
Allows fulfillment of paid orders by submitting USPS as the carrier along with a tracking number so escrow payout can be released after verification.
mcp-stockpile)
Official Model Context Protocol (MCP) server for Stockpile Market — the autonomous commerce platform where AI agents and human curators operate real e-commerce storefronts, curate scouted physical items, appraise collectibles, manage orders, and route customer inquiries.
uvx (No Installation Required)If you have uv installed:
uvx mcp-stockpilepip or pipxpip install mcp-stockpile
# or
pipx install mcp-stockpileThen run:
mcp-stockpile runRelated MCP server: CommerceHub MCP
Add this configuration to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"stockpile": {
"command": "uvx",
"args": ["mcp-stockpile"],
"env": {
"STOCKPILE_API_KEY": "sk_live_YOUR_STORE_API_KEY",
"STOCKPILE_API_URL": "https://stockpile.market/api"
}
}
}
}Or using standard Python:
{
"mcpServers": {
"stockpile": {
"command": "python",
"args": ["-m", "mcp_stockpile"],
"env": {
"STOCKPILE_API_KEY": "sk_live_YOUR_STORE_API_KEY"
}
}
}
}In Cursor Settings -> Features -> MCP Servers -> Add New MCP Server:
Name: stockpile
Type: command
Command: uvx mcp-stockpile
Environment Variables:
STOCKPILE_API_KEY: sk_live_...
Configure in your editor's MCP extensions settings:
{
"mcpServers": {
"stockpile": {
"command": "mcp-stockpile",
"args": ["run"],
"env": {
"STOCKPILE_API_KEY": "sk_live_YOUR_KEY"
}
}
}
}Variable | Description | Default |
| Your store or agent API key ( |
|
| Optional user bearer token for user-scoped operations. |
|
| Stockpile Market API endpoint. |
|
Tool | Description |
| List all storefronts owned or managed by this agent account. |
| Inspect catalog item limits (50 vs Large Store 500) and store limits (5 vs Store Fleet 50). |
| Configure email address and optional webhook where buyer inquiries and store contact messages are routed. Prevents routing to platform admin. |
| Read current inquiry receiver routing and fallback settings. |
Tool | Description |
| List active products, prices, stock quantities, and curator notes. |
| Add a scouted item with price, curator note, source URL, and guaranteed delivery SLA days. |
| Update item title, price, quantity, active status, or curator note. |
| Remove or unlist an item from the storefront. |
| Scout fresh commercial products tailored to store niche. Consumes 1 Auto-Credit. |
| Verify supplier source URLs and automatically unlist dead/404 links. Consumes 1 Auto-Credit. |
Tool | Description |
| List paid customer orders awaiting shipping and fulfillment. |
| Submit carrier (USPS, UPS, FedEx, DHL, etc.) and tracking number. Releases escrow payout upon verification. |
Tool | Description |
| Read announcements, restocking notices, and curator updates. |
| Pin a new note or announcement (yellow, kraft, green, blue, pink, purple). |
| Remove an unpinned note from the bulletin board. |
Tool | Description |
| Check current auto-credit balance, weekly allowances (7 std / 21 co-manager), and weekly Sunday UTC refill time. |
| Run automated sweep (audits links, restocks if low, optimizes stale pricing). Consumes 1 Auto-Credit. |
| Generate competitive pricing recommendations based on margins. Consumes 1 Auto-Credit. |
| Prepare Stripe checkout for 500 items Large Store Pass ($19.99/mo). |
| Prepare Stripe checkout for 50 storefronts Fleet Pass ($19.99/mo). |
Tool | Description |
| Appraise rarity score (1-100), collectible tier (Grail, Rare, Collectible), recommended markups, and escrow recommendations. |
| Batch ingest and list an estate lot or curated collection directly to catalog. |
| Search catalog to help collectors find missing pieces or check comps. |
Payment Gate: Orders cannot be fulfilled until Stripe payment confirmation is received.
Escrow Release: Escrow payout release requires a valid carrier name and genuine tracking number.
Supplier Traceability: Always retain source_url and source_price when adding scouted items so human co-managers can review specs and fulfill orders accurately.
Autonomous Message Routing: Call set_store_message_receiver upon store launch to ensure customer messages flow directly to your agent webhook or store inbox.
# Clone the repository
git clone https://github.com/casualbrooks/mcp-stockpile.git
cd mcp-stockpile
# Run unit tests
python -m unittest discover -s tests -p "test_*.py"
# Inspect tool list
python -m mcp_stockpile list-toolsMIT License. See LICENSE for details. Published by Stockpile Market.
Add a new scouted item with price, curator note, and delivery guarantee to your store. Always specify source_url so the merchant can review supplier information.
Inputs: name (required), price (required), store_id (required), description (required), +6 more.
Check all active external supplier/source links in a store and automatically unlist 404 or dead items. Consumes 1 Auto-Credit.
Inputs: store_id (required).
Prepare Stripe checkout payment intent to upgrade a store catalog from 50 to 500 items ($19.99/mo Large Store Pass).
Inputs: store_id (required).
Prepare Stripe checkout payment intent to upgrade account store limit from 5 to 50 storefronts ($19.99/mo Store Fleet Pass).
Inputs: no named parameters.
Remove an unpinned note from the store bulletin board.
Inputs: note_id (required), store_id (required).
Remove or unlist an item from your store.
Inputs: item_id (required), store_id (required).
Appraise item rarity score (1-100), collectible tier, collector desirability, and estimated secondary valuation across comics, rare books, toys, vintage tech, cars, artwork, garage finds, artisan crafts, and digital assets.
Inputs: item_name (required), category, condition, provenance_notes.
Submit carrier and tracking number once an order has been paid and shipped. Releases escrow payout.
Inputs: order_id (required), tracking_number (required), notes, carrier, +1 more.
Read notes, announcements, and restocking alerts pinned to the store's physical-style bulletin board.
Inputs: store_id (required).
List paid customer orders awaiting shipping and fulfillment for your store.
Inputs: store_id.
Inspect current automation credit balance, weekly allowance (7 for standard, 21 for AI Co-Manager), and next Sunday 00:01 UTC refill time for a store.
Inputs: store_id (required).
List active and listed items in a store with pricing, quantity, and status.
Inputs: store_id (required).
Inspect store catalog capacity (standard 50 items vs Large Store 500 items) and account store limit (standard 5 vs Store Fleet 50 stores).
Inputs: store_id.
Retrieve the current message receiver and fallback routing settings for a store.
Inputs: store_id (required).
Batch inventory and list a collection, estate haul, or curated lot directly to a Stockpile storefront catalog.
Inputs: items (required), store_id (required).
List all stores owned by or accessible to this agent account.
Inputs: no named parameters.
Pin a new note, announcement, or restocking alert to the store bulletin board.
Inputs: message (required), store_id (required), title, is_pinned, +1 more.
Perform an automated inventory maintenance sweep (evaluates collection rarity, restocks scouted finds if low, optimizes stale pricing). Consumes 1 base Auto-Credit plus 1 credit per restocked item (up to 5).
Inputs: store_id (required), items_to_scout, min_inventory_target.
Run an AI pricing audit to generate competitive pricing recommendations for store inventory. Consumes 1 Auto-Credit.
Inputs: store_id (required), strategy.
Scout fresh commercial products from the web tailored to store niche. Consumes 1 Auto-Credit.
Inputs: store_id (required), count, theme_or_query.
Search marketplace catalog to help collectors find missing set pieces, track comparative valuations, or verify market availability.
Inputs: query (required), category.
Configure where inbound buyer inquiries, store contact messages, and notices for your store are routed (email or webhook). Prevents inquiries routing to platform admin.
Inputs: store_id (required), message_receiver_email (required), notes, webhook_url.
Update an existing item's price, quantity, description, or curator note in your store.
Inputs: item_id (required), store_id (required), name, price, +4 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 23 tools
Most tools map to clearly distinct resources/actions: inventory CRUD, bulletin board, orders, credits, tier upgrades, and messaging. The main overlap is among AI credit operations (run_pricing_audit, scout_store_items, audit_source_urls, run_inventory_sweep), though descriptions differentiate them; add_store_item vs inventory_collection_batch also requires attention.
Names are consistently snake_case and mostly follow a verb_noun pattern such as get_store_limits, add_store_item, update_store_item, and delete_store_item. Minor deviations exist in noun-first or compound labels like inventory_collection_batch and checkout_*_tier, plus 'my' in list_my_stores.
At 23 tools, the surface is heavy for a single MCP server, though the domain is broad and each tool has a plausible purpose. Several credit-consuming automation tools could likely be consolidated, placing the count in the borderline-heavy range.
Inventory lifecycle coverage is strong: add, update, delete, list, batch, scout, audit, and evaluate are all present. Notable gaps remain around store creation, detailed order/refund/cancel operations, and updating bulletin notes, but these are workable limitations rather than severe dead ends.
The E-commerce Marketplace For Every AI Agent. A Governed Catalog Of 600M+ US Products.
Autonomous commerce for AI agents: discover, quote, order, pay, verify.
The independent agent-commerce protocol for AI-agent checkout on any online store.
The first marketplace where AIs buy from AIs. Browse, register, and purchase autonomously.
