Collection Vault MCP

Full CRUD collectible collection management with persistent SQLite storage, sub-collections, value history, web search valuations, insurance export, and deal alerts.

Supported types: Coins, Trading Cards, Bullion, Stamps, Comics, and any collectible.

Monetization: Subscription on MCPize. PPE fallback on Apify.

Requires: ANTHROPIC_API_KEY (for lookup_value web search tool only)

---

Tools

Tool	Description
add_item	Add any collectible to the vault
get_item	Retrieve item by ID with value history
update_item	Update any item fields
remove_item	Permanently delete an item
list_collection	List/search/filter with pagination
create_sub_collection	Create named group (e.g. "Morgan Dollars")
assign_to_sub_collection	Add item to a group
get_collection_stats	Summary stats, totals, most valuable
lookup_value	Web search market value → updates item
mark_sold	Record sale with realized gain calc
export_insurance	Insurance-ready inventory export
get_deal_alerts	Price drop alerts (last 7 days)

---

Setup

cd collection-vault
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
export ANTHROPIC_API_KEY="sk-ant-..."
python run_server.py

Server starts on http://localhost:4321/mcp

Optional: Custom DB path

$export VAULT_DB_PATH="/path/to/vault.db"

---

Testing

from server import add_item, list_collection, get_collection_stats, lookup_value

# Add a coin
result = add_item(
    user_id="brian",
    name="1921 Morgan Dollar",
    collection_type="coin",
    year=1921,
    denomination="Dollar",
    mint_mark="D",
    composition="90% silver",
    condition_raw="VF-30",
    purchase_price=45.00,
    purchase_source="LCS",
    notes="Nice luster, minor bag marks",
)
item_id = result["item_id"]

# Add a Pokémon card
result = add_item(
    user_id="gavin",
    name="Charizard",
    collection_type="card",
    card_set="Base Set",
    card_number="4/102",
    card_rarity="Holo Rare",
    card_variant="Shadowless",
    condition_raw="Near Mint",
    purchase_price=350.00,
)

# List all of brian's coins
coins = list_collection(user_id="brian", collection_type="coin")
print(f"Total coins: {coins['total_count']}")

# Look up market value
value = lookup_value(user_id="brian", item_id=item_id)
print(f"Estimated value: ${value['estimated_value']}")

# Get stats
stats = get_collection_stats(user_id="brian")
print(f"Total collection value: ${stats['totals']['total_value_usd']}")

# Export insurance doc
report = export_insurance(user_id="brian", min_value=50)
print(f"Insurance items: {report['report']['total_items']}")
print(f"Total declared value: ${report['report']['total_declared_value_usd']}")

# Create sub-collection
sub = create_sub_collection(
    user_id="brian",
    name="Morgan Dollars",
    collection_type="coin",
    description="Complete Morgan Dollar type set"
)
assign_to_sub_collection(user_id="brian", item_id=item_id, sub_collection_id=sub["sub_collection_id"])

---

Deploy to Apify

rm -rf venv
apify push

Set ANTHROPIC_API_KEY in Apify Console → Source → Environment Variables (mark as secret). Re-enable Actor Standby after push. Enable MCP Server in Publication settings.

Claude Desktop config

{
  "mcpServers": {
    "collection-vault": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mowell-labs--collection-vault.apify.actor/mcp?token=YOUR_APIFY_TOKEN"]
    }
  }
}

---

Data Persistence Note

SQLite is stored at /tmp/collection_vault.db by default. On Apify Standby, data persists as long as the container stays warm. For guaranteed persistence, set VAULT_DB_PATH to a mounted volume or use Apify's key-value store (requires code modification).

For production MCPize deployment, run on your own infrastructure with a persistent volume.

---

PPE Events (Apify fallback)

Event	Price
item-write	$0.005
item-read	$0.002
value-lookup	$0.03
insurance-export	$0.01

---

License

MIT — Mowell Labs 2025