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

# Agent Skills

> Install a local Machines MCP configuration for Codex and Claude, including agentic payments.

The Machines agent skill package installs a local MCP configuration for Codex and Claude. Use this when you need terminal-based setup or want to configure multiple AI hosts at once.

<Tip>For Claude, the <a href="/claude-plugin">Machines plugin</a> is simpler. For hosted connections without local installs, use <a href="/mcp-setup">MCP Setup</a>.</Tip>

## Prerequisites

* Node.js 18+
* Codex and/or Claude installed locally
* A Machines account

## Setup

<Steps>
  <Step title="Install for your AI host">
    ```bash theme={null}
    npx @machines-cash/agent-skill install --host both
    ```

    Or install for one host only:

    ```bash theme={null}
    npx @machines-cash/agent-skill install --host codex
    npx @machines-cash/agent-skill install --host claude
    ```
  </Step>

  <Step title="Log in">
    ```bash theme={null}
    npx @machines-cash/agent-skill auth login
    ```

    Approve access in your browser.
  </Step>

  <Step title="Confirm connection">
    Open Codex or Claude and verify that Machines is connected.
  </Step>
</Steps>

## Commands reference

```bash theme={null}
npx @machines-cash/agent-skill install --host both           # install for both hosts
npx @machines-cash/agent-skill install --host codex          # Codex only
npx @machines-cash/agent-skill install --host claude         # Claude only
npx @machines-cash/agent-skill auth login                    # browser login
npx @machines-cash/agent-skill auth login --manual-key       # manual login fallback
npx @machines-cash/agent-skill doctor                        # health check
```

## Example prompts

Once installed, try:

* `show my balance`
* `list my 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`

## Install location

```text theme={null}
~/.codex/skills/machines-agent-skills
~/.claude/skills/machines-agent-skills
```

## Troubleshooting

| Problem                     | Fix                                                          |
| --------------------------- | ------------------------------------------------------------ |
| Login window didn't open    | Use `--manual-key` flag for manual login                     |
| Not connected after install | Run `doctor` to diagnose the issue                           |
| Still failing               | Remove the Machines connection and run install + login again |

## Next steps

* <a href="/cli">Machines CLI</a> -- login, KYC, cards, and deposits from the terminal
* <a href="/agentic-payments">Agentic Payments</a> -- one shared search, buy, status, confirm, and 3DS flow
* <a href="/mcp-setup">MCP Setup</a> -- hosted MCP connections and account safety
* <a href="/raw-knowledge-file">Raw Knowledge File</a> -- add context for better AI responses