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

# Quick Start

> Get your agent trading in under 5 minutes.

<CardGroup cols={3}>
  <Card title="Web App" icon="globe" href="#web-app">
    Trade directly at aiusd.ai. No setup required.
  </Card>

  <Card title="Telegram Bot" icon="paper-plane" href="#telegram-bot">
    Trade from Telegram. Message @aiusd\_ai\_bot to start.
  </Card>

  <Card title="AIUSD Core" icon="bolt" href="#aiusd-core">
    Structured CLI tools for AI agents. No platform inference cost.
  </Card>

  <Card title="AIUSD Pro" icon="comments" href="#aiusd-pro">
    AI agent skill with built-in reasoning. Best for OpenClaw, Claude Code, Codex, and Cursor.
  </Card>

  <Card title="MCP Hub API" icon="code" href="#mcp-hub-api">
    Direct JSON-RPC 2.0 for custom agent builds.
  </Card>
</CardGroup>

***

## Web App

The fastest way to start. No installation, no CLI — just open [aiusd.ai](https://aiusd.ai) and trade.

<Steps>
  <Step title="Open aiusd.ai">
    Go to [aiusd.ai](https://aiusd.ai) and connect your wallet or create a new account.
  </Step>

  <Step title="Deposit">
    Send USDC or USDT on any supported chain. Your balance is credited as AIUSD instantly.
  </Step>

  <Step title="Trade">
    Type what you want to do in natural language — the built-in AI agent handles the rest.
  </Step>
</Steps>

***

## Telegram Bot

Trade from any Telegram conversation. No app to install, no wallet extension needed.

<Steps>
  <Step title="Open the bot">
    Message [@aiusd\_ai\_bot](https://t.me/aiusd_ai_bot) on Telegram.
  </Step>

  <Step title="Create account or sign in">
    The bot walks you through authentication — create a new wallet or link an existing one.
  </Step>

  <Step title="Trade">
    Send messages like "Buy \$100 of SOL", "Long ETH 10x", or "What's my balance?" — the bot executes directly.
  </Step>
</Steps>

***

## AIUSD Core

For agents that handle their own reasoning. Install the skill, authenticate, and start calling structured commands.

<Steps>
  <Step title="Install">
    <Tabs>
      <Tab title="Claude Code / Codex / Cursor">
        ```bash theme={null}
        npx skills add galpha-ai/aiusd-core -y -g
        ```
      </Tab>

      <Tab title="npm">
        ```bash theme={null}
        npm install -g aiusd-core
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Authenticate">
    ```bash theme={null}
    aiusd login --browser
    ```

    A browser window opens. Sign in or create a new account — the CLI picks up the session automatically.
  </Step>

  <Step title="Trade">
    ```bash theme={null}
    aiusd balances                                      # Check account
    aiusd guide spot                                    # Get command reference
    aiusd spot buy -b SOL -a 100                        # Buy $100 of SOL
    aiusd perp long --asset ETH --size 0.1 --leverage 10  # Long ETH 10x
    ```
  </Step>
</Steps>

<Card title="Full Core Reference" icon="book" href="/skills#aiusd-core">
  All commands, domains, and configuration
</Card>

***

## AIUSD Pro

For agents that want a turnkey experience. Send natural language — the backend handles reasoning, tool selection, and execution.

<Steps>
  <Step title="Install">
    <Tabs>
      <Tab title="Claude Code / Codex / Cursor">
        ```bash theme={null}
        npx skills add galpha-ai/aiusd-pro -y -g
        ```
      </Tab>

      <Tab title="npm">
        ```bash theme={null}
        npm install -g aiusd-pro
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Authenticate">
    ```bash theme={null}
    aiusd-pro login --browser
    ```
  </Step>

  <Step title="Trade">
    ```bash theme={null}
    aiusd-pro send "What's my balance?"
    aiusd-pro send "Buy $100 of SOL"
    aiusd-pro send "Long ETH 10x"
    aiusd-pro send "If BTC drops below $60k, sell everything"
    ```

    The backend agent processes your intent, executes the trade, confirms the transaction, and streams the result back.
  </Step>
</Steps>

<Card title="Full Pro Reference" icon="book" href="/skills#aiusd-pro">
  How it works, session management, and capabilities
</Card>

***

## MCP Hub API

For developers building custom agents. Connect directly to the AIUSD execution layer via Model Context Protocol.

<Steps>
  <Step title="Get API access">
    | Environment | Endpoint                                |
    | ----------- | --------------------------------------- |
    | Production  | `https://mcp.alpha.dev/api/mcp-hub/mcp` |
    | Development | `https://dev.alpha.dev/api/mcp-hub/mcp` |

    <Note>
      Authentication required. Contact support for API access.
    </Note>
  </Step>

  <Step title="Connect your agent">
    <Tabs>
      <Tab title="Claude Desktop">
        Add to `claude_desktop_config.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "aiusd": {
              "url": "https://mcp.alpha.dev/api/mcp-hub/mcp",
              "transport": "http",
              "headers": {
                "Authorization": "Bearer YOUR_TOKEN"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Anthropic SDK">
        ```typescript theme={null}
        import Anthropic from "@anthropic-ai/sdk";

        const client = new Anthropic();

        const response = await client.messages.create({
          model: "claude-sonnet-4-6-20250514",
          max_tokens: 1024,
          tools: [{
            type: "custom",
            name: "mcp",
            mcp_server: {
              url: "https://mcp.alpha.dev/api/mcp-hub/mcp",
              transport: "http",
              headers: {
                "Authorization": "Bearer YOUR_TOKEN"
              }
            }
          }],
          messages: [{
            role: "user",
            content: "Buy $100 of SOL"
          }]
        });
        ```
      </Tab>

      <Tab title="cURL">
        ```bash theme={null}
        curl -X POST https://mcp.alpha.dev/api/mcp-hub/mcp \
          -H "Content-Type: application/json" \
          -H "Authorization: Bearer YOUR_TOKEN" \
          -d '{
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/list"
          }'
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>

<Card title="API Reference" icon="terminal" href="/api">
  Full tool reference and response formats
</Card>

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Trading Guide" icon="chart-line" href="/trading">
    All supported trading operations
  </Card>

  <Card title="Example Strategies" icon="lightbulb" href="/examples">
    Ready-to-deploy bot strategies
  </Card>

  <Card title="Architecture" icon="building" href="/architecture">
    How the platform works
  </Card>
</CardGroup>