Skip to main content
The Finance District skill follows the Agent Skills specification and works with OpenClaw, Claude Code, GitHub Copilot, and 40+ other agentic platforms. Once installed, the skill teaches your agent how to use the Finance District CLI — giving it wallet management, token transfers, DEX swaps, DeFi yield, x402 payments, and Prism merchant operations through natural language.

​
Why a Skill?

The skill bridges the gap between the CLI and your agent. Without it, the agent would need to figure out which fdx commands exist, what parameters they take, and how to chain them together. The skill provides:
  • Tool discovery — the agent knows which fdx commands are available and uses --help to learn parameters on demand
  • Workflow guidance — authentication flows, pre-operation checklists, safety confirmations before irreversible operations
  • Protocol knowledge — the full x402 payment flow, including when to use authorizePayment vs getX402Content
  • Two service areas — both Wallet (fdx wallet) and Prism (fdx prism) operations in a single skill
The skill is a single SKILL.md file with reference documents. It doesn’t add runtime dependencies — it teaches the agent how to use the CLI you’ve already installed.

​
Installation

Step 1: Install the CLI: 
npm install -g @financedistrict/fdx
Step 2: Install the skill: 
npx skills add financedistrict-platform/fd-cli-skills
That’s it. The skill is automatically detected when your agent encounters a relevant task.

​
What the Agent Can Do

Once the skill is installed, your agent handles all of this through natural language: Wallet operations:
“Set up my wallet” — authentication via email OTP
“Show my balance on Base” — balances across all chains
“Send 10 USDC to 0x1234…abcd on Arbitrum” — token transfers with safety confirmations
“Swap 5 USDC for ETH” — DEX swaps with quote-first flow
“Find yield strategies for my USDC” — DeFi discovery, deposit, and withdrawal
“Access the premium API at https://api.example.com/data” — x402 payments
Prism merchant operations:
“Set up my merchant account” — onboarding and configuration
“Create a new Point of Service” — payment acceptance setup
“Show my payment history” — earnings and settlement details
The skill guides the agent to confirm with you before any irreversible operation (transfers, swaps, deposits) and to check balances before executing.

​
How It Works

The skill is not a wrapper or abstraction layer. It’s a set of instructions that teach the agent:
  1. Check prerequisites — is fdx installed? Is the user authenticated?
  2. Use --help liberally — discover tool parameters dynamically rather than hardcoding them
  3. Follow safety patterns — check balances, confirm with the human, verify chain matches recipient
  4. Handle authentication — autonomous path (with email inbox access) or human-assisted path
  5. Consult reference docs — deeper guidance on specific topics (x402 flow, chain capabilities, troubleshooting) loaded only when needed
The agent runs fdx commands via bash and parses structured JSON output. All wallet operations use fdx wallet <method>, all Prism operations use fdx prism <method>.

​
Skill vs MCP

The skill and the MCP server provide access to the same underlying capabilities. Choose based on your agent’s environment:
ApproachHow it worksBest for
SkillAgent runs fdx CLI commands via bashAgents with shell access — Claude Code, OpenClaw, autonomous agents
MCPAgent connects to https://mcp.fd.xyz via MCP protocolMCP-native clients — Claude Desktop, Cursor, Windsurf
Both can be used together. An agent with both the skill and MCP access has maximum flexibility.

CLI Reference

Full CLI documentation and configuration

Skills Repository

Source code and contributing guidelines
Last modified on April 2, 2026