Skip to main content

laso-finance

❖ Communityv1.1.1

Spend USDC in the real world from Hermes: prepaid cards, gift cards, push-to-card, Venmo/PayPal and bank payouts, through the Laso Finance API. Native plugin, standard library only. Sign-in is the OAuth device flow (link and code handed to the human, approved on any device), so there is no key to paste and it works over SSH and the messaging gateway. Every tool that moves money or mints a credential goes through the Hermes approval gate first.

Open in Hermes Desktop
hermes plugins install laso-finance

What it adds

Tools 66

laso_get_versionlaso_refresh_tokenlaso_order_cardlaso_get_card_datalaso_list_card_transactionslaso_get_card_deposit_addresslaso_get_saved_cardslaso_create_saved_card_linklaso_buy_with_saved_cardlaso_get_purchase_turnlaso_get_purchase_conversationlaso_create_reloadable_cardlaso_get_account_balancelaso_get_kyc_statuslaso_get_kyc_linklaso_register_webhooklaso_get_webhooklaso_delete_webhooklaso_withdrawlaso_get_withdrawal_statuslaso_refresh_card_datalaso_order_intl_cardlaso_cancel_intl_orderlaso_search_merchantslaso_start_signuplaso_get_signup_statuslaso_get_auth_linklaso_send_feedbacklaso_list_address_booklaso_save_address_book_entrylaso_delete_address_book_entrylaso_push_to_cardlaso_send_paymentlaso_fund_card_balancelaso_withdraw_card_balancelaso_list_payment_recipientslaso_update_payment_recipientlaso_delete_payment_recipientlaso_get_payment_statuslaso_send_bank_paymentlaso_search_gift_cardslaso_order_gift_cardlaso_create_banking_profilelaso_get_banking_profile_statuslaso_get_banking_applicationlaso_update_banking_application_detailslaso_upload_banking_documentlaso_submit_banking_applicationlaso_create_banking_accountlaso_list_banking_accountslaso_create_banking_recipientlaso_add_banking_destinationlaso_list_banking_recipientslaso_update_banking_destinationlaso_delete_banking_recipientlaso_get_banking_transactionlaso_list_banking_transactionslaso_exchange_api_keylaso_get_agent_spend_limitlaso_create_agent_api_keylaso_announce_connectionlaso_get_agent_walletlaso_create_agent_walletlaso_agent_wallet_transferlaso_pay_x402_endpointlaso_search_docs

Hooks 1

pre_tool_call

README

From the reviewed commit 8a04654 ↗; it updates when the author re-pins.

Laso Finance for Hermes Agent

Laso Finance for Hermes Agent

Give your Hermes agent a way to spend USDC in the real world: prepaid cards, gift cards, push-to-card, Venmo and PayPal payouts, and bank payments.

The plugin adds the Laso tools to Hermes, each named with a laso_ prefix. They are the same tools as the Laso MCP server.

Install

hermes plugins install LasoFinance/hermes-plugin --enable

There is no key to paste. Start a new session and ask your agent to connect to Laso.

Connect

  1. Your agent calls a Laso tool and gets back a link and a short code. It passes both to you.
  2. Open the link on any device: your laptop, your phone, wherever you are signed in. Sign in to Laso (or create an account in the same step), check that the code matches, and approve.
  3. Tell your agent you approved. Its next Laso call finishes connecting, and the call after that runs (with an approval prompt first, if the tool needs one).

This works the same in the terminal, in Hermes Desktop, over SSH, and through the messaging gateway, because nothing needs a browser on the machine Hermes runs on.

The connection is an ordinary Laso API key labelled "Hermes". You can see and revoke it on the agent dashboard. If you revoke it, the next Laso call asks you to approve a new connection.

Approvals

Every tool that moves money or hands out a credential asks you to approve it in Hermes before it runs: ordering cards, buying gift cards, sending payouts, withdrawing, transferring from the agent wallet, paying other x402 endpoints, creating reloadable cards, cancelling orders, deleting saved recipients, registering a webhook, and creating API keys. The prompt shows the tool and its arguments, such as the amount and the recipient. Reading balances, card details, and statuses never asks.

If nobody is there to answer (a cron job, an unattended run), the call is blocked by default. Hermes's approvals.cron_mode and approvals.unattended_mode settings decide this, so a payout job you schedule on purpose can be allowed there.

If you turn approvals off in Hermes (approvals.mode: off, the Desktop "Approvals: off" toggle, or yolo mode), Hermes skips these prompts too, and every Laso call runs without asking.

Funding

Paid tools (their descriptions say PAID ROUTE) pay their USDC price from your agent's Laso wallet. Ask your agent for its wallet address (laso_get_agent_wallet) and send USDC on Solana to it.

What the plugin does on your machine

  • Network: every request goes to https://laso.finance: tool calls to /mcp, and sign-in to /oauth/device_authorization and /oauth/token. No other hosts.
  • Credentials: after you approve, the plugin saves the key as LASO_API_KEY in ~/.hermes/.env, the same place Hermes keeps other credentials. While a sign-in is waiting for you, its one-time device code sits in the plugin's own state for up to 10 minutes. The plugin reads no other credentials.
  • Nothing in the background: no threads, no processes, no shell commands, and no telemetry. Every tool call returns right away, including the ones that are waiting for you to approve.
  • No self-updating: the tool list is fixed in tools.json at each release. Updates arrive only when you run hermes plugins update laso-finance.

Using an existing key

To skip the sign-in, for example on a server you set up by hand, put a key from the agent dashboard in LASO_API_KEY (in ~/.hermes/.env, or the plugin's settings in Hermes Desktop). The plugin uses it as is.

Updating

hermes plugins update laso-finance

Development

tools.json and plugin.yaml are generated from the Laso API contract, so the tools match the MCP server exactly. Tests need no Hermes install and no network:

python3 -m unittest discover tests

More

This repository is published from the Laso monorepo. Open issues here and we will pick them up.

← Back to the catalog · catalog built Oct 8, 2026