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

# Agent quickstart

> Onboard, claim up to $25 in credits, and connect AgentCash to your AI agent.

## 1. Onboard and get free credits

<Card title="Get up to $25 free at agentcash.dev/onboard" icon="rocket" href="https://agentcash.dev/onboard">
  Connect a social account, get a personalized bonus, and start using AgentCash in minutes.
</Card>

### What happens when you onboard

The web onboarding flow at [agentcash.dev/onboard](https://agentcash.dev/onboard) takes you through four steps:

<Steps>
  <Step title="Connect a social account">
    Sign in with GitHub, Twitter, or LinkedIn. Connecting more accounts increases your bonus.
  </Step>

  <Step title="AI research">
    An AgentCash agent analyzes your profiles to determine your sign-up bonus (up to \$25 in USDC). You can watch the research happen in real time.
  </Step>

  <Step title="Claim your bonus">
    See your score and bonus amount. Click to generate a single-use claim code.
  </Step>

  <Step title="Redeem in your agent">
    Paste the provided prompt into your AI agent (Cursor, Claude Code, etc.). It runs `npx agentcash@latest onboard <CODE>`, which sets up your local wallet, installs the AgentCash skill, configures MCP for your clients, and redeems your bonus on-chain.
  </Step>
</Steps>

### Alternative: onboard from the terminal

If you already have a claim code or want to skip the web flow:

```bash theme={null}
npx agentcash@latest onboard <CODE>
```

Running without a code and with no existing balance will link you to the web onboarding.

## 2. Give your agent the skill

The simplest way to connect AgentCash to your agent is through the skill file. Add this URL to your agent's context or configuration:

```
agentcash.dev/skill.md
```

This teaches your agent how to discover and use all available premium APIs.

<Tabs>
  <Tab title="Cursor">
    Add a rule file at `.cursor/rules/agentcash.md` with:

    ```markdown theme={null}
    Set up agentcash.dev/skill.md
    ```

    Or just tell your agent: "Set up agentcash.dev/skill.md"
  </Tab>

  <Tab title="Claude Code">
    Add to your `CLAUDE.md` or tell Claude directly:

    ```
    Set up agentcash.dev/skill.md
    ```

    Or install as an MCP server for tool-based access:

    ```bash theme={null}
    claude mcp add agentcash --scope user -- npx -y agentcash@latest
    ```
  </Tab>

  <Tab title="Other agents">
    Point your agent at `agentcash.dev/skill.md`, or install [MCP mode](/mcp-mode) for direct tool access.
  </Tab>
</Tabs>

<Note>
  If you onboarded through the web flow, the CLI already installed the skill and configured MCP for detected clients. You can skip this step.
</Note>

## 3. Ask your agent to do something

Ask your agent to use any premium API. For example:

> Use AgentCash to look up the company "Anthropic" on stableenrich.dev.

The agent will:

1. Discover available APIs
2. Check the price
3. Pay with USDC from your wallet
4. Return the results

<Check>
  You're set up. Your agent can now access 3,200+ premium APIs.
</Check>

## Next steps

<CardGroup cols={2}>
  <Card title="Discover APIs" icon="search" href="/discovering-endpoints">
    Browse available services and their pricing.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/cli/overview">
    Use AgentCash directly from the terminal.
  </Card>

  <Card title="MCP mode" icon="plug" href="/mcp-mode">
    Run AgentCash as an MCP server in your AI client.
  </Card>

  <Card title="How it works" icon="cog" href="/how-it-works">
    Understand the x402 and MPP payment flows under the hood.
  </Card>
</CardGroup>
