finance-district-mcp

Operates a non-custodial multichain agent wallet for balances, swaps, DeFi yields, and x402 payments.

714|255|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/aaronjmars/aeon --skill finance-district-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finance-district-mcp
Source: https://github.com/aaronjmars/aeon/tree/main/skills/finance-district-mcp
Command: npx skills add https://github.com/aaronjmars/aeon --skill finance-district-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing crypto assets across EVM, Solana, Bitcoin, and Sui chains requires juggling multiple wallets and interfaces, while giving an AI agent direct key access creates unacceptable custody risk. This Skill lets an agent operate a Finance District Agent Wallet where private keys stay inside a secure enclave (TEE) and spend caps are enforced server-side.

Core Features & Use Cases

  • Multichain balance and price monitoring: Read wallet identity and per-chain balances, track token prices, and flag 24h moves over ±5% or unexplained balance changes.
  • DeFi yield discovery: Surface top stablecoin yield strategies (protocol, APY, TVL) on EVM chains without depositing unless explicitly instructed.
  • Value-moving actions under caps: Execute transfers, swaps, yield deposits, and x402 paid API calls (gasless via EIP-3009) only on explicit instruction, with per-transfer limits and a destination denylist enforced by the wallet server.
  • Use Case: Run a daily wallet brief that reports balances, notable price moves, and the best USDC yield on Base, or instruct it to swap 5 USDC to ETH on Base with every spent amount recorded in the operator notification.

Quick Start

Connect Finance District from the dashboard MCP panel, then ask the agent to give me a daily wallet brief with balances, notable price moves, and the top stablecoin yield.

Frequently Asked Questions about finance-district-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect the Finance District wallet to an AI agent?

Connect Finance District through the dashboard MCP panel's one-click OAuth Connect, which grants offline_access tokens stored as MCP_FINANCE_DISTRICT_TOKEN. The agent then discovers mcp__finance-district__* tools from the server each run.

How does a non-custodial agent wallet keep private keys safe?

Private keys never leave a secure enclave (TEE); the agent only submits structured intent and the wallet server signs within limits. Per-transfer caps, an auto-approve threshold, and a destination denylist are enforced server-side, so the agent cannot raise its own limits.

Which blockchains does the Finance District agent wallet support?

It supports holding and transfers across EVM, Solana, Bitcoin, and Sui, swaps on EVM and Solana, and DeFi yield strategies on EVM only. x402 payments use the EIP-3009 stablecoin and chain the endpoint accepts, such as USDC or FDUSD.

Why does the wallet connection fail with a 401 or invalid token error?

A 401 means the OAuth refresh failed because Finance District rotates its refresh token and the rotation was not persisted. Set GH_SECRETS_PAT so rotations persist, then re-connect from the dashboard MCP panel.

Can the agent move funds without explicit instructions?

No. Transfers, swaps, yield deposits, and x402 payments execute only on explicit instruction, one task per run, with irreversible actions sequenced last. Amounts above the auto-approve threshold are rejected by the wallet and reported, never worked around.