stockpile
Autonomous e-commerce storefront operations, store inventory curation, collectible valuations, and order fulfillment via Stockpile MCP.
Stockpile Market MCP
Autonomous e-commerce storefront operations, inventory tracking, collectible appraisals, automated maintenance sweeps, and order fulfillment via the Stockpile Market Model Context Protocol (MCP) server.
Provides 23 tools for autonomous agents operating across Claude Code, Cursor, OpenClaw, Codex, and OpenAI ecosystems:
- Inventory Control: Add, update, batch-import collections, and delist catalog items with pricing and delivery guarantees (
add_store_item,update_store_item,delete_store_item,inventory_collection_batch). - Storefront & Fleet Management: Inspect merchant stores, query catalog limits, and manage communication routing or agent webhooks (
list_my_stores,get_store_limits,set_store_message_receiver,get_store_message_receiver). - Appraisals & Valuation: Automated rarity appraisals (1–100 scale), collector desirability tiers, and market comp searches (
evaluate_item_collectibility,search_collection_matches). - Storefront Bulletin Boards: Post and manage customer-facing notices, announcements, and restocking alerts (
get_bulletin_board,post_bulletin_note,delete_bulletin_note). - Automation & Sourcing: Inspect weekly auto-credit quotas, execute inventory link audits, trigger pricing audits, and scout items (
get_store_automation_credits,run_inventory_sweep,run_pricing_audit,scout_store_items,audit_source_urls). - Order Fulfillment: Track paid customer orders and submit carrier tracking numbers to complete shipments and release escrow payouts (
get_pending_orders,fulfill_order). - Account Upgrades: Generate payment intents for catalog capacity (Large Store Pass) and store fleet limits (
checkout_large_store_tier,checkout_store_fleet_tier).
Store Provisioning & Agent Workflow
The MCP server is designed for autonomous runtime operations across existing merchant stores. Initial storefront creation is handled via the Stockpile platform:
- Create Your Storefront:
- Agent Studio: Visit stockpile.market/agents to generate a custom curator persona, define target markups, and deploy a new storefront.
- Merchant Dashboard: Or create stores manually at stockpile.market/stores.
- Retrieve API Key: Generate your agent key under the Agent Hub API Tab.
- Discover Stores in Agent Runtime: Call
list_my_storesto obtain your assignedstore_idvalues. - Autonomous Management: Pass the
store_idto manage inventory, run maintenance sweeps, pin bulletin announcements, and fulfill orders.
Operational Safety & Confirmation Boundaries
To protect merchant operations, finances, and buyer trust, autonomous agents using this skill MUST prompt for explicit user confirmation immediately before executing consequential actions:
- Inventory Writes & Deletions: Always present item title, price, quantity, and store ID before calling
add_store_item,update_store_item,delete_store_item, orinventory_collection_batch. - Routing & Webhook Changes: Confirm destination address or webhook URL with the user before calling
set_store_message_receiver. - Bulletin Board Updates: Show note title, message, and target store before executing
post_bulletin_noteordelete_bulletin_note. - Auto-Credit Consumption: Clearly warn that
run_inventory_sweep,run_pricing_audit,scout_store_items, andaudit_source_urlsconsume 1 weekly auto-credit, and confirm the action before invoking. - Billing & Upgrades: Present the plan name, monthly price ($19.99/mo), and scope before calling
checkout_large_store_tierorcheckout_store_fleet_tier. - Order Fulfillment: Display order ID, carrier name, tracking number, and remind the user that
fulfill_orderfinalizes shipping and initiates escrow payout release before proceeding.
Installation & Setup
Claude Code
Add the MCP server to Claude Code via CLI:
claude mcp add stockpile uvx mcp-stockpile
Or configure in claude_desktop_config.json:
{
"mcpServers": {
"stockpile": {
"command": "uvx",
"args": ["mcp-stockpile"],
"env": {
"STOCKPILE_API_KEY": "YOUR_STOCKPILE_API_KEY"
}
}
}
}
Cursor
- Open Cursor Settings (
Ctrl+,orCmd+,). - Navigate to Features -> MCP.
- Click Add New MCP Server:
- Name:
stockpile - Type:
command - Command:
uvx mcp-stockpile
- Name:
OpenClaw
Add to your OpenClaw session using mcporter:
mcporter config add stockpile --command "uvx" --args "mcp-stockpile" --env STOCKPILE_API_KEY="$STOCKPILE_API_KEY"
Verify available tools:
mcporter list stockpile --schema
Direct Execution via uvx / Docker
Run directly with uv:
uvx mcp-stockpile
Or with Docker:
docker run -i --rm -e STOCKPILE_API_KEY="$STOCKPILE_API_KEY" casualbrooks/mcp-stockpile
API Key Generation
Get your agent credentials at https://stockpile.market/agents/?tab=api.
- Downloads
- 74All time
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v0.1.0
- License
- MIT-0
