Skip to main content

Agent Skills

Agent Skills are a standardized way to describe what an AI agent or service can do. Instead of hardcoding tool configurations, agents and platforms can discover capabilities dynamically — finding and using wallet operations on the fly. Finance District publishes Agent Wallet skills following the Agent Skills specification. These skills enable AI agents to authenticate, manage wallets, send tokens, swap via DEXs, earn DeFi yield, and more using the FDX CLI.

Available Skills

SkillDescription
authenticateSign in to the wallet via OAuth 2.1 (browser or device flow)
wallet-overviewCheck balances, holdings, and transaction history across all chains
send-tokensTransfer tokens to any address on any EVM chain or Solana
swap-tokensSwap tokens via decentralized exchanges on any supported chain
fund-walletAdd funds via web onramp or direct transfer to wallet address
yield-strategiesDiscover, deposit into, and withdraw from DeFi yield strategies
smart-accountsDeploy and manage multi-signature smart accounts
pay-for-serviceAccess paid API endpoints via the x402 payment protocol
help-and-supportGet help, onboarding guidance, and report issues

Installation

Prerequisites

Install the FDX CLI globally:
npm install -g @financedistrict/fdx
Once installed, the fdx command is available directly — no npx needed.

Install Skills

Install all Agent Wallet skills with Vercel’s Skills CLI:
npx skills add financedistrict-platform/fd-agent-wallet-skills
This downloads all skills from the repository and makes them available to your agent. Skills are automatically detected when relevant tasks are given to the agent.
You can also install individual skills by specifying the skill name: bash npx skills add financedistrict-platform/fd-agent-wallet-skills/wallet-overview npx skills add financedistrict-platform/fd-agent-wallet-skills/send-tokens npx skills add financedistrict-platform/fd-agent-wallet-skills/swap-tokens

Usage

Skills are automatically available once installed. The agent will use them when relevant tasks are detected. Try these prompts:
“Sign in to my wallet”
“Show my balance on Ethereum”
“Send 10 USDC to 0x1234…abcd on Base”
“Swap 5 USDC for ETH on Arbitrum”
“Find yield strategies for my USDC”
“Pay for the API at https://api.example.com/data
“Deploy a new smart account on Base”

Key Differentiators

What sets Agent Wallet skills apart from other crypto agent integrations:
  • Multi-chain — Supports all EVM chains and Solana. Not locked to a single chain.
  • DEX swaps — Token swaps execute through decentralized exchanges, not centralized order books.
  • DeFi yield — Discover and invest in yield strategies across protocols like Aave, Compound, and more.
  • Smart accounts — Deploy and manage multi-sig wallets on-chain (ERC-4337).
  • Multi-asset x402 — Pay for services with any supported asset on any chain.

Discovery via MCP

In addition to the Skills CLI, agents can discover wallet capabilities through MCP directly. When an MCP client connects to https://mcp.fd.xyz, it automatically discovers all available tools through MCP’s standard listTools() method:
const { tools } = await client.listTools();
// Returns all available wallet operations with schemas
This is the primary discovery path for MCP-native clients — your agent connects and immediately knows what it can do. The Agent Skills approach is complementary, serving agents and platforms that use the Agent Skills specification rather than MCP.

Building Composable Agents

Agent Skills enable composability — combining wallet capabilities with other agent skills to create complex workflows: Example: E-commerce agent
  • Discovers wallet skills (payment capability)
  • Discovers product search skills (finding items)
  • Discovers shipping skills (logistics)
  • Composes them into an end-to-end purchasing workflow
Example: Research agent
  • Discovers wallet skills (payment for premium APIs)
  • Discovers data analysis skills (processing)
  • Automatically pays for data sources via x402 as part of research tasks
The agent doesn’t need to know about Agent Wallet in advance — it discovers payment capability when it needs it and integrates it into its workflow.

Contributing

To add a new skill to the repository:
  1. Create a folder in ./skills/ with a lowercase, hyphenated name
  2. Add a SKILL.md file with YAML frontmatter and instructions
  3. Follow the Agent Skills specification for the complete format
See the skills repository for the full source.