Skip to main content

​
Quick Start

Get from zero to a working agent wallet connected via MCP. No blockchain knowledge required.

​
Prerequisites

  • A District Pass — if you don’t have one yet, sign up with just your email
  • An MCP-compatible client — Claude Desktop, Cursor, Windsurf, or any client that supports remote MCP servers
When you sign up for a District Pass, EVM and Solana wallets are created for you automatically. There’s no separate “create wallet” step.

​
Step 1: Sign Up for a District Pass

If you already have a District Pass from using another Finance District service, skip to Step 2.
  1. Go to fd.xyz and click Sign Up
  2. Enter your email address
  3. Enter the confirmation code sent to your inbox
  4. Done — your District Pass is active and your wallets are ready
That’s it. You now have EVM and Solana wallets provisioned and waiting.

​
Step 2: Fund Your Wallet

Your wallet exists but starts with a zero balance. To do anything useful, you need to add funds. For testing:
  • Use the Testnet Faucet to get free test tokens on supported testnets
For real transactions:
  • Transfer tokens from another wallet to your agent wallet address (visible in the Web App)
  • On-ramp via credit card through the Web App
Start small — the “pocket money” approach. Fund only what’s appropriate for what you’re testing. You can always add more later.

​
Step 3: Connect via MCP

The Agent Wallet MCP server is hosted at https://mcp.fd.xyz and uses the Streamable HTTP transport. Authentication is handled via OAuth PKCE — your MCP client will open a browser window for you to log in with your District Pass. Add the server to your MCP client configuration:
Edit your Claude Desktop config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "finance-district": {
      "type": "streamable-http",
      "url": "https://mcp.fd.xyz"
    }
  }
}
Restart Claude Desktop. On first connection, a browser window will open for you to authenticate with your District Pass.
The MCP server supports the Streamable HTTP transport protocol. No API keys or bearer tokens to manage — OAuth PKCE handles authentication automatically.
For other MCP clients, see MCP Compatible Clients.

​
Step 4: Try It Out

Once connected, your AI agent has access to all wallet capabilities. Try these: Check your balance:
“What’s the balance of my wallet?”
Get your wallet address:
“What’s my wallet address on Base?”
Send a transfer (testnet):
“Send 5 USDC to 0x1234…5678 on Base Sepolia”
Swap tokens:
“Swap 10 USDC for ETH”
Explore yield:
“What yield opportunities are available for my USDC?”
The agent discovers available capabilities automatically through the MCP protocol — it knows what tools are available and how to use them.

​
What’s Next?

MCP Server

Full MCP server documentation and capabilities reference

FDX CLI

Command-line interface for autonomous agent workflows

Wallet Architecture

EOA → Smart Account → Delegated wallet progression

Security Model

How TEE protects your keys

X402 Payments

Let your agent pay Prism merchants

Example Prompts

Ready-to-use prompts for common wallet operations