> ## 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.

# Connect Hoard to Claude

> Talk to your Hoard inventory in plain English from Claude.ai or the Claude desktop app.

Once Hoard is connected to Claude, you can ask things like "what are my top movers today?" or "tighten my Modern pricing rules" and Claude will look up the answer (or make the change) using your real Hoard data.

## What you'll need

* A paid plan ([Gold, Platinum, or Diamond](https://www.tryhoard.com/pricing))
* A Claude account (claude.ai web or the Claude desktop app)

## Steps

<Steps>
  <Step title="Open Claude's connector settings">
    In Claude.ai or the Claude desktop app, open **Settings → Connectors → Add custom connector**.
  </Step>

  <Step title="Paste the Hoard MCP URL">
    Paste this URL into the connector field:

    ```text theme={null}
    https://mcp.tryhoard.com/mcp
    ```

    Give it a name like "Hoard" and click **Connect**.
  </Step>

  <Step title="Sign in to Hoard">
    Claude will pop open a Hoard sign-in window. Sign in like you normally would, then click **Allow** on the consent screen.

    You're not pasting an API key — Claude and Hoard handle the handshake via OAuth. The connection is scoped to your account and you can revoke it any time from [Settings → Assistants](https://www.tryhoard.com/settings/connected-apps).
  </Step>

  <Step title="Try it out">
    Back in Claude, ask:

    > "What are my top 5 movers in Magic right now?"

    Claude will use Hoard's tools to pull live data from your account.
  </Step>
</Steps>

## What Claude can do

Claude can use Hoard to:

* Look up inventory, prices, and individual cards
* Show top movers, sleepers, and recent sales
* Read pricing rules and propose changes
* Preview a repricing run before you commit it
* Trigger an inventory sync
* Read orders, refunds, and customer data
* Edit a single pricing rule through a preview→confirm→commit flow (with your permission)

For the honest map of what's exposed today versus what's still dashboard-only, see [What your AI assistant can do](/agent-capabilities).

## When Claude wants to change something

Read-only questions ("what's my inventory value", "show me movers") return data instantly with no extra steps.

When Claude wants to **change** something (today that means editing a pricing rule; more write actions are coming), Hoard puts it through a three-layer safety check before anything commits:

1. **Your permission policy** — by default, the assistant must ask before any change. These permission modes are seeded when you turn on assistant access; per-action customization in Settings is on the roadmap.
2. **Server-side risk scoring** — Hoard classifies the specific change as low/medium/high/critical based on what it would actually do. By default nothing commits without an explicit confirmation.
3. **Hard floors** — no listed price can ever drop below \$0.01 (or your per-card minimum), no single rule edit can drop your total listed inventory value by more than 30%, no chat session can cumulatively drop it by more than 20% in an hour. These are unconditional.

In practice: Claude shows you the preview, you click a confirmation link, the change applies, and your audit log gets a row recording exactly what happened. See [Agent permissions and safety](/agent-permissions) for the full mechanic.

## Revoking access

Open [Settings → Assistants](https://www.tryhoard.com/settings/connected-apps) in Hoard. Click **Revoke** next to Claude. Claude immediately loses access — it can't refresh its way back in.

## Troubleshooting

**Claude says "Connector failed to connect"**
Make sure you pasted `https://mcp.tryhoard.com/mcp` exactly, including the trailing `/mcp`.

**Sign-in window flashes and closes**
Disable popup blockers for `claude.ai`, then try again.

**Claude can't see my inventory**
You're signed into Claude and Hoard with different email accounts? The connection is scoped to whichever Hoard account approved it. Reconnect with the right account.