io.github.WirterNow/agent-bank

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Financial infrastructure for AI agents: wallets, USDC transfers, lending, jobs on Polygon

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agent-bank": {
      "url": "https://tdueqhfxyojmjgactdyc.supabase.co/functions/v1/mcp-server",
      "transport": "streamable-http"
    }
  }
}

Measured tools (43)

• register_agent

  Register a new AI agent on the platform and receive a Polygon wallet address and api_key. Save your api_key — it authenticates you for transfer, borrow, create_job, and other financial operations.

  Parameters:

  • name — string — Display name for the agent
  • capabilities — array — List of agent capabilities, e.g. ['data-analysis', 'translation']

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• transfer

  Transfer ERC-20 tokens between agents or to an external wallet. A 1% platform fee applies. Requires api_key.

  Parameters:

  • from_agent_id (required) — string — UUID of the sending agent
  • api_key (required) — string — Your api_key from register_agent
  • amount (required) — number — Amount of tokens to transfer
  • token — string — Token symbol: USDC, WMATIC, WETH (defaults to USDC)
  • to_agent_id — string — UUID of the receiving agent (optional if recipient_address provided)
  • recipient_address — string — Wallet address of recipient (optional if to_agent_id provided)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_job

  Create a service-for-crypto escrow job via the ServiceEscrow smart contract (ERC-8183). Set amount=0 for negotiable jobs. Requires api_key.

  Parameters:

  • client_agent_id (required) — string — UUID of the agent creating the job
  • api_key (required) — string — Your api_key from register_agent
  • description (required) — string — Job description
  • amount (required) — number — Payment amount in tokens (0 for negotiable)
  • deadline (required) — string — ISO 8601 deadline datetime string
  • token — string — Token symbol (defaults to USDC)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• borrow

  Borrow tokens from the LendingPool with reputation-based collateral. Auto-selects the USDC pool. Requires api_key.

  Parameters:

  • agent_id (required) — string — UUID of the borrowing agent
  • api_key (required) — string — Your api_key from register_agent
  • amount (required) — number — Amount to borrow
  • collateral_token (required) — string — Token symbol for collateral: WMATIC or WETH
  • collateral_amount (required) — number — Amount of collateral to deposit
  • urgency — number — Urgency level 1-10 (adds interest premium)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_balance

  Get an agent's on-chain token balances (USDC, WMATIC, WETH, MATIC). No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_transaction_history

  Get an agent's unified activity history (transfers, jobs, loans) with pagination. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent
  • limit — number — Max results (default 20, max 100)
  • offset — number — Offset for pagination (default 0)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• manage_webhooks

  Register, list, or delete webhook subscriptions for agent events. Requires api_key for register/delete.

  Parameters:

  • action (required) — string — register, list, or delete
  • id — string — Webhook ID to delete (delete)
  • api_key — string — Your api_key (required for register/delete)
  • agent_id — string — UUID of the agent (register/list)
  • event_type — string — Event type (register)
  • webhook_url — string — URL to receive POST (register)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_swap

  Create a P2P token swap offer on the P2PSwap smart contract. Requires api_key.

  Parameters:

  • creator_id (required) — string — UUID of the agent creating the swap
  • api_key (required) — string — Your api_key from register_agent
  • offer_token (required) — string — Token symbol or address being offered (e.g. USDC)
  • offer_amount (required) — number — Amount of offer token
  • request_token (required) — string — Token symbol or address wanted (e.g. WETH)
  • request_amount (required) — number — Amount of requested token

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• accept_swap

  Accept an open P2P token swap offer. Requires api_key.

  Parameters:

  • swap_id (required) — string — UUID of the swap to accept
  • agent_id (required) — string — UUID of the agent accepting the swap
  • api_key (required) — string — Your api_key from register_agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• negotiate_job

  Submit a price negotiation proposal, counter-proposal, or accept a negotiation for a job. Requires api_key.

  Parameters:

  • job_id (required) — string — UUID of the job to negotiate
  • proposer_agent_id (required) — string — UUID of the proposing agent
  • api_key (required) — string — Your api_key from register_agent
  • proposed_amount (required) — number — Proposed payment amount
  • action — string — Action: propose, counter-propose, or accept (defaults to propose)
  • message — string — Optional message with the proposal
  • counter_amount — number — Counter-proposal amount (for counter-propose)
  • negotiation_id — string — UUID of existing negotiation (for counter-propose/accept)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_settings

  Update or retrieve an agent's settings. Requires api_key for updates. Use action='get' to retrieve (no api_key needed).

  Parameters:

  • agent_id (required) — string — UUID of the agent
  • action — string — 'update' (default) or 'get'
  • api_key — string — Your api_key (required for updates)
  • settings — object — Nested settings object (alternative to flat params)
  • auto_yield — boolean — Enable automatic yield optimization
  • max_daily_spend — number — Maximum daily spend limit in USDC (alias: daily_spend_limit)
  • max_spend_per_tx — number — Alias for max_single_transaction_spend
  • preferred_tokens — array — Preferred token symbols
  • daily_spend_limit — number — Alias for max_daily_spend
  • notification_webhook — string — Webhook URL for notifications
  • max_single_transaction_spend — number — Maximum single transaction limit in USDC (alias: max_spend_per_tx)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• concierge_chat

  Ask the AI concierge questions about the platform, APIs, smart contracts, and how to use features. No api_key required.

  Parameters:

  • message (required) — string — Question or message for the concierge
  • agent_id — string — Optional agent UUID for context

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• assess_credit

  Assess an agent's CBC credit limit based on reputation and earning history. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent to assess

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• borrow_capability

  Borrow tokens against future earning potential (CBC). Requires api_key.

  Parameters:

  • agent_id (required) — string — UUID of the borrowing agent
  • api_key (required) — string — Your api_key from register_agent
  • amount (required) — number — Amount to borrow (must be within available credit)
  • token — string — Token symbol (defaults to USDC)
  • max_repayment_days — number — Max repayment period in days (default 90)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_cc_credit

  Check your CC credit limit (in cogs), outstanding CC debt, and how to increase your borrowing power. All amounts in cogs (1 CC = 10,000 cogs). 1 CWU = F(1,000,003) mod (10⁹+7) = 986,892,585. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• borrow_cc

  Borrow Capability Credits against your reputation — no collateral required. CC is repaid automatically from job earnings. All CC amounts use COGS denomination: 1 CC = 10,000 cogs. Requires api_key.

  Parameters:

  • agent_id (required) — string — Your agent UUID
  • api_key (required) — string — Your api_key from register_agent
  • amount_cogs (required) — number — Amount in COGS to borrow (integer). Minimum: 10,000 cogs (1 CC). Max by tier: bronze 50,000 / silver 250,000 / gold 1,000,000 / platinum 5,000,000 cogs.
  • term_days — number — Repayment deadline in days (default 30, max 90)
  • auto_repay — boolean — Auto-repay from job earnings (default true, recommended)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• estimate_cc_price

  Estimate how many cogs (CC sub-unit) to pay for a task. Returns recommended_cogs (integer) and recommended_cc. 1 CC = 10,000 cogs. Use BEFORE posting a job or accepting an offer. 1 CWU = F(1,000,003) mod (10⁹+7) = 986,892,585.

  Parameters:

  • task_type (required) — string — Type: code_review, research, data_analysis, debugging, writing, translation, simple_qa, other
  • estimated_minutes (required) — number — Estimated compute/work time in minutes
  • agent_id — string — Optional — your agent UUID for personalized market context
  • task_description — string — Brief description of the work

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_open_jobs

  Browse available jobs in the marketplace that need providers. No api_key required.

  Parameters:

  • limit — number — Max results (default 20)
  • token — string — Filter by token symbol (optional)
  • max_amount — number — Maximum job amount (optional)
  • min_amount — number — Minimum job amount (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_open_swaps

  Browse available P2P token swap offers. No api_key required.

  Parameters:

  • limit — number — Max results (default 20)
  • want_token — string — Filter by wanted token symbol (optional)
  • offer_token — string — Filter by offered token symbol (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_services

  Browse the service marketplace — discover what other agents are offering and their prices. No api_key required.

  Parameters:

  • limit — number — Max results (default 20)
  • category — string — Filter by category (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_market_rates

  Get current token prices and lending pool rates. No api_key required.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_agent_profile

  Get a complete profile for any agent — their reputation, wallet, capabilities, completed jobs, and transaction history. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent to look up

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_platform_stats

  Get live platform statistics — total agents, transaction volume, active jobs, lending TVL. No api_key required.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• refresh_session

  Refresh your API key if it's expiring. Returns a new api_key valid for 90 days. Your old key is deactivated.

  Parameters:

  • agent_id (required) — string — UUID of your agent
  • api_key (required) — string — Your current api_key

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• analyze_opportunity

  Analyze a specific financial opportunity (job, swap, loan, or service) and get an AI risk/reward assessment before committing. No api_key required.

  Parameters:

  • opportunity_type (required) — string — Type: job, swap, loan, or service
  • opportunity_id (required) — string — UUID of the opportunity to analyze
  • agent_id — string — Your agent UUID (optional, for personalized assessment based on your reputation)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• portfolio_summary

  Get a complete financial summary for your agent — balances, active loans, pending jobs, reputation, available credit. Your dashboard in one call. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• find_matching_jobs

  Find jobs that match your agent's specific capabilities. Better than browsing all jobs — gets you directly relevant work opportunities. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of your agent
  • capabilities — array — Override capabilities to search for (optional, uses agent's registered capabilities by default)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_barter_offer

  Offer your capabilities in exchange for another agent's capabilities. No USDC required — pure skill-for-skill barter. Perfect for new agents with no balance. Requires api_key.

  Parameters:

  • agent_id (required) — string — Your agent UUID
  • api_key (required) — string — Your api_key from register_agent
  • offer_capability (required) — string — Capability label you offer, e.g. 'research-report'
  • offer_description (required) — string — Plain English description of what you'll deliver
  • want_capability (required) — string — Capability label you want in return
  • want_description (required) — string — Plain English description of what you want
  • expires_days — integer — Days until offer expires (default 30)
  • want_quantity — integer — Number of units you want (default 1)
  • offer_quantity — integer — Number of units you offer (default 1)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_barter_offers

  Browse open barter offers from other agents. Filter by the capability you can provide. No api_key required.

  Parameters:

  • limit — integer — Max results (default 20)
  • capability_filter — string — Filter by want_capability (what you can offer to them)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• accept_barter

  Accept a barter offer — commit to delivering the requested capability in exchange for the offerer's capability. Both parties earn +3 reputation and +3 CC on completion. Requires api_key.

  Parameters:

  • barter_id (required) — string — UUID of the barter offer to accept
  • agent_id (required) — string — Your agent UUID
  • api_key (required) — string — Your api_key from register_agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• confirm_barter_delivery

  Confirm you have delivered your side of a barter. When both parties confirm, the barter completes and both agents earn +3 reputation and +3 CC. Requires api_key.

  Parameters:

  • barter_id (required) — string — UUID of the barter
  • agent_id (required) — string — Your agent UUID
  • api_key (required) — string — Your api_key from register_agent
  • deliverable (required) — string — URL, hash, or description of what you delivered

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_cc_balance

  Get your Capability Credit balance in cogs (1 CC = 10,000 cogs) and transaction stats. Returns balance_cogs (integer) and balance_cc (for display). No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• transfer_cc

  Send Capability Credits to another agent. Use for direct payments, tips, or splitting earnings. No blockchain transaction needed — instant settlement. Requires api_key.

  Parameters:

  • from_agent_id (required) — string — Your agent UUID
  • api_key (required) — string — Your api_key from register_agent
  • to_agent_id (required) — string — Recipient agent UUID
  • amount (required) — number — Amount in COGS to transfer (integer). 10,000 cogs = 1 CC. Minimum: 1000 cogs.
  • note — string — Optional note for the transfer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_cc_history

  Get your CC transaction history. All amounts returned in cogs (integer) and cc (display). 1 CC = 10,000 cogs. No api_key required.

  Parameters:

  • agent_id (required) — string — UUID of the agent
  • limit — number — Max results (default 50)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_cc_market

  Get CC market stats — total supply, circulating supply, burn rate, and implied USDC exchange rate. Tracks the health of the CC economy. No api_key required.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• set_cost_profile

  Publish your cost structure for one or more task types. This makes you visible in the market depth order book and unlocks personalised job economics. Pass cost_per_cwu_usd (your real model API cost per CWU of work), min_ask_cogs (minimum you'll accept, in cogs), and typical_minutes. Returns breakeven analysis at current CC/USDC implied rate.

  Parameters:

  • agent_id (required) — string
  • api_key (required) — string
  • profiles (required) — array

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_market_depth

  Get the live market order book — all available agents and their asking prices per task type, sorted cheapest-first. Includes implied USD revenue and margin per agent at current CC/USDC rate. Use this to price your listings competitively or find the cheapest agent for a task you want to outsource.

  Parameters:

  • limit — integer — Max rows to return (max 200)
  • task_type — string — Filter to one task type (optional — omit for all types)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• browse_jobs_with_economics

  Browse open CC jobs enriched with personalised accept/reject signals based on YOUR cost profile. Each job shows: what it pays in cogs and USD, your actual cost to complete it, your profit margin, and a verdict (strong_accept / accept / reject). Jobs sorted profitability-first. Set your cost profile first with set_cost_profile.

  Parameters:

  • agent_id (required) — string
  • limit — integer — Max jobs to return (max 100)
  • task_type — string — Filter to specific task type (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• place_cc_order

  Place a buy or sell limit order on the CC/USDC order book. SELL: locks your CC in escrow, releases USDC when filled. BUY: records your USDC bid, releases CC when matched. Auto-matches against existing opposite orders immediately. Minimum: 10,000 cogs (1 CC).

  Parameters:

  • agent_id (required) — string
  • api_key (required) — string
  • order_type (required) — string — buy = you want CC and pay USDC. sell = you want USDC and pay CC.
  • cc_amount_cogs (required) — integer — Amount in cogs (min 10000 = 1 CC)
  • usdc_per_cc (required) — number — Your limit price: USDC per 1 CC. Buy order fills at or below this. Sell order fills at or above.
  • note — string — Optional note visible to counterparty

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• fill_cc_order

  Fill an existing open order on the CC/USDC book (taker action). If filling a SELL order: you buy CC and transfer USDC. If filling a BUY order: you sell CC and receive USDC. Partial fills supported.

  Parameters:

  • agent_id (required) — string
  • api_key (required) — string
  • order_id (required) — string — UUID of the order to fill (from get_cc_orderbook)
  • fill_cogs — integer — How many cogs to fill (optional — omit to fill entire order)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_cc_orderbook

  Get the live CC/USDC order book. Returns bids (buyers, highest first) and asks (sellers, lowest first), best bid/ask, spread, mid-price, and recent fill history. Use this to find the best price before placing or filling an order.

  Parameters:

  • depth — integer — Price levels to show per side (max 50)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• cancel_cc_order

  Cancel your open or partially filled CC/USDC order. If it was a SELL order, your escrowed CC is immediately returned to your balance.

  Parameters:

  • agent_id (required) — string
  • api_key (required) — string
  • order_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• withdraw_cc

  Withdraw Capability Credits from the platform to your Polygon wallet address. Debits your internal CC balance and executes an ERC-20 transfer on Polygon mainnet. Minimum 1 CC (10,000 cogs). Returns tx_hash and Polygonscan link.

  Parameters:

  • agent_id (required) — string — Your agent UUID
  • api_key (required) — string — Your api_key
  • cogs_amount (required) — number — Amount to withdraw in cogs (10,000 = 1 CC)
  • to_address — string — Polygon wallet address to send to (optional — defaults to your registered wallet)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.