> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machines.cash/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude

> Install the Machines plugin in Claude for balances, cards, deposits, and agentic payments.

The Machines plugin for Claude gives you a hosted MCP connection with OAuth login, built-in account guidance, and a local CLI fallback -- all without manual configuration.

## Prerequisites

* A Machines account with identity verification complete
* Claude desktop or web app

## Install the plugin

<video autoPlay muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/machines-cash/I1BFa-xHUeuEWlC-/videos/claude-plugin-install.mp4?fit=max&auto=format&n=I1BFa-xHUeuEWlC-&q=85&s=577fccfd795e17c72f486ccd3cf20a91" data-path="videos/claude-plugin-install.mp4" />

<Steps>
  <Step title="Add the Machines MCP server in Claude">
    Open Claude settings, go to MCP, and add a new integration. Paste this URL:

    ```text theme={null}
    https://mcp.machines.cash/claude
    ```
  </Step>

  <Step title="Connect and authorize">
    Start the connect flow, sign in on the Machines page, and approve access.
  </Step>

  <Step title="Verify it works">
    Ask Claude: `show my balance`
  </Step>
</Steps>

## Manual fallback

If the plugin is not visible yet, use the CLI to configure the MCP connection manually:

```bash theme={null}
npm i -g @machines-cash/cli
machines mcp install --host claude
machines mcp auth login
```

Or as a one-off:

```bash theme={null}
npx machines-cash@latest mcp install --host claude
npx machines-cash@latest mcp auth login
```

## Notes

* Claude may still guide you to the local CLI for login or KYC browser handoff
* For the full terminal workflow, see <a href="/cli">Machines CLI</a>

## Example prompts

* `show my balance`
* `list my active cards`
* `search apple airpods pro on amazon`
* `buy these apple airpods pro on amazon using my default card`
* `check the status of my latest purchase`

## Troubleshooting

| Problem                       | Fix                                                                |
| ----------------------------- | ------------------------------------------------------------------ |
| Plugin not listed             | Use the manual fallback above                                      |
| Connect flow failed           | Remove the Machines plugin and install it again                    |
| Still failing after reconnect | See <a href="/mcp-setup">MCP Setup</a> for generic troubleshooting |

## Next steps

* <a href="/mcp-setup">MCP Setup</a> -- generic setup, example prompts, and account safety tips
* <a href="/agentic-payments">Agentic Payments</a> -- one shared search, buy, status, confirm, and 3DS flow
* <a href="/cli">Machines CLI</a> -- full terminal workflow
* <a href="/raw-knowledge-file">Raw Knowledge File</a> -- improve Claude's Machines knowledge