Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryhoard.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What your AI assistant can do

Once you’ve connected Claude, ChatGPT, or Codex, the assistant gets a scoped read of your Hoard store and can run carefully-gated changes. This page is the honest map: what’s exposed today, what’s not, and how to set expectations when you ask a question.

​
What an assistant can read

These are safe to ask any time. The assistant pulls live data from your account; nothing changes. Your inventory at a glance
  • “What’s my total listed inventory value?”
  • “Break down my listed value by game.”
  • “How many cards do I have, and how many are flagged as underpriced?”
  • “Walk me through my top 10 most valuable cards.”
  • “Show me cards with the biggest gap between my listed price and market.”
Pricing rules
  • “What pricing rules do I have active?”
  • “Which rule covers the most cards?”
  • “Preview what would happen if I bumped my Mythic rule from 1.20x to 1.25x.”
Movers and price changes
  • “Show me my biggest gainers in the last 7 days.”
  • “Any cards in my store flagged with ‘spike’ volatility?”
  • “What were my biggest price losers this week?”
Sales and revenue
  • “What was my revenue last month?”
  • “How are fees trending? Has TCGplayer’s rate moved?”
  • “Show me my last 3 months of orders + net-after-fees.”
Customers
  • “Who are my repeat customers?”
  • “What percentage of my revenue comes from my top 10 buyers?”
  • “Has anyone bought from me more than twice?”
Sync status
  • “When did the agent last sync?”
  • “Is a sync in progress right now?”
  • “Trigger a sync.”

​
What an assistant can change (with permission)

Hoard treats every write action through a preview → confirm → commit flow with server-side safety checks. The assistant never directly mutates your store on a single call — it always shows you what would happen first. Today (May 2026):
  • Edit a single pricing rule. Change the multiplier, toggle never-go-down, switch the price source. The assistant calls preview first, you see the projected impact + risk classification, and (depending on your permission settings) either auto-commits low-risk edits or asks you to click a confirmation link.
Coming soon (filed in the roadmap, not shipped yet):
  • Mass reprice through the same plan-token flow
  • Per-card price overrides
  • Running a discount sale
  • Toggling pricing rules on or off
See Agent permissions and safety for how the gating works.

​
What an assistant can’t do today

The honest list. These are dashboard-only as of May 2026:
  • Adding new inventory. Quick Add, voice match, paste-list signup flow — all dashboard-only.
  • Changing any account settings. Password, timezone, notification preferences, pricing template, product line selection, shipping adder — dashboard-only.
  • Managing pull sessions. The assistant can start a session, but viewing it, picking through it, deferring, or completing — all dashboard-only.
  • Manual per-card price overrides. Lock a price, clear a lock — dashboard-only.
  • Consignment. Creating consignors, assigning cards, payouts, share links — dashboard-only.
  • Accepting / rejecting Smart Actions recommendations. Dashboard-only.
  • Triggering or downloading rollbacks. Dashboard-only.
  • CSV imports or exports. Dashboard-only.
This isn’t because we couldn’t expose them — it’s that we want the AI surface to start with the read-mostly + heavily-gated write path before opening up everything. Each new capability gets the same preview→confirm→commit + risk-gating + audit log treatment.

​
How an assistant figures out what to do

Under the hood, Hoard exposes two tools to your assistant: hoard_search (find capabilities by keyword) and hoard_execute (run a small program against the SDK). The assistant writes a tiny JavaScript snippet, runs it once, and surfaces the result. This is called “code mode” — it lets the assistant compose multiple data fetches in a single round trip instead of taking one tool call per question. You don’t need to know any of that to use it. You ask in plain English; the assistant figures out the JS. But it explains why the same question sometimes feels instant (one call) and sometimes feels chunkier (multiple calls when the question needs cross-referencing data).

​
Setting expectations: “I sell Lorcana / One Piece / Riftbound”

Claude and other large models have deep knowledge about Magic: The Gathering and decent knowledge about Pokemon. Knowledge of newer games (Lorcana, One Piece, Riftbound, Flesh & Blood, Star Wars Unlimited, Digimon, Pokemon Japan) is thinner — most of these games didn’t exist or weren’t well-covered when the models were trained. What this means in practice: your assistant can reliably reason about your actual data for any game (your prices, your movers, your sales, your rules), but it should ask before making strong claims about market norms for games where its training is thin. If you’re a Lorcana-focused seller and your assistant says “Lorcana commons typically run $0.10–0.50,” treat that as a guess unless it’s backed by your own data. A pattern that works well: ground your assistant in your own inventory by starting a chat with something like “I sell mostly Lorcana, here’s a snapshot of my store” and let it run the read-side queries first. Reasoning improves a lot once it’s calibrated to your data instead of generic priors.

​
Revoking access

Open Settings → Connected apps. Click Revoke next to whichever assistant you want to disconnect. The assistant immediately loses access — it can’t refresh its way back in. Any in-flight preview that hadn’t been committed is also dead. You can re-connect any time by following the connect guide again.