Quick Start - Finance District Developer Hub

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.

Claude Desktop
Claude Code
Cursor
Any MCP-compatible client

Add to Claude

Opens Claude Desktop’s connector settings

Or add manually:

Open Customize → Connectors → Add custom connector

In Claude Desktop, go to Settings → Customize → Connectors, click + and select Add custom connector.

Fill in the connector

Name: Finance District
Remote MCP server URL: https://wallet-mcp.fd.xyz

Click Add, then Connect

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

Install Claude Code — follow the official guide and confirm it works:
```
claude --version
```
Create a District Pass account — sign up at 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):

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:

claude mcp add --transport http --scope user finance-district https://wallet-mcp.fd.xyz

Verify the server is registered:

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

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

Open Cursor Settings → MCP Servers → Add new server and paste:

{
  "mcpServers": {
    "finance-district": {
      "type": "streamable-http",
      "url": "https://wallet-mcp.fd.xyz"
    }
  }
}

Restart Cursor.

For any MCP-compatible client (Windsurf, n8n, custom agents), add this configuration:

{
  "mcpServers": {
    "finance-district": {
      "type": "streamable-http",
      "url": "https://wallet-mcp.fd.xyz"
    }
  }
}

See MCP Compatible Clients for client-specific config file paths, Windsurf and n8n setup, and custom MCP client integration (CIMD / DCR).

On first connection, your browser opens for OAuth authorization. Sign in with your 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.

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.

For the best agent experience, optionally add the Agent Wallet Skills to your client. Skills give the agent curated prompt templates and pre-built workflows for common wallet operations — transfers, swaps, yield, and more.

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

Start with a small amount to experiment and verify your agent’s behavior before scaling up.

What’s Next?

FDX CLI

Full CLI reference and agent framework integration

Agent Skills

Drop-in skills for 40+ agentic platforms

MCP Server

Full MCP server documentation and capabilities

X402 Payments

Let your agent pay for services automatically

Supported Networks

Ethereum, Base, Arbitrum, BSC, Solana, Bitcoin, Sui

Security Model

Non-custodial architecture with TEE key protection

​Connect Your AI Agent

Add to Claude

​Prerequisites

​How to add

​What to do after adding

​Verify

​Try It Out

​What’s Next?

FDX CLI

Agent Skills

MCP Server

X402 Payments

Supported Networks

Security Model

Connect Your AI Agent

Prerequisites

How to add

What to do after adding

Verify

Try It Out

What’s Next?