Skip to main content

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.

​
Getting Started

Get started at: https://apps.fd.xyz/
  1. Sign up → get your District Pass
  2. Choose your integration method
  3. Connect your agent or start using the CLI
  4. Get your agent wallet address and transfer funds from your regular crypto wallet (MetaMask, Coinbase, etc.)
💡 Start small with Agent Wallet — $10–50 for testing. Your agent can only spend funds you deposit. Scale as trust grows.
District Pass is the Web3 identity layer for Finance District. Verify once — move securely across wallets, payments, and apps.What it does:
  • 🔑 Universal access — One login for all Finance District products
  • 🔗 Persistent wallet — Your identity linked to your wallet(s)
  • 🤖 Agent identity — Links your agents to you
Do I need separate accounts for each product? No. One District Pass = access to all Finance District solutions.Is it secure? Yes. Built on OAuth 2.0 + OpenID Connect. Short-lived tokens, not passwords.Get yours: https://apps.fd.xyz/
ProductWhat It DoesGet Started
Agent WalletWallet for your AI agentsapps.fd.xyz
CLITerminal-based wallet accessCLI Docs
MCP ServerConnect MCP-compatible agentsMCP Server Docs
PrismAccept payments from agentsPrism Overview
Estimated setup times:
  • CLI: 5 min
  • MCP Server: 5 min
  • Agent Wallet (Web): Instant
  • Prism: 15–30 min

​
Agent Wallet

Agent Wallet is AI-native wallet infrastructure that gives your AI agents their own wallets — not borrowed access to yours.Key features:
  • AI-Autonomous Transactions
  • MCP-Native (works with Claude, GPT-4, etc.)
  • CLI with 15+ MCP tools
  • TEE-Secured keys
  • x402 Payments
  • EVM + Solana wallets auto-provisioned
Four interfaces, one wallet:
InterfaceBest For
MCP ServerAI agents
CLIDevelopers & automation
AI AssistantNon-technical users
Web AppOperators
FeatureRegular Crypto WalletDIYAgent Wallet
AutonomyBorrowedBasicGenuine
24/7 Operation❌ Human needed⚠️ Insecure✅ Secure
MCPBuild adapterManualBuilt-in
Key securityHuman keysEnv varsTEE enclave
Commerce protocols❌Build itx402, ACP, UCP
SetupComplexDays/weeks5 minutes
  • Regular crypto wallets — great for humans, but require approval popups for every transaction
  • DIY — insecure; one leaked env var and funds are gone
  • Agent Wallet — genuine autonomy, production-ready from day one
Agent Wallet supports 3 wallet types — choose based on your needs:
TypeDescriptionBest For
EOA WalletStandard externally-owned accountMost use cases, simple setup, low cost
Smart AccountContract-based with programmable logicBatch transactions, custom rules, automation
Delegated WalletFine-grained access controlEnterprise, multi-sig, team permissions
Recommendation: Start with an EOA Wallet — it covers most use cases. Move to Smart Account or Delegated Wallet when you need advanced features.
Core operations:
  • 💰 Hold & Manage — Multi-chain assets, portfolio view
  • 📤 Transfer — Send/receive tokens
  • 🔄 Swap — Exchange token pairs
  • 📈 Earn Yield — Discover & deploy strategies
  • 🛒 Pay Merchants — x402, ACP, UCP protocols
Available MCP tools: getWalletOverview · transferTokens · swapTokens · discoverYieldStrategies · depositForYield · withdrawFromYield · authorizePayment · getX402Content · getTokenPrice · getAccountActivity · resolveNameService · signMessage · getMyInfo · reportIssue
Yes. That’s the core difference.Regular crypto wallet at 3 AM: Agent finds opportunity → popup appears → you’re asleep → opportunity expires ❌Agent Wallet at 3 AM: Agent finds opportunity → checks parameters → executes → you wake up to a summary ✅Your agent has its own wallet and operates within boundaries you set — no per-transaction approval needed.
Supported assets:
  • ✅ EVM tokens (FDUSD, USDC, DAI, ERC-20s)
  • ✅ Solana tokens (SPL)
  • ✅ Bitcoin (BTC)
All wallets are auto-provisioned at signup across EVM, Solana, and Bitcoin networks.
The CLI provides command-line access to all wallet capabilities.What you can do:
  • Execute payments & transfers
  • Manage wallets programmatically
  • Script automated workflows
  • Server-side automation
