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

# Quick Start

> Get a non-custodial agent wallet in under 2 minutes. No blockchain knowledge required.

Get from zero to a working agent wallet in under 2 minutes. No blockchain knowledge, no seed phrases. Just your email.

## Connect Your AI Agent

Add the Finance District MCP server to your AI client. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

<Tabs>
  <Tab title="Claude Desktop">
    <Card title="Add to Claude" icon="plus" href="https://claude.ai/customize/connectors" horizontal>
      Opens Claude Desktop's connector settings
    </Card>

    Or add manually:

    <Steps>
      <Step title="Open Customize → Connectors → Add custom connector">
        In Claude Desktop, go to **Settings → Customize → Connectors**, click **+** and select **Add custom connector**.
      </Step>

      <Step title="Fill in the connector">
        * **Name:** `Finance District`
        * **Remote MCP server URL:** `https://wallet-mcp.fd.xyz`
      </Step>

      <Step title="Click Add, then Connect">
        Sign in with your **District Pass** when prompted and authorize access.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    Connect your Finance District Agent Wallet to **Claude Code** so the agent can check balances, transfer tokens, swap, earn yield, and make x402 payments — directly from your terminal or IDE sessions.

    ### Prerequisites

    1. **Install Claude Code** — follow the [official guide](https://docs.anthropic.com/en/docs/claude-code/overview) and confirm it works:
       ```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
       claude --version
       ```
    2. **Create a District Pass account** — sign up at [apps.fd.xyz](https://apps.fd.xyz/). You'll use it to authorize the wallet connection.

    ### How to add

    Run the command in your **terminal** (PowerShell, bash, or zsh):

    ```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    claude mcp add finance-district --transport http https://wallet-mcp.fd.xyz
    ```

    To make the wallet available across **all** your projects, add the user scope:

    ```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    claude mcp add --transport http --scope user finance-district https://wallet-mcp.fd.xyz
    ```

    Verify the server is registered:

    ```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    claude mcp list
    ```

    `finance-district` will appear as `! Needs authentication`. This is expected — registering only adds the server; it does **not** sign you in yet.

    ### What to do after adding

    1. **Authenticate** — start Claude Code (`claude`), then either:
       * Run `/mcp` inside the session, select **finance-district**, and choose **Authenticate**, or
       * Simply ask the agent to use a wallet tool — the browser OAuth flow triggers on first use.
    2. **Authorize with District Pass** — your browser opens for OAuth authorization. Sign in and authorize access. The status flips to `✔ Connected` and the session persists across restarts.
    3. **Test it** — ask the agent:

       > What Finance District wallet tools do you have? Call `getMyInfo` to show my account.

       You should see the wallet tools listed and your account details returned.
  </Tab>

  <Tab title="Cursor">
    Open **Cursor Settings → MCP Servers → Add new server** and paste:

    ```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    {
      "mcpServers": {
        "finance-district": {
          "type": "streamable-http",
          "url": "https://wallet-mcp.fd.xyz"
        }
      }
    }
    ```

    Restart Cursor.
  </Tab>

  <Tab title="Any MCP-compatible client">
    For any MCP-compatible client (Windsurf, n8n, custom agents), add this configuration:

    ```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    {
      "mcpServers": {
        "finance-district": {
          "type": "streamable-http",
          "url": "https://wallet-mcp.fd.xyz"
        }
      }
    }
    ```

    See [MCP Compatible Clients](/agent-wallet/ai-integration/mcp-clients) for client-specific config file paths, Windsurf and n8n setup, and custom MCP client integration (CIMD / DCR).
  </Tab>
</Tabs>

On first connection, your browser opens for OAuth authorization. Sign in with your [District Pass](/overview/district-pass) (if you aren't already) and authorize the client to access your Finance District account. Once authorized, the connection persists across sessions.

For client-specific setup instructions, see [MCP Compatible Clients](/agent-wallet/ai-integration/mcp-clients).

## Verify

Ask your agent:

> "Connect to Finance District MCP and show me my wallet information."

The agent should return your wallet addresses across all supported chains. Then try:

> "What's my wallet balance?"

If you see your balances (even if zero), you're fully connected.

<Tip>
  For the best agent experience, optionally add the [Agent Wallet Skills](/agent-wallet/ai-integration/agent-skills) to your client. Skills give the agent curated prompt templates and pre-built workflows for common wallet operations — transfers, swaps, yield, and more.
</Tip>

## Try It Out

Once set up, your agent can:

* **Check balances** across Ethereum, Base, Arbitrum, BSC, Solana, Bitcoin, and Sui
* **Send tokens** to any address on any supported chain
* **Swap tokens** via decentralized exchanges
* **Earn yield** through integrated DeFi protocols
* **Pay for services** via the [x402 payment protocol](/agent-wallet/concepts/x402-payments)

<Tip>
  Start with a small amount to experiment and verify your agent's behavior before scaling up.
</Tip>

## What's Next?

<CardGroup cols={2}>
  <Card title="FDX CLI" icon="terminal" href="/agent-wallet/ai-integration/cli">
    Full CLI reference and agent framework integration
  </Card>

  <Card title="Agent Skills" icon="wand-magic-sparkles" href="/agent-wallet/ai-integration/agent-skills">
    Drop-in skills for 40+ agentic platforms
  </Card>

  <Card title="MCP Server" icon="server" href="/agent-wallet/ai-integration/mcp-server">
    Full MCP server documentation and capabilities
  </Card>

  <Card title="X402 Payments" icon="cart-shopping" href="/agent-wallet/concepts/x402-payments">
    Let your agent pay for services automatically
  </Card>

  <Card title="Supported Networks" icon="globe" href="/agent-wallet/supported-networks">
    Ethereum, Base, Arbitrum, BSC, Solana, Bitcoin, Sui
  </Card>

  <Card title="Security Model" icon="shield-halved" href="/agent-wallet/concepts/security">
    Non-custodial architecture with TEE key protection
  </Card>
</CardGroup>