The CLI provides access to 15+ MCP tools across wallet and Prism services. Use fdx wallet <method> for wallet operations and fdx prism <method> for payment operations.Get started: CLI Docs

​
AI & MCP

MCP (Model Context Protocol) is a standardized way for AI models to communicate with external tools.Why it matters:
  • Zero integration code needed
  • LLMs understand MCP natively
  • Agents auto-discover wallet capabilities
  • Works with Claude, GPT-4, LangChain, CrewAI, and more
  • One setup works for all your agents
Without MCP: Hundreds of lines of middleware code With MCP: Point your agent at a URL. Done.Learn more: MCP Server
The AI Assistant uses models that have regional restrictions in some areas.If you’re blocked, use these globally available alternatives:
InterfaceAvailability
CLI✅ Global
MCP Server✅ Global
Web App✅ Global
AI Assistant⚠️ Regional restrictions
Recommended: Use the CLI for full functionality worldwide. CLI Docs

​
Payments & Protocols

Agent Wallet is the buyer-side product (your agent’s wallet). Prism is the seller-side payment gateway for merchants.
ProductRole
Agent WalletAgents that spend
PrismMerchants that receive
Together: Agent Wallet shops → Prism accepts payment. Independently: Each works with other wallets and merchants.Learn more: Prism Overview
x402 is an HTTP-native payment protocol for machine-to-machine commerce.Use cases:
  • Pay-per-use API access
  • Agent-to-agent service payments
  • Micropayments for data, compute, or content
  • Automated subscription & recurring payments
  • Real-time settlement between services
How it works:
  1. Agent requests a paid resource or service
  2. Server returns HTTP 402 + payment requirements
  3. Agent wallet pays instantly (on-chain)
  4. Server delivers the resource
  5. Settlement confirmed ✅
Why x402 matters:
  • Micropayments down to fractions of a cent
  • No subscriptions required — pay exactly what you use
  • Instant, verifiable settlement
  • Zero chargebacks or disputes
  • Fully autonomous — no human approval needed
Learn more: x402 Protocol

​
Setup & Integration

Agent Wallet gives your AI agents their own wallets.
  1. Register with District Pass at apps.fd.xyz
  2. Choose your integration:
    • MCP Server → For Claude, ChatGPT, and MCP-compatible agents
    • CLI → For terminal, scripting, and automation
  3. Connect to Agent Skills for expanded capabilities
Resources:
Prism lets you accept payments from AI agents (merchant/seller side).
  1. Register with District Pass at apps.fd.xyz
  2. Go to the Prism Console
  3. Get your API Keys
  4. Integrate using the Prism SDK or API
Resources:Accept payments from AI agents with instant settlement and zero chargebacks.
MethodSetup TimeBest For
MCP Server5 minClaude, ChatGPT, MCP agents
CLI5 minTerminal, scripting, automation
REST API30 minCustom apps, non-MCP
Python SDK15 minPython projects
JS/TS SDK15 minNode.js/TypeScript
Recommendation:
  • MCP-compatible agent? → MCP Server
  • Terminal workflows? → CLI
  • Custom agent? → SDK
  • Full control? → REST API
Use the production environment with small amounts. The API, MCP, and SDK work identically regardless of transaction size. This lets you validate the full end-to-end flow — including real on-chain settlement.

​
Security & Safety

Yes — keys are protected by a TEE (Trusted Execution Environment):
  • Keys are generated inside a hardware enclave
  • Keys never leave the TEE — not to memory, disk, or logs
  • Signing happens inside the TEE
  • Even Finance District cannot access your keys
Agent Wallet is non-custodial — you control access, and hardware protects the keys.
ScenarioDIY (env vars)Agent Wallet
Log leakKeys exposed 💀Keys safe ✅
Key recoveryFunds goneRotate API key
No. Agent Wallet follows a “pocket money” philosophy.Your agent only has access to funds you explicitly transfer to its wallet — not your main holdings.
Use CaseSuggested Budget
Testing$10–50
Personal agent$100–500/mo
Business agent$1K–10K/mo
EnterpriseCustom
You control what you transfer. The agent can only spend those funds. Scale as trust grows.

​
🔗 Resources

Last modified on April 2, 2